Skip to main content
GET
/
v2
/
polymarket
/
candlesticks
/
{condition_id}
Get Candlesticks
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/candlesticks/{condition_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
}

Documentation Index

Fetch the complete documentation index at: https://docs.predexon.com/llms.txt

Use this file to discover all available pages before exploring further.

Fetch OHLCV candlestick data for charting. Prices normalized to YES side (NO prices converted as 1 - price).
Free & Unlimited. This endpoint does not count toward your monthly usage limits on any plan.

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 in the market, useful for determining the full available data range. 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

condition_id
string
required

Condition ID for the market

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