Skip to main content
GET
/
v2
/
polymarket
/
candlesticks
/
token
/
{token_id}
Get Candlesticks By Token
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/candlesticks/token/{token_id} \
  --header 'x-api-key: <api-key>'
{
  "interval": 123,
  "interval_seconds": 123,
  "candlesticks": [
    {
      "end_period_ts": 123,
      "price": {
        "open": 123,
        "high": 123,
        "low": 123,
        "close": 123,
        "open_dollars": "<string>",
        "high_dollars": "<string>",
        "low_dollars": "<string>",
        "close_dollars": "<string>",
        "mean": 123,
        "mean_dollars": "<string>",
        "previous": 123,
        "previous_dollars": "<string>"
      },
      "volume": 123,
      "trades_count": 123
    }
  ],
  "condition_id": "<string>",
  "token_id": "<string>",
  "first_trade_ts": 123,
  "last_trade_ts": 123
}
Fetch OHLCV candlestick data for one specific outcome token. Unlike the condition-level candlesticks endpoint, prices are not normalized — NO-token prices stay as NO prices (e.g. ~$0.30 in a 70/30 market). Volume is only from trades of this token; summing the YES and NO token volumes over the same window approximates the condition-level volume.
Free & Unlimited. This endpoint does not count toward your monthly usage limits on any plan.
Use this when you need to chart each side of a binary market separately, or when working with a specific token ID rather than a condition ID.

​
Intervals

IntervalValueMax Range
Auto0 (default)Picks the best interval based on your time range
1 minute17 days
5 minutes514 days
15 minutes1530 days
1 hour6090 days
1 day1440Unlimited (all-time)
The response includes first_trade_ts and last_trade_ts — the Unix timestamps of the first and last trades for this token. It also echoes back the resolved interval (in minutes) and interval_seconds (bucket width), so you know which bucket size was picked when requesting interval=0.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
token_id
string
required

Outcome token ID

Query Parameters

​
start_time
integer | null

Unix timestamp (seconds) for start of time range

Required range: x >= 0
​
end_time
integer | null

Unix timestamp (seconds) for end of time range

Required range: x >= 0
​
interval
integer
default:0

Interval: 0=auto, 1=1m, 5=5m, 15=15m, 60=1h, 1440=1d

Response

Successful Response

Candlesticks endpoint response.

​
interval
integer
required

Resolved candle interval in minutes (1, 5, 15, 60, or 1440). Reflects the auto-selected value when interval=0 is requested.

​
interval_seconds
integer
required

Resolved candle interval in seconds — the bucket width of each candlestick

​
candlesticks
CandlestickData · object[]
required

Array of candlestick data points

​
condition_id
string | null

Market condition ID (set for condition-level candles)

​
token_id
string | null

Outcome token ID (set for token-level candles)

​
first_trade_ts
integer | null

Unix timestamp of the first trade

​
last_trade_ts
integer | null

Unix timestamp of the last trade