GET/v1/markets/live

List All Markets

Returns all currently tracked prediction markets with real-time status, expiry info, token IDs, and category information. Optionally filter by category or subcategory, and cap the payload with limit/offset — an unfiltered call on a full-access tier returns ~2,000 markets. Passing limit or offset sorts the response soonest-expiring first, so limit=1 gives you the current window rather than an arbitrary market.

Query Parameters

formatstringdefault:json

Response encoding. csv and tsv return the rows as a flat file instead of a JSON envelope — the envelope moves to X-* response headers and nulls render as \N. REQUIRES SCALE OR ENTERPRISE (json is available on every tier). Works with includebook=true — the bids/asks ladders come through as compact JSON inside their cell, complete and parseable (pandas: df["bids"].apply(json.loads)).

categorystring

Filter by category

subcategorystring

Filter by subcategory (case-sensitive). Sports: NBA, NFL, EPL — plus FIFA / IPL historical. Crypto coins: BTC…BNB. Economics: FOMC. Weather: full city names (NYC, Miami, Hong Kong, …). Equities: IPO, Private, StockPrice, Commodity, Forex, SPX, etc. Social: Elon. See the Available Markets guide for the full list.

cryptostring

Filter to a single coin. Only crypto markets carry this field, so it also excludes non-crypto categories.

timeframestring

Filter by timeframe. NOT just crypto cadences — it is a per-category discriminator: crypto 5m/15m/1h/4h/1d plus hit-price, sports game, economics rates, social weekly, weather daily-high/daily-low/event/seasonal, equities annual/monthly/daily/event/earnings/quarterly/valuation/comparison/leaderboard. Combine with crypto to isolate one series, e.g. crypto=BTC + timeframe=5m.

limitnumber

Cap the number of markets returned (1–5000), applied after the filters. Passing it sorts the response soonest-expiring first (expiresIn ascending), so a truncated list is the NEXT N markets rather than an arbitrary N.

offsetnumberdefault:0

Row offset for paging a windowed list. Also applies the soonest-expiring-first sort.

Response

200401403404500

Successful Response

Code Snippet

curl -X GET "https://api.resolvedmarkets.com/v1/markets/live" \
  -H "X-API-Key: YOUR_API_KEY"

200

[
  {
    "conditionId": "0x778be094...",
    "category": "crypto",
    "subcategory": "BTC",
    "label": "Bitcoin 5m Up or Down?",
    "tokenIds": ["1234...", "5678..."],
    "outcomes": ["UP", "DOWN"],
    "configId": "crypto-updown",
    "slug": "btc-updown-5m-...",
    "expired": false,
    "expiresIn": 234000
  },
  {
    "conditionId": "0xabc123...",
    "category": "sports",
    "subcategory": "NBA",
    "label": "Lakers vs Celtics - Winner",
    "tokenIds": ["9012...", "3456..."],
    "outcomes": ["Yes", "No"],
    "configId": "nba",
    "slug": "lakers-celtics-winner-...",
    "expired": false,
    "expiresIn": 7200000
  }
]