GET /v1/stats/:token_id

Comprehensive market statistics including current prices, orderbook depth, and 24-hour OHLCV data computed from hourly candles.

Path Parameters

Parameter	Type	Description
`token_id`	string	Polymarket CLOB token identifier

Request

curl -s https://polynode.dev/v1/stats/21742633... \
  -H "x-api-key: pn_live_YOUR_KEY"

Response

{
  "token_id": "21742633...",
  "question": "Will Bitcoin hit $100K in 2026?",
  "slug": "bitcoin-100k-2026",
  "outcomes": ["Yes", "No"],
  "category": "Crypto",
  "price": {
    "last": 0.72,
    "mid": 0.72,
    "best_bid": 0.71,
    "best_ask": 0.73
  },
  "volume_24h": 48293.50,
  "trade_count_24h": 342,
  "last_trade_at": 1709136045000,
  "orderbook": {
    "spread": 0.02,
    "bid_depth": 45230.00,
    "ask_depth": 38120.00,
    "bid_levels": 15,
    "ask_levels": 12,
    "updated_at": 1709136050000
  },
  "ohlcv_24h": {
    "open": 0.68,
    "high": 0.74,
    "low": 0.67,
    "close": 0.72,
    "volume": 48293.50,
    "candle_count": 24
  },
  "liquidity": 125430.50,
  "volume": 892341.25
}

Response Fields

Field	Type	Description
`price.last`	number \| null	Last settlement price
`price.mid`	number	Orderbook mid price
`price.best_bid`	number	Best bid
`price.best_ask`	number	Best ask
`orderbook`	object	Orderbook depth summary (present if subscribed)
`ohlcv_24h`	object	24-hour OHLCV (present if candle data exists)
`ohlcv_24h.open`	number	Opening price 24h ago
`ohlcv_24h.high`	number	24h high
`ohlcv_24h.low`	number	24h low
`ohlcv_24h.close`	number	Current close
`ohlcv_24h.volume`	number	Total 24h volume from candles
`ohlcv_24h.candle_count`	integer	Number of hourly candles in the period
`liquidity`	number	Total market liquidity
`volume`	number	All-time volume

Errors

Status	Description
404	Market not found