Market & Trade Data

Polymarket Candlesticks

OHLCV candlestick data for a Polymarket token. Use to track price movement and volume patterns on sport markets over time.

POST/v2/semantic/retrieve/parameterized

Query Parameters

token_idstring

Token ID of the market outcome. Required.

Example:

"85953619064670985626771564660881103494957821937504170459975285010511861618293"

intervalstring

Candle interval: 1m, 5m, 1h, or 1d

Example:

"1h"

start_timestring

Unix timestamp (seconds) for range start

Example:

"1769910300"

end_timestring

Unix timestamp (seconds) for range end

Example:

"1770034843377"

Response Fields

Field	Type	Description
`token_id`	String	Token ID
`timestamp`	String (ISO 8601)	Candle start time
`open`	String (Decimal)	Opening price
`high`	String (Decimal)	Highest price
`low`	String (Decimal)	Lowest price
`close`	String (Decimal)	Closing price
`volume`	String (Decimal)	Volume during candle (USD)

Tips for Best Results

•Use 1m or 5m intervals for intraday / pre-game analysis
•Use 1h or 1d for multi-day trends
•Pair with Price Jumps to zoom into specific anomalies on the chart

Polymarket Candlesticks

curl --request POST \
  --url https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": 568,
  "params": {
    "token_id": "85953619064670985626771564660881103494957821937504170459975285010511861618293",
    "interval": "1h",
    "start_time": "1769910300",
    "end_time": "1770034843377"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
}'

200Example response

{
  "timestamp": "",
  "params": {
    "token_id": "85953619064670985626771564660881103494957821937504170459975285010511861618293",
    "interval": "1h",
    "start_time": "1769910300",
    "end_time": "1770034843377"
  },
  "data": {
    "results": [
      {
        "token_id": "85953619064670985626771564660881103494957821937504170459975285010511861618293",
        "timestamp": "2026-04-10T18:00:00Z",
        "open": "0.5600",
        "high": "0.5850",
        "low": "0.5520",
        "close": "0.5800",
        "volume": "42310.55"
      },
      {
        "token_id": "85953619064670985626771564660881103494957821937504170459975285010511861618293",
        "timestamp": "2026-04-10T17:00:00Z",
        "open": "0.5450",
        "high": "0.5620",
        "low": "0.5400",
        "close": "0.5600",
        "volume": "31880.20"
      }
    ]
  }
}