events

Get event by slug

Get a single event by slug.

get/events/slug/{slug}

Request

  • Base URL: https://gamma-api.polymarket.com (the document declares no server; this is the origin it was published from)
  • URL: https://gamma-api.polymarket.com/events/slug/{slug}
  • Auth: none declared

Path parameters

slugstring required

Event slug

Query parameters

include_best_linesstring

Include best lines (true/false)

localestring

Locale code

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

activeboolean
archivedboolean
automaticallyActiveboolean
automaticallyResolvedboolean
cantEstimateboolean
carouselMapstring
categorystring
closedboolean
closedTimestring date-time
colorstring
commentCountinteger
commentsEnabledboolean
competitivenumber double
countryNamestring
createdAtstring date-time
createdBystring
creationDatestring date-time
cumulativeMarketsboolean
cyomboolean
deployingboolean
deployingTimestampstring date-time
descriptionstring
disqusThreadstring
elapsedstring
electionTypestring
enableNegRiskboolean
enableOrderBookboolean
endDatestring date-time
endedboolean
estimateValueboolean
estimatedValuestring
eventDatestring
eventMetadataobject
eventWeekinteger
featuredboolean
featuredImagestring
featuredOrderinteger
finishedTimestampstring date-time
gameIdinteger
gmpChartModestring
iconstring
idstring required
imagestring
isTemplateboolean
lastHighlightstring
lastHighlightAtstring date-time
lastHighlightTypestring
liquiditynumber double
liquidityAmmnumber double
liquidityClobnumber double
liveboolean
maxMarketCountinteger

Maximum number of markets the event can ever hold: the neg-risk arity packed into the v2 event id at first deployment (atomic neg-risk: equals the member count; incremental neg-risk: reserves slots for later appends). Null for binary events. Immutable once deployed — condition ids derive from it.

negRiskboolean
negRiskAugmentedboolean
negRiskFeeBipsinteger
negRiskMarketIDstring
newboolean
openInterestnumber double
parentEventIdinteger
pendingDeploymentboolean
periodstring
published_atstring
rescheduledFromGameIdinteger
resolutionSourcestring
restrictedboolean
scheduledDeploymentTimestampstring date-time
scorestring
seriesSlugstring
showAllOutcomesboolean
showMarketImagesboolean
slugstring
sortBystring
spreadsMainLinenumber double
startDatestring date-time
startTimestring date-time
subEventsstring[] nullable
subcategorystring
subtitlestring
tag_labelsstring[] nullable
tag_slugsstring[] nullable
templateVariablesstring
tickerstring
titlestring
totalsMainLinenumber double
turnProviderIdstring
tweetCountinteger
updatedAtstring date-time
updatedBystring
usIdstring
version'v1' | 'v2'

Protocol version of the event: v1 (legacy) or v2 (all child markets on polymarket-v2 modules). Clients must match exact values and treat unknown values as unsupported.

volumenumber double
volume1monumber double
volume1wknumber double
volume1yrnumber double
volume24hrnumber double

Example response

{
  "$schema": "https://example.com/schemas/Event.json",
  "eventCreators": [
    {
      "$schema": "https://example.com/schemas/EventCreator.json"
    }
  ],
  "externalPartners": [
    {
      "$schema": "https://example.com/schemas/EventExternalPartnerMapping.json",
      "partner": {
        "$schema": "https://example.com/schemas/Partner.json"
      }
    }
  ],
  "markets": [
    {
      "$schema": "https://example.com/schemas/Market.json",
      "cryptoMarketConfig": {
        "$schema": "https://example.com/schemas/CryptoMarketConfig.json"
      },
      "tags": [
        {
          "$schema": "https://example.com/schemas/Tag.json"
        }
      ]
    }
  ],
  "series": [
    {
      "$schema": "https://example.com/schemas/Series.json"
    }
  ],
  "sport": {
    "$schema": "https://example.com/schemas/SportsMetadata.json",
    "externalPartners": [
      {
        "$schema": "https://example.com/schemas/SportExternalPartnerMapping.json",
        "partner": {
          "$schema": "https://example.com/schemas/Partner.json"
        }
      }
    ]
  },
  "tags": [
    {
      "$schema": "https://example.com/schemas/Tag.json"
    }
  ],
  "teams": [
    {
      "$schema": "https://example.com/schemas/Team.json",
      "externalPartners": [
        {
          "$schema": "https://example.com/schemas/TeamExternalPartnerMapping.json",
          "partner": {
            "$schema": "https://example.com/schemas/Partner.json"
          }
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.