GET /v1/markets

Paginated list of prediction markets from Polymarket and Kalshi. Filter by source, symbol, market_type, or active status.

Minimum tier: Free | Credits: 25 flat per request

GET https://kwery-api.com/v1/markets?api-key=YOUR_KEY

Parameters

The offset parameter is deprecated as of v1.6.0. Use after with the meta.next_cursor value for pagination.

For single-market lookups, use GET /v1/markets/{identifier}. The {identifier} path parameter accepts any of: market_id (numeric), condition_id (0x-prefixed hex), or event slug (human-readable string).

Response fields

Each object in data contains the following fields:

Response headers

Example request

cURL

# List Kalshi prediction markets
curl "https://kwery-api.com/v1/markets?source=kalshi&symbol=BTC&limit=10" \
  -H "X-API-Key: YOUR_KEY"

curl "https://kwery-api.com/v1/markets?api-key=YOUR_KEY&source=polymarket&symbol=BTC&is_active=true&limit=2"

Python

import requests

resp = requests.get("https://kwery-api.com/v1/markets", params={
    "api-key": "YOUR_KEY",
    "source": "polymarket",
    "symbol": "BTC",
    "is_active": True,
    "limit": 2,
})
data = resp.json()

TypeScript

const params = new URLSearchParams({
  "api-key": "YOUR_KEY",
  source: "polymarket",
  symbol: "BTC",
  is_active: "true",
  limit: "2",
});

const res = await fetch(`https://kwery-api.com/v1/markets?${params}`);
const data = await res.json();

Example response

{
  "data": [
    {
      "market_id": "0xabc123",
      "source": "polymarket",
      "slug": "btc-above-100k-march-2026",
      "question": "Will BTC close above $100,000 on March 31, 2026?",
      "symbol": "BTC",
      "market_type": "binary",
      "start_date": "2026-03-01T00:00:00Z",
      "end_date": "2026-03-31T23:59:59Z",
      "is_active": true,
      "resolution": null,
      "resolved_at": null,
      "final_volume": null,
      "final_liquidity": null,
      "tokens": {
        "clob_token_up": "0xtoken_up_789",
        "clob_token_down": "0xtoken_down_012",
        "condition_id": "0xdef456"
      }
    },
    {
      "market_id": "0xdef789",
      "source": "polymarket",
      "slug": "btc-above-110k-march-2026",
      "question": "Will BTC close above $110,000 on March 31, 2026?",
      "symbol": "BTC",
      "market_type": "binary",
      "start_date": "2026-03-01T00:00:00Z",
      "end_date": "2026-03-31T23:59:59Z",
      "is_active": true,
      "resolution": null,
      "resolved_at": null,
      "final_volume": null,
      "final_liquidity": null,
      "tokens": {
        "clob_token_up": "0xtoken_up_abc",
        "clob_token_down": "0xtoken_down_def",
        "condition_id": "0xghi012"
      }
    }
  ],
  "meta": {
    "symbol": "BTC",
    "source": "polymarket",
    "interval": null,
    "count": 2,
    "next_cursor": "eyJpZCI6IjB4ZGVmNzg5In0="
  }
}

Source-specific behavior

Tier access

Errors