Docs
⌘ K

Market Lookup

GET/v1/polymarket/markets

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.

Query Parameters

ParameterDescriptionValue
condition_id
string
    market_slug
    string
      token_id
      string
        event_slug
        string
          closed
          boolean
            sort_by
            string
            • Default value: volume
            • Accepted values: volume, end_date, start_date
            volume
            limit
            integer

            Number of items* returned in a single request.
            *Plan restricted.

            • Default value: 10
            • Minimum value: 1
            • Maximum value: 1000
            page
            integer

            Page number to fetch.
            Empty data array signifies end of results.

            • Default value: 1
            • Minimum value: 1
            • Maximum value: 767465558638

            Potential Responses

            StatusDescription
            200

            Successful Response

            400

            Client side error

            401

            Authentication failed

            403

            Forbidden

            404

            Not found

            500

            Server side error