Skip to main content
GET
/
v1
/
partners
/
{partnerKey}
/
events
/
{externalId}
Get Event By Partner External ID
curl --request GET \
  --url https://gateway.polymarket.us/v1/partners/{partnerKey}/events/{externalId}
{
  "event": {
    "id": "<string>",
    "ticker": "<string>",
    "slug": "<string>",
    "title": "<string>",
    "subtitle": "<string>",
    "description": "<string>",
    "resolutionSource": "<string>",
    "startDate": "<string>",
    "creationDate": "<string>",
    "endDate": "<string>",
    "image": "<string>",
    "active": true,
    "closed": true,
    "archived": true,
    "liquidity": 123,
    "volume": 123,
    "openInterest": 123,
    "category": "<string>",
    "subcategory": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "volume24hr": 123,
    "volume1wk": 123,
    "volume1mo": 123,
    "volume1yr": 123,
    "closedTime": "<string>",
    "eventDate": "<string>",
    "startTime": "<string>",
    "eventWeek": 123,
    "seriesSlug": "<string>",
    "score": "<string>",
    "elapsed": "<string>",
    "period": "<string>",
    "live": true,
    "ended": true,
    "finishedTimestamp": "<string>",
    "featuredOrder": 123,
    "gameStatus": "<string>",
    "markets": [
      {
        "id": "<string>",
        "question": "<string>",
        "slug": "<string>",
        "endDate": "<string>",
        "category": "<string>",
        "startDate": "<string>",
        "image": "<string>",
        "description": "<string>",
        "active": true,
        "marketType": "<string>",
        "closed": true,
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "archived": true,
        "orderPriceMinTickSize": 123,
        "gameStartTime": "<string>",
        "bestBid": 123,
        "bestAsk": 123,
        "manualActivation": true,
        "sportsMarketType": "<string>",
        "line": 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": "<string>",
              "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,
        "tags": [
          {
            "id": "<string>",
            "label": "<string>",
            "slug": "<string>",
            "forceShow": true,
            "publishedAt": "<string>",
            "createdBy": 123,
            "updatedBy": 123,
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "forceHide": true,
            "isCarousel": true,
            "image": "<string>",
            "tradable": true,
            "subtags": [
              {}
            ]
          }
        ],
        "title": "<string>",
        "subtitle": "<string>",
        "color": "<string>",
        "darkColor": "<string>",
        "subjectId": 123,
        "subject": {
          "id": 123,
          "name": "<string>",
          "displayName": "<string>",
          "description": "<string>",
          "subjectType": "<string>",
          "image": "<string>",
          "color": "<string>",
          "darkColor": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>"
        }
      }
    ],
    "gameId": 123,
    "rescheduledFromGameId": 123,
    "sportradarGameId": "<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>"
      },
      "ufcState": {
        "weightClass": "<string>",
        "cardSegment": "<string>",
        "eventLogo": "<string>",
        "rounds": 123,
        "order": 123
      },
      "tennisState": {
        "tournamentName": "<string>",
        "round": "<string>"
      },
      "mainSpreadLine": 123,
      "mainTotalLine": 123
    },
    "participants": [
      {
        "id": "<string>",
        "type": "PARTICIPANT_TYPE_NOMINEE",
        "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>",
            "displayAbbreviation": "<string>",
            "ranking": "<string>",
            "conference": "<string>",
            "providerIds": [
              {
                "provider": "PROVIDER_SPORTSDATAIO",
                "providerId": "<string>"
              }
            ],
            "longIconDark": "<string>",
            "shortIconDark": "<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>",
          "displayAbbreviation": "<string>",
          "ranking": "<string>",
          "conference": "<string>",
          "providerIds": [
            {
              "provider": "PROVIDER_SPORTSDATAIO",
              "providerId": "<string>"
            }
          ],
          "longIconDark": "<string>",
          "shortIconDark": "<string>"
        }
      }
    ],
    "hidden": true,
    "tags": [
      {
        "id": "<string>",
        "label": "<string>",
        "slug": "<string>",
        "forceShow": true,
        "publishedAt": "<string>",
        "createdBy": 123,
        "updatedBy": 123,
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "forceHide": true,
        "isCarousel": true,
        "image": "<string>",
        "tradable": true,
        "subtags": [
          {}
        ]
      }
    ],
    "teams": [
      {
        "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": "<string>",
        "conference": "<string>",
        "providerIds": [
          {
            "provider": "PROVIDER_SPORTSDATAIO",
            "providerId": "<string>"
          }
        ],
        "longIconDark": "<string>",
        "shortIconDark": "<string>"
      }
    ],
    "metadata": {
      "gameState": {
        "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>"
        },
        "ufcState": {
          "weightClass": "<string>",
          "cardSegment": "<string>",
          "eventLogo": "<string>",
          "rounds": 123,
          "order": 123
        },
        "tennisState": {
          "tournamentName": "<string>",
          "round": "<string>"
        },
        "mainSpreadLine": 123,
        "mainTotalLine": 123
      },
      "latestGameUpdate": {
        "id": 123,
        "eventId": 123,
        "sportradarGameId": "<string>",
        "type": "<string>",
        "title": "<string>",
        "subtitle": "<string>",
        "subject": "<string>",
        "team": "<string>",
        "period": "<string>",
        "clock": "<string>",
        "highlightAt": "2023-11-07T05:31:56Z",
        "createdAt": "2023-11-07T05:31:56Z"
      }
    }
  },
  "mappedMarketSides": [
    {
      "marketSideId": 123,
      "marketId": 123,
      "eventId": 123,
      "externalEventId": "<string>",
      "externalMarketType": "<string>",
      "externalNormalizedSelection": "<string>",
      "externalSelectionLine": "<string>",
      "externalPoints": "<string>"
    }
  ]
}

Path Parameters

partnerKey
string
required

Partner slug (e.g. opticodds)

externalId
string
required

Partner external event ID (e.g. OpticOdds fixture ID)

Response

Event details with mapped market sides

event
object

Event information and configuration

mappedMarketSides
object[]

Partner-linked market sides for this event