Skip to main content
GET
/
v1
/
market
/
id
/
{id}
Get market by ID
curl --request GET \
  --url https://api.polymarket.us/v1/market/id/{id}
{
  "market": {
    "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>"
      }
    ]
  }
}

Path Parameters

id
integer<int32>
required

Market ID

Response

Market details

market
object

Market information and configuration