GET /v1/candles/:token_id

Returns OHLCV (Open, High, Low, Close, Volume) price candles for a market token. Built from live settlement data.

Path Parameters

Parameter	Type	Description
`token_id`	string	Polymarket CLOB token identifier

Query Parameters

Parameter	Type	Default	Description
`resolution`	string	`"1h"`	Candle resolution: `1m`, `5m`, `15m`, `1h`, `4h`, `1d`
`limit`	integer	100	Max candles to return. Max 1000.

Request

curl -s "https://polynode.dev/v1/candles/21742633...?resolution=1h&limit=24" \
  -H "x-api-key: pn_live_YOUR_KEY"

Response

{
  "token_id": "21742633...",
  "question": "Will Bitcoin hit $100K in 2026?",
  "slug": "bitcoin-100k-2026",
  "resolution": "1h",
  "count": 24,
  "candles": [
    {
      "timestamp": 1709136000,
      "open": 0.68,
      "high": 0.71,
      "low": 0.67,
      "close": 0.70,
      "volume": 2150.00,
      "trade_count": 18
    },
    {
      "timestamp": 1709139600,
      "open": 0.70,
      "high": 0.74,
      "low": 0.69,
      "close": 0.72,
      "volume": 3420.00,
      "trade_count": 24
    }
  ]
}

Response Fields

Field	Type	Description
`resolution`	string	The candle resolution
`count`	integer	Number of candles returned
`candles[].timestamp`	integer	Candle open time (Unix seconds)
`candles[].open`	number	Opening price
`candles[].high`	number	Highest price
`candles[].low`	number	Lowest price
`candles[].close`	number	Closing price
`candles[].volume`	number	Total volume in USD
`candles[].trade_count`	integer	Number of trades in the candle

Resolutions

Resolution	Description
`1m`	1 minute
`5m`	5 minutes
`15m`	15 minutes
`1h`	1 hour (default)
`4h`	4 hours
`1d`	1 day

Errors

Status	Description
400	Invalid resolution value