Skip to main content
GET
/
v1
/
markets
Get markets
curl --request GET \
  --url https://api.polymarket.us/v1/markets
{
  "markets": [
    {
      "id": "<string>",
      "question": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "resolutionSource": "<string>",
      "startDate": "<string>",
      "endDate": "<string>",
      "startDateIso": "<string>",
      "endDateIso": "<string>",
      "category": "<string>",
      "subcategory": "<string>",
      "marketType": "<string>",
      "formatType": "<string>",
      "liquidity": "<string>",
      "liquidityNum": 123,
      "volume": "<string>",
      "volumeNum": 123,
      "volume24hr": 123,
      "volume1wk": 123,
      "volume1mo": 123,
      "volume1yr": 123,
      "active": true,
      "closed": true,
      "archived": true,
      "featured": true,
      "new": true,
      "ready": true,
      "approved": true,
      "restricted": true,
      "hidden": true,
      "acceptingOrders": true,
      "enableOrderBook": true,
      "image": "<string>",
      "icon": "<string>",
      "twitterCardImage": "<string>",
      "orderPriceMinTickSize": 123,
      "orderMinSize": 123,
      "lastTradePrice": 123,
      "bestBid": 123,
      "bestAsk": 123,
      "spread": 123,
      "oneDayPriceChange": 123,
      "oneHourPriceChange": 123,
      "oneWeekPriceChange": 123,
      "oneMonthPriceChange": 123,
      "oneYearPriceChange": 123,
      "fee": "<string>",
      "makerBaseFee": 123,
      "takerBaseFee": 123,
      "outcomes": "<string>",
      "outcomePrices": "<string>",
      "shortOutcomes": {},
      "outcomeTeamA": 123,
      "outcomeTeamB": 123,
      "sportsMarketTypeV2": "UNSPECIFIED",
      "gameId": "<string>",
      "gameStartTime": "<string>",
      "eventStartTime": "<string>",
      "line": 123,
      "propType": "<string>",
      "cyom": true,
      "questionId": "<string>",
      "marketGroup": 123,
      "groupItemTitle": "<string>",
      "groupItemThreshold": 123,
      "groupItemRange": {},
      "negRisk": true,
      "negRiskMarketId": "<string>",
      "negRiskRequestId": "<string>",
      "negRiskOther": true,
      "rewardsMinSize": 123,
      "rewardsMaxSpread": 123,
      "competitive": 123,
      "curationOrder": 123,
      "automaticallyResolved": true,
      "automaticallyActive": true,
      "notificationsEnabled": true,
      "commentsEnabled": true,
      "rfqEnabled": true,
      "holdingRewardsEnabled": true,
      "wideFormat": true,
      "clearBookOnStart": true,
      "manualActivation": true,
      "lowerBound": "<string>",
      "upperBound": "<string>",
      "lowerBoundDate": "<string>",
      "upperBoundDate": "<string>",
      "xAxisValue": "<string>",
      "yAxisValue": "<string>",
      "chartColor": "<string>",
      "seriesColor": "<string>",
      "showGmpSeries": true,
      "showGmpOutcome": true,
      "denominationToken": "<string>",
      "sponsorName": "<string>",
      "sponsorImage": "<string>",
      "secondsDelay": 123,
      "customLiveness": 123,
      "creator": "<string>",
      "createdBy": 123,
      "updatedBy": 123,
      "resolvedBy": "<string>",
      "submittedBy": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "closedTime": "<string>",
      "readyTimestamp": "<string>",
      "acceptingOrderTimestamp": "<string>",
      "reviewStatus": "<string>",
      "hasReviewedDates": true,
      "readyForCron": true,
      "sentDiscord": true,
      "pagerDutyNotificationEnabled": true,
      "mailchimpTag": "<string>",
      "categoryMailchimpTag": "<string>",
      "twitterCardLocation": "<string>",
      "twitterCardLastRefreshed": "<string>",
      "twitterCardLastValidated": "<string>",
      "disqusThread": "<string>",
      "pastSlugs": {},
      "events": [
        {
          "id": "<string>",
          "ticker": "<string>",
          "slug": "<string>",
          "title": "<string>",
          "subtitle": "<string>",
          "description": "<string>",
          "resolutionSource": "<string>",
          "startDate": "<string>",
          "creationDate": "<string>",
          "endDate": "<string>",
          "image": "<string>",
          "icon": "<string>",
          "featuredImage": "<string>",
          "active": true,
          "closed": true,
          "archived": true,
          "new": true,
          "featured": true,
          "restricted": true,
          "hidden": true,
          "liquidity": 123,
          "volume": 123,
          "openInterest": 123,
          "volume24hr": 123,
          "volume1wk": 123,
          "volume1mo": 123,
          "volume1yr": 123,
          "sortBy": "<string>",
          "category": "<string>",
          "subcategory": "<string>",
          "isTemplate": true,
          "templateVariables": "<string>",
          "publishedAt": "<string>",
          "createdBy": "<string>",
          "updatedBy": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "commentsEnabled": true,
          "commentCount": 123,
          "competitive": 123,
          "disqusThread": "<string>",
          "parentEvent": "<string>",
          "enableOrderBook": true,
          "liquidityAmm": 123,
          "liquidityClob": 123,
          "negRisk": true,
          "negRiskMarketId": "<string>",
          "negRiskFeeBips": 123,
          "enableNegRisk": true,
          "negRiskAugmented": true,
          "cyom": true,
          "closedTime": "<string>",
          "showAllOutcomes": true,
          "showMarketImages": true,
          "automaticallyResolved": true,
          "automaticallyActive": true,
          "eventDate": "<string>",
          "startTime": "<string>",
          "eventWeek": 123,
          "seriesSlug": "<string>",
          "score": "<string>",
          "elapsed": "<string>",
          "period": "<string>",
          "live": true,
          "ended": true,
          "finishedTimestamp": "<string>",
          "gmpChartMode": "<string>",
          "countryName": "<string>",
          "electionType": "<string>",
          "color": "<string>",
          "tweetCount": 123,
          "featuredOrder": 123,
          "estimateValue": true,
          "cantEstimate": true,
          "estimatedValue": "<string>",
          "spreadsMainLine": 123,
          "totalsMainLine": 123,
          "carouselMap": "<string>",
          "gameStatus": "<string>",
          "gameId": 123,
          "rescheduledFromGameId": 123,
          "sportradarGameId": "<string>",
          "lastHighlight": "<string>",
          "turnProviderId": "<string>",
          "lastHighlightType": "<string>",
          "lastHighlightAt": "2023-11-07T05:31:56Z",
          "latestHighlight": {
            "id": 123,
            "eventId": 123,
            "type": "<string>",
            "highlightAt": "2023-11-07T05:31:56Z",
            "createdAt": "2023-11-07T05:31:56Z",
            "title": "<string>",
            "subtitle": "<string>",
            "description": "<string>",
            "clock": "<string>",
            "score": "<string>",
            "icon": {
              "largeIcon": "<string>",
              "smallIcon": "<string>"
            },
            "teamIcon": {
              "largeIcon": "<string>",
              "smallIcon": "<string>"
            },
            "playIcon": {
              "largeIcon": "<string>",
              "smallIcon": "<string>"
            }
          },
          "eventState": {
            "id": 123,
            "gameId": 123,
            "sportradarGameId": "<string>",
            "type": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "score": "<string>",
            "elapsed": "<string>",
            "period": "<string>",
            "live": true,
            "ended": true,
            "finishedTimestamp": "2023-11-07T05:31:56Z",
            "footballState": {
              "down": 123,
              "yard": 123,
              "possessionProviderId": "<string>"
            }
          },
          "participants": [
            {
              "id": "<string>",
              "type": "UNSPECIFIED",
              "nominee": {
                "id": "<string>",
                "name": "<string>"
              },
              "player": {
                "id": "<string>",
                "name": "<string>",
                "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>",
                  "longIconDark": "<string>",
                  "shortIconDark": "<string>",
                  "displayAbbreviation": "<string>",
                  "ranking": 123,
                  "conference": "<string>",
                  "providerIds": [
                    {
                      "provider": "<string>",
                      "id": "<string>"
                    }
                  ]
                }
              },
              "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>",
                "longIconDark": "<string>",
                "shortIconDark": "<string>",
                "displayAbbreviation": "<string>",
                "ranking": 123,
                "conference": "<string>",
                "providerIds": [
                  {
                    "provider": "<string>",
                    "id": "<string>"
                  }
                ]
              }
            }
          ],
          "markets": "<array>"
        }
      ]
    }
  ]
}

