Skip to main content
GET
/
v1
/
markets
Get markets
curl --request GET \
  --url https://gateway.polymarket.us/v1/markets
{
  "markets": [
    {
      "id": "<string>",
      "question": "<string>",
      "slug": "<string>",
      "twitterCardImage": "<string>",
      "resolutionSource": "<string>",
      "endDate": "<string>",
      "category": "<string>",
      "liquidity": "<string>",
      "startDate": "<string>",
      "image": "<string>",
      "icon": "<string>",
      "description": "<string>",
      "volume": "<string>",
      "active": true,
      "marketType": "<string>",
      "closed": true,
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "closedTime": "<string>",
      "subcategory": "<string>",
      "archived": true,
      "questionId": "<string>",
      "enableOrderBook": true,
      "orderPriceMinTickSize": 123,
      "orderMinSize": 123,
      "volumeNum": 123,
      "liquidityNum": 123,
      "volume24hr": 123,
      "gameStartTime": "<string>",
      "acceptingOrders": true,
      "spread": 123,
      "oneDayPriceChange": 123,
      "lastTradePrice": 123,
      "bestBid": 123,
      "bestAsk": 123,
      "gameId": "<string>",
      "sportsMarketType": "<string>",
      "line": 123,
      "volume1wk": 123,
      "volume1mo": 123,
      "oneWeekPriceChange": 123,
      "oneMonthPriceChange": 123,
      "marketSides": [
        {
          "id": "<string>",
          "marketSideType": "MARKET_SIDE_TYPE_ERC1155",
          "identifier": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "description": "<string>",
          "price": "<string>",
          "marketId": 123,
          "long": true,
          "teamId": 123,
          "team": {
            "id": 123,
            "name": "<string>",
            "abbreviation": "<string>",
            "league": "<string>",
            "record": "<string>",
            "logo": "<string>",
            "alias": "<string>",
            "safeName": "<string>",
            "homeIcon": "<string>",
            "awayIcon": "<string>",
            "colorPrimary": "<string>",
            "providerId": 123,
            "ordering": "<string>",
            "longIcon": "<string>",
            "shortIcon": "<string>",
            "displayAbbreviation": "<string>",
            "ranking": 123,
            "conference": "<string>",
            "providerIds": [
              {
                "provider": "PROVIDER_SPORTSDATAIO",
                "providerId": "<string>"
              }
            ],
            "longIconDark": "<string>",
            "shortIconDark": "<string>"
          },
          "participantId": "<string>"
        }
      ],
      "outcomes": "<string>",
      "outcomePrices": "<string>",
      "ep3Status": "<string>",
      "sportsMarketTypeV2": "SPORTS_MARKET_TYPE_MONEYLINE",
      "hidden": true
    }
  ]
}

Query Parameters

​
limit
integer<int32>

Maximum number of markets to return per page. Use with offset for pagination. Example: 50

​
offset
integer<int32>

Number of markets to skip for pagination. Use with limit to page through results. Example: 100 skips the first 100 markets

​
orderBy
string[]

Fields to sort results by. Supports multiple fields for multi-level sorting. Common values: volumeNum, liquidityNum, createdAt, lastTradePrice

​
orderDirection
enum<string>

Sort direction for the orderBy fields. Use asc for ascending or desc for descending order. Default: desc

Available options:
asc,
desc
​
id
integer<int32>[]

Filter by specific market IDs. Returns only markets matching these numeric identifiers. Example: [123, 456]

​
slug
string[]

Filter by market URL slugs. Returns only markets matching these slug identifiers. Example: will-team-a-win

​
archived
boolean

Filter by archived status. true returns only archived/hidden markets, false excludes archived markets from results

​
active
boolean

Filter by active trading status. true returns only markets currently accepting orders, false returns inactive markets

​
closed
boolean

Filter by closed status. true returns only markets that have closed (resolved or expired), false returns open markets

​
liquidityNumMin
number<double>

Minimum available liquidity in USD. Only returns markets with liquidity >= this value. Example: 500.00

​
liquidityNumMax
number<double>

Maximum available liquidity in USD. Only returns markets with liquidity <= this value. Example: 50000.00

​
volumeNumMin
number<double>

Minimum total trading volume in USD. Only returns markets with volume >= this value. Example: 1000.00

​
volumeNumMax
number<double>

Maximum total trading volume in USD. Only returns markets with volume <= this value. Example: 100000.00

​
startDateMin
string<date-time>

Filter markets starting on or after this date. ISO 8601 format. Example: 2025-01-01T00:00:00Z

​
startDateMax
string<date-time>

Filter markets starting on or before this date. ISO 8601 format. Example: 2025-12-31T23:59:59Z

​
endDateMin
string<date-time>

Filter markets ending/expiring on or after this date. ISO 8601 format. Example: 2025-01-01T00:00:00Z

​
endDateMax
string<date-time>

Filter markets ending/expiring on or before this date. ISO 8601 format. Example: 2025-12-31T23:59:59Z

​
tagId
integer<int32>

Filter markets by a specific tag ID. Returns only markets that have this tag applied

​
relatedTags
boolean

When true and tagId is provided, also includes markets with tags related to the specified tag

​
cyom
boolean

Filter Create Your Own Market submissions. true returns only user-submitted markets, false excludes them

​
gameId
string

Filter by sports game ID from the data provider. Returns all markets associated with a specific sporting event

​
sportsMarketTypes
enum<string>[]

Filter by sports market type. MONEYLINE (winner), SPREAD (point spread), TOTAL (over/under), or PROP (player/game props)

Available options:
SPORTS_MARKET_TYPE_MONEYLINE,
SPORTS_MARKET_TYPE_SPREAD,
SPORTS_MARKET_TYPE_TOTAL,
SPORTS_MARKET_TYPE_PROP
​
rewardsMinSize
number<double>

Minimum order size in USD eligible for liquidity rewards. Filters to markets where reward-eligible orders must be at least this size

​
questionIds
string[]

Filter by question IDs (UUIDs). Returns markets associated with these question identifiers

​
includeTag
boolean

When true, includes full tag information in the response for each market

​
categories
string[]

Filter by market categories. Example values: sports, politics, crypto, entertainment

​
marketTypes
string[]

Filter by market format types. Example values: binary, scalar

Response

List of markets

​
markets
object[]

List of markets