GET /v1/search

Search across 35K+ market questions. Sub-millisecond response times.

Parameters

Parameter	Type	Default	Description
`q`	string	required	Search query (case-insensitive substring match)
`limit`	integer	20	Max results. Max 100.

Request

curl -s "https://polynode.dev/v1/search?q=bitcoin&limit=5" \
  -H "x-api-key: pn_live_YOUR_KEY"

Response

{
  "query": "bitcoin",
  "count": 5,
  "total": 5,
  "results": [
    {
      "condition_id": "0xabc123...",
      "question": "Will Bitcoin hit $100K in 2026?",
      "slug": "bitcoin-100k-2026",
      "outcomes": ["Yes", "No"],
      "end_date": "2026-12-31T23:59:59Z",
      "category": "Crypto",
      "market_type": "binary",
      "active": true,
      "token_ids": ["21742633...", "98765432..."],
      "image": "https://polymarket.com/images/bitcoin.png",
      "last_price": 0.72,
      "volume_24h": 48293.50,
      "mid_price": 0.72
    }
  ]
}

Response Fields

Field	Type	Description
`query`	string	The search query
`count`	integer	Number of results returned
`results[].condition_id`	string	CTF condition identifier
`results[].question`	string	Market question text
`results[].slug`	string	URL slug
`results[].outcomes`	string[]	Outcome labels
`results[].token_ids`	string[]	All token IDs for this market
`results[].active`	boolean	Whether the market is active
`results[].last_price`	number \| null	Last settlement price
`results[].volume_24h`	number	24h volume (from first token)
`results[].mid_price`	number	Orderbook mid price (if available)

Errors

Status	Description
400	Missing required `q` parameter