Polymarket Markets

GET/gateway/v1/prediction-market/polymarket/markets

Returns Polymarket markets, optionally filtered by `market_slug`.

Each market includes `side_a` and `side_b` outcomes. Current prices are available via `/polymarket/prices` using the `condition_id`.

Data refresh: ~30 minutes

Query Parameters

market_slugstringrequired

Polymarket market slug (identifies a single Yes/No outcome). Discover slugs via /v1/search/prediction-market?platform=polymarket&q={keyword}. For a multi-outcome question (e.g. 'who wins the 2024 election'), use the /polymarket/events endpoint with event_slug instead.

Example: will-bitcoin-dip-to-45000-by-december-31-2026-674-923-755-971-998-525-926-245-316-517-544-589-965-923-986-841-815-224

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

Polymarket Markets

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/prediction-market/polymarket/markets?market_slug=will-bitcoin-dip-to-45000-by-december-31-2026-674-923-755-971-998-525-926-245-316-517-544-589-965-923-986-841-815-224&limit=20&offset=0', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponsePolymarketMarketItem.json",
  "data": [
    {
      "category": "<string>",
      "close_time": 123,
      "completed_time": 123,
      "condition_id": "<string>",
      "description": "<string>",
      "end_time": 123,
      "event_slug": "<string>",
      "game_start_time": 123,
      "image": "<string>",
      "market_slug": "<string>",
      "negative_risk_id": "<string>",
      "polymarket_link": "<string>",
      "resolution_source": "<string>",
      "side_a": {
        "id": "<string>",
        "label": "<string>"
      },
      "side_b": {
        "id": "<string>",
        "label": "<string>"
      },
      "start_time": 123,
      "status": "<string>",
      "subcategory": "<string>",
      "tags": [],
      "title": "<string>",
      "volume_1_month": 123,
      "volume_1_week": 123,
      "volume_1_year": 123,
      "volume_total": 123,
      "winning_side": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}