Sign in
    Polymarket prediction market data endpoints, plus API documentation and monitoring.
    Read-only preview
    You're browsing the public OpenAPI spec. Sign in to send live requests with your team's API key.
    Sign in

    Quickstart

    Preview Polymarket activity with recent trade events for a market token. Swap in any token, condition, or event type from the endpoint catalog below.

    Website
    No API key on this team yet — sample shows <YOUR_JWT> placeholder.
    cURL
    1curl 'https://token-api.service.pinax.network/v1/polymarket/markets/activity?token_id=53342136288932702007624506186417846874594504126387502748453102780630218207922&event_type=trade&limit=10&page=1' \
    2  -H 'Authorization: Bearer <YOUR_JWT>' \
    3  -H 'Accept: application/json'
    Polymarket Markets

    Market Lookup

    FREE

    Returns market metadata including question, outcomes with token IDs, volume, and status. Each market has exactly two outcomes (binary); multi-outcome scenarios are modeled as multiple markets grouped under one event.

    Use this to discover token_id values needed for OHLCV and position queries, or to resolve a slug to identifiers. When no identifier is provided, returns a paginated list for discovery.

    GET
    https://token-api.service.pinax.network/v1/polymarket/markets

    Optional parameters

    NameTypeDescription
    condition_id
    query
    		string
    e.g. 0x9708334534b504e2025a5a6af92f8600808c10be577e5066f920c40625fbec16
    market_slug
    query
    		string
    e.g. will-bitcoin-reach-150k-in-january-2026
    token_id
    query
    		string
    e.g. 53342136288932702007624506186417846874594504126387502748453102780630218207922
    event_slug
    query
    		string
    e.g. will-bitcoin-reach-150k-in-january-2026
    closed
    query
    		boolean
    sort_by
    query
    		Enum · 3
    volumeend_datestart_date
    limit
    query
    		integerNumber of items* returned in a single request.
    *Plan restricted.
    page
    query
    		integerPage number to fetch.
    Empty data array signifies end of results.

    Response

    200 OK
    {
  "data": [
    {
      "condition_id": "0x6331a779482df72d904c3c1e12b6409ff836bc06f8c97945cba9b25ada2c605c",
      "market_slug": "will-the-portland-trail-blazers-win-the-2026-nba-finals",
      "event_slug": "2026-nba-champion",
      "event_title": "2026 NBA Champion",
      "question": "Will the Portland Trail Blazers win the 2026 NBA Finals?",
      "description": "",
      "outcomes": [
        {
          "label": "Yes",
          "token_id": "82402823484466457361170410951601106261368113664328436062375970009969959380598"
        },
        {
          "label": "No",
          "token_id": "48262548906086150698299934962091284390063927164151224719187427455086357699251"
        }
      ],
      "closed": false,
      "neg_risk": true,
      "accepting_orders": true,
      "fees_enabled": false,
      "volume": 5483559.78,
      "start_date": "2025-06-23T16:02:41.286933Z",
      "end_date": "2026-07-01T00:00:00Z"
    }
  ]
}