Query Parameters

limit
integer<int32>

Page size

offset
integer<int32>

Page offset

orderBy
string[]

Order by fields

orderDirection
string

Order direction (asc or desc)

id
integer<int32>[]

Filter by market IDs

slug
string[]

Filter by market slugs

archived
boolean

Filter by archived status

active
boolean

Filter by active status

closed
boolean

Filter by closed status

liquidityNumMin
number<double>

Minimum liquidity

liquidityNumMax
number<double>

Maximum liquidity

volumeNumMin
number<double>

Minimum volume

volumeNumMax
number<double>

Maximum volume

startDateMin
string

Minimum start date

startDateMax
string

Maximum start date

endDateMin
string

Minimum end date

endDateMax
string

Maximum end date

tagId
integer<int32>

Filter by tag ID

Include related tags in results

cyom
boolean

Filter by Create Your Own Market status

gameId
string

Filter by game ID

sportsMarketTypes
enum<string>[]

Filter by sports market types

Available options:
UNSPECIFIED,
MONEYLINE,
SPREAD,
TOTAL,
PROP
rewardsMinSize
number<double>

Minimum rewards size filter

questionIds
string[]

Filter by question IDs

includeTag
boolean

Include tag information in response

categories
string[]

Filter by categories

marketTypes
string[]

Filter by market types

Response

List of markets

markets
object[]

List of markets