Skip to main content

​
Markets

Discover and browse Polymarket prediction markets with live pricing data.

​
List Markets

GET /v1/markets
Returns markets with attached live prices from Polymarket’s CLOB.

​
Query Parameters

ParameterTypeDefaultDescription
limitint50Max results (1–500)
offsetint0Pagination offset
hot_onlyboolfalseOnly high-volume markets
searchstring—Search term for market question
active_onlybooltrueOnly active, non-closed markets

​
Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.polysimulator.com/v1/markets?hot_only=true&limit=10"

​
Response

[
  {
    "condition_id": "0x1a2b3c...",
    "slug": "will-bitcoin-reach-100k-by-2026",
    "question": "Will Bitcoin reach $100K by end of 2026?",
    "outcomes": ["Yes", "No"],
    "active": true,
    "closed": false,
    "is_hot": true,
    "image_url": "https://polymarket-upload.s3.us-east-2.amazonaws.com/...",
    "event_group_id": "crypto-2026",
    "event_title": "Crypto Milestones 2026",
    "end_date": "2026-12-31T23:59:59Z",
    "live_price": {
      "buy": "0.65",
      "sell": "0.35",
      "best_bid": "0.64",
      "best_ask": "0.66",
      "spread": "0.02",
      "volume": "125000.50",
      "last_trade": "0.65",
      "outcomes": [
        {"label": "Yes", "price": "0.65", "token_id": "71321..."},
        {"label": "No", "price": "0.35", "token_id": "71322..."}
      ],
      "updated_at": "2026-02-06T12:00:45Z"
    }
  }
]
All numeric values (buy, sell, price, volume) are strings for floating-point precision safety. See String Numerics.

​
Get Market Detail

GET /v1/markets/{condition_id}
Returns full market detail with an optional order book snapshot.

​
Query Parameters

ParameterTypeDefaultDescription
include_bookboolfalseInclude CLOB order book snapshot
curl -H "X-API-Key: $API_KEY" \
  "https://api.polysimulator.com/v1/markets/0x1a2b3c?include_book=true"
The response is the same as a list item, plus an optional order_book field when include_book=true.

​
Hot Markets

Markets with trading volume exceeding $5,000 are flagged as is_hot: true. Use hot_only=true to filter for actively traded markets — recommended for bots to ensure sufficient liquidity. 
# Only hot markets
curl -H "X-API-Key: $API_KEY" \
  "https://api.polysimulator.com/v1/markets?hot_only=true"

​
Next Steps