Skip to main content
GET
/
v1
/
polymarket
/
candlesticks
/
{condition_id}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/candlesticks/0x1234...?interval=60&start_time=1704067200&end_time=1704153600"

{
  "candlesticks": [
    [
      [
        {
          "end_period_ts": 1704070800,
          "price": {
            "open": 0.5500,
            "high": 0.5650,
            "low": 0.5480,
            "close": 0.5620,
            "open_dollars": "0.5500",
            "high_dollars": "0.5650",
            "low_dollars": "0.5480",
            "close_dollars": "0.5620",
            "mean": 0.5560,
            "mean_dollars": "0.5560",
            "previous": 0.5480,
            "previous_dollars": "0.5480"
          },
          "volume": 125000.50,
          "trades_count": 847
        },
        {
          "end_period_ts": 1704074400,
          "price": {
            "open": 0.5620,
            "high": 0.5700,
            "low": 0.5590,
            "close": 0.5680,
            "open_dollars": "0.5620",
            "high_dollars": "0.5700",
            "low_dollars": "0.5590",
            "close_dollars": "0.5680",
            "mean": 0.5640,
            "mean_dollars": "0.5640",
            "previous": 0.5620,
            "previous_dollars": "0.5620"
          },
          "volume": 98500.25,
          "trades_count": 623
        }
      ],
      {
        "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455"
      }
    ]
  ]
}

​
Overview

Fetch historical candlestick (OHLCV) data for charting and analysis. Data is normalized to the YES side perspective - NO prices are converted as (1 - price).
​
condition_id
string
required
The condition ID for the market
​
start_time
integer
Unix timestamp (seconds) for start of time range. Defaults to earliest available data.
​
end_time
integer
Unix timestamp (seconds) for end of time range. Defaults to latest available data.
​
interval
integer
default:"1"
Candlestick interval in minutes:
  • 1 - 1 minute (max 1 week range)
  • 60 - 1 hour (max 1 month range)
  • 1440 - 1 day (max 1 year range)
​
candlesticks
array
Array of candlestick data with token metadata
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/candlesticks/0x1234...?interval=60&start_time=1704067200&end_time=1704153600"

{
  "candlesticks": [
    [
      [
        {
          "end_period_ts": 1704070800,
          "price": {
            "open": 0.5500,
            "high": 0.5650,
            "low": 0.5480,
            "close": 0.5620,
            "open_dollars": "0.5500",
            "high_dollars": "0.5650",
            "low_dollars": "0.5480",
            "close_dollars": "0.5620",
            "mean": 0.5560,
            "mean_dollars": "0.5560",
            "previous": 0.5480,
            "previous_dollars": "0.5480"
          },
          "volume": 125000.50,
          "trades_count": 847
        },
        {
          "end_period_ts": 1704074400,
          "price": {
            "open": 0.5620,
            "high": 0.5700,
            "low": 0.5590,
            "close": 0.5680,
            "open_dollars": "0.5620",
            "high_dollars": "0.5700",
            "low_dollars": "0.5590",
            "close_dollars": "0.5680",
            "mean": 0.5640,
            "mean_dollars": "0.5640",
            "previous": 0.5620,
            "previous_dollars": "0.5620"
          },
          "volume": 98500.25,
          "trades_count": 623
        }
      ],
      {
        "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455"
      }
    ]
  ]
}

​
Usage Notes

To ensure reasonable response sizes, each interval has a maximum time range:
  • 1-minute: 1 week
  • 1-hour: 1 month
  • 1-day: 1 year
All prices are normalized to the YES perspective. This means if you’re tracking the NO side, the displayed prices show (1 - actual_no_price).
Volume is the combined USD notional from both YES and NO token trades within each period.

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

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

​
end_time
integer | null

Unix timestamp (seconds) for end of time range

​
interval
integer
default:1

Interval: 1=1m, 60=1h, 1440=1d

Response

Successful Response

Candlesticks endpoint response.

​
candlesticks
any[][]
required

Array of [candlestick_data_array, token_metadata] tuples