GET /v1/markets/:token_id

Returns detailed data for a single market by its CLOB token ID, including orderbook summary and full metadata.

Path Parameters

Parameter	Type	Description
`token_id`	string	Polymarket CLOB token identifier

Request

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

Response

{
  "token_id": "21742633143463906290569404...",
  "question": "Will Bitcoin hit $100K in 2026?",
  "slug": "bitcoin-100k-2026",
  "outcomes": ["Yes", "No"],
  "condition_id": "0xabc123...",
  "end_date": "2026-12-31T23:59:59Z",
  "category": "Crypto",
  "market_type": "binary",
  "image": "https://polymarket.com/images/bitcoin.png",
  "icon": "https://polymarket.com/icons/crypto.png",
  "neg_risk": false,
  "created_at": "2026-01-15T10:30:00Z",
  "description": "This market resolves to Yes if...",
  "liquidity": 125430.50,
  "volume": 892341.25,
  "last_price": 0.72,
  "volume_24h": 48293.50,
  "trade_count_24h": 342,
  "last_trade_at": 1709136045000,
  "last_status": "Confirmed",
  "best_bid": 0.71,
  "best_ask": 0.73,
  "spread": 0.02,
  "mid_price": 0.72,
  "bid_depth": 45230.00,
  "ask_depth": 38120.00,
  "orderbook_updated_at": 1709136050000
}

Response Fields

All fields from GET /v1/markets plus:

Field	Type	Description
`last_status`	string \| null	”Pending” or “Confirmed” (null if no trades)
`best_bid`	number	Highest bid price
`best_ask`	number	Lowest ask price
`spread`	number	Bid-ask spread
`mid_price`	number	Midpoint price
`bid_depth`	number	Total bid depth in USD
`ask_depth`	number	Total ask depth in USD
`orderbook_updated_at`	integer	Last orderbook update (Unix ms)
`description`	string	Full market description
`liquidity`	number	Total market liquidity
`volume`	number	All-time trading volume

Errors

Status	Description
404	Market not found