Market & Trade Data

Polymarket Orderbook

Order book snapshots for a Polymarket token. Check liquidity depth and spread on sport markets before placing trades.

POST/v2/semantic/retrieve/parameterized

Query Parameters

token_idstring

Token ID of the market outcome. Required.

Example:

"69435545313357346912686520645149775930858973121193492847015767460308803044235"

start_timestring

Unix timestamp (milliseconds) for range start

Example:

"1769902905868"

end_timestring

Unix timestamp (milliseconds) for range end

Example:

"1770034843377"

Response Fields

Field	Type	Description
`token_id`	String	Token ID
`timestamp`	String (ISO 8601)	Snapshot time
`best_bid`	String (Decimal)	Highest bid price
`best_ask`	String (Decimal)	Lowest ask price
`spread`	String (Decimal)	Bid-ask spread
`bid_depth`	String (Decimal)	Total bid side liquidity (USD)
`ask_depth`	String (Decimal)	Total ask side liquidity (USD)

Tips for Best Results

•Wide spreads indicate illiquid markets — beware of slippage
•Compare bid/ask depth to assess which side has more support
•Track spread over time to detect liquidity drying up before game start

Polymarket Orderbook

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": 572,
  "params": {
    "token_id": "69435545313357346912686520645149775930858973121193492847015767460308803044235",
    "start_time": "1769902905868",
    "end_time": "1770034843377"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
}'

200Example response

{
  "timestamp": "",
  "params": {
    "token_id": "69435545313357346912686520645149775930858973121193492847015767460308803044235",
    "start_time": "1769902905868",
    "end_time": "1770034843377"
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  },
  "data": {
    "results": [
      {
        "token_id": "69435545313357346912686520645149775930858973121193492847015767460308803044235",
        "timestamp": "2026-04-10T18:00:00Z",
        "best_bid": "0.5750",
        "best_ask": "0.5850",
        "spread": "0.0100",
        "bid_depth": "125400.30",
        "ask_depth": "98200.15"
      }
    ]
  }
}