GET /v1/markets

Returns the top markets sorted by 24h trading volume, enriched with metadata.

Parameters

Parameter	Type	Default	Description
`count`	integer	100	Number of markets to return. Max 1000.

Request

curl -s https://polynode.dev/v1/markets?count=3 \
  -H "x-api-key: pn_live_YOUR_KEY"

Response

{
  "count": 3,
  "total": 69482,
  "markets": [
    {
      "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",
      "last_price": 0.72,
      "volume_24h": 48293.50,
      "trade_count_24h": 342,
      "last_trade_at": 1709136045000
    }
  ]
}

Response Fields

Field	Type	Description
`count`	integer	Number of markets returned
`total`	integer	Total markets tracked by the system
`markets[].token_id`	string	Polymarket CLOB token identifier
`markets[].question`	string	Market question text
`markets[].slug`	string	URL-friendly slug
`markets[].outcomes`	string[]	Possible outcomes (e.g. [“Yes”, “No”])
`markets[].condition_id`	string	CTF condition identifier
`markets[].last_price`	number \| null	Last settlement price (null if no trades)
`markets[].volume_24h`	number	24-hour trading volume in USD
`markets[].trade_count_24h`	integer	Number of trades in last 24 hours
`markets[].last_trade_at`	integer \| null	Unix timestamp (ms) of last trade
`markets[].category`	string	Market category
`markets[].end_date`	string	Market expiry date (ISO 8601)
`markets[].neg_risk`	boolean	Whether the market uses neg-risk framework