markets

Get market by slug

Get a single market by slug.

get/markets/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/markets/slug/{slug}
  • Auth: none declared

Path parameters

slugstring required

Market slug

Query parameters

include_tagstring

Include tag data (true/false)

localestring

Locale used to localize returned content

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

acceptingOrdersboolean
acceptingOrdersTimestampstring date-time
acceptingOrdersUntilstring date-time
activeboolean
ammTypestring
approvedboolean
archivedboolean
automaticallyActiveboolean
automaticallyResolvedboolean
bestAsknumber double
bestBidnumber double
categorystring
categoryMailchimpTagstring
chartColorstring
clearBookOnStartboolean
clobTokenIdsstring
closedboolean
closedTimestring
comboStatus'pending' | 'enabled' | 'disabled'

Combo eligibility state: pending/enabled/disabled. May be set at creation — enabled requires a conditionId and two positionIds. After creation it can only be changed through the combo-status endpoint.

commentsEnabledboolean
competitivenumber double
conditionIdstring required
createdAtstring date-time
createdByinteger
creatorstring
cryptoMarketConfigIdstring
curationOrderinteger
customLivenessinteger
cyomboolean
denominationTokenstring
deployingboolean
deployingTimestampstring date-time
descriptionstring
disqusThreadstring
enableOrderBookboolean
endDatestring date-time
endDateIsostring
eventStartTimestring date-time
featuredboolean
feestring
feeExponentnumber double
feeRatenumber double
feeTypestring nullable required
feesEnabledboolean
formatTypestring
fpmmLiveboolean
fundedboolean
fundedTimestampstring date-time
gameIdstring
gameStartTimestring
groupItemRangestring
groupItemThresholdstring
groupItemTitlestring
hasReviewedDatesboolean
holdingRewardsEnabledboolean
iconstring
idstring required
imagestring
lastTradePricenumber double
linenumber double
liquiditystring
liquidityAmmnumber double
liquidityClobnumber double
liquidityNumnumber double
lowerBoundstring
lowerBoundDatestring
mailchimpTagstring
makerBaseFeeinteger
makerRebatesFeeShareBpsinteger
manualActivationboolean
marketGroupinteger
marketMakerAddressstring required
marketMetadataobject
marketTypestring
negRiskboolean
negRiskMarketIDstring
negRiskOtherboolean
negRiskRequestIDstring
newboolean
notificationsEnabledboolean
onchainEventIdstring

Parent v2 on-chain event ID: bytes32 hex with the bottom 3 bytes zero, equal to the v2 conditionId with its conditionIndex cleared. Shared by every market of a neg-risk event. Only present on v2 markets. Read-only: derived from the v2 conditionId; writes are rejected unless echoing the stored value.

oneDayPriceChangenumber double
oneHourPriceChangenumber double
oneMonthPriceChangenumber double
oneWeekPriceChangenumber double
oneYearPriceChangenumber double
orderMinSizenumber double
orderPriceMinTickSizenumber double
outcomePricesstring
outcomesstring
pastSlugsstring
pendingDeploymentboolean
positionIdsstring[] nullable
questionstring
questionIDstring
readyboolean
readyForCronboolean
readyTimestampstring date-time
requestIdstring

V2 oracle request ID (bytes32 hex): the key the OracleAggregator resolves the market under. Equals the conditionId for binary and incremental neg-risk markets, and the onchainEventId for atomic neg-risk markets. Only present on v2 markets. Auto-derived for binary markets; for neg-risk markets it is set at creation and must equal the conditionId or the onchainEventId.

resolutionSourcestring
resolutionStatus'inactive' | 'active' | 'resolved'

High-level resolution state of the market: inactive (drafted, not yet deployed on chain), active (deployed, not resolved yet) or resolved. Only written for v2 markets; v1 markets keep using umaResolutionStatus.

resolvedBystring
restrictedboolean
rewardsMaxSpreadnumber double
rewardsMinSizenumber double
rfqEnabledboolean
scheduledDeploymentTimestampstring date-time
scoreinteger
secondsDelayinteger
sentDiscordboolean
seriesColorstring
shortOutcomesstring
showGmpOutcomeboolean
showGmpSeriesboolean
slugstring
sponsorImagestring
sponsorNamestring
sportsMarketTypestring
spreadnumber double
startDatestring date-time
startDateIsostring
subcategorystring
submitted_bystring
takerBaseFeeinteger
teamAIDstring
teamBIDstring
twitterCardImagestring
twitterCardLastRefreshedstring
twitterCardLastValidatedstring
twitterCardLocationstring
umaBondstring
umaEndDatestring
umaEndDateIsostring
umaResolutionStatusstring
umaResolutionStatusesstring
umaRewardstring
updatedAtstring date-time
updatedByinteger
upperBoundstring
upperBoundDatestring
version'v1' | 'v2'

Protocol version the market trades on: v1 (legacy CTF/CLOB) or v2 (polymarket-v2 modules). Clients must match exact values and treat unknown values as unsupported.

volumestring
volume1monumber double
volume1moAmmnumber double
volume1moClobnumber double
volume1wknumber double
volume1wkAmmnumber double
volume1wkClobnumber double
volume1yrnumber double
volume1yrAmmnumber double
volume1yrClobnumber double
volume24hrnumber double
volume24hrAmmnumber double
volume24hrClobnumber double
volumeAmmnumber double
volumeClobnumber double
volumeNumnumber double
wideFormatboolean
xAxisValuestring
yAxisValuestring

Example response

{
  "$schema": "https://example.com/schemas/Market.json",
  "cryptoMarketConfig": {
    "$schema": "https://example.com/schemas/CryptoMarketConfig.json"
  },
  "events": [
    {
      "$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"
          }
        }
      ],
      "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"
              }
            }
          ]
        }
      ]
    }
  ],
  "tags": [
    {
      "$schema": "https://example.com/schemas/Tag.json"
    }
  ]
}

Changes

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