markets

Get markets

Get active, non-archived markets (offset pagination).

get/markets

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
  • Auth: none declared

Query parameters

idinteger[] nullable

Market IDs to return

slugstring[] nullable

Market slugs to return

archivedstring

Filter by archived flag (true/false)

activestring

Filter by active flag (true/false)

decimalizedstring

Filter by decimalized flag (true/false)

closedstring

Filter by closed flag (true/false)

clob_token_idsstring[] nullable

CLOB token IDs to return

position_idsstring[] nullable

Position IDs to return

condition_idsstring[] nullable

Condition IDs to return

request_idsstring[] nullable

V2 oracle request IDs to return (conditionId for binary/incremental neg-risk, onchainEventId for atomic neg-risk)

onchain_event_idsstring[] nullable

V2 on-chain event IDs to return (all markets of each on-chain event)

market_maker_addressstring[] nullable

Market maker addresses to return

liquidity_num_minstring

Minimum liquidity

liquidity_num_maxstring

Maximum liquidity

volume_num_minstring

Minimum volume

volume_num_maxstring

Maximum volume

start_date_minstring

Minimum start date (RFC3339 or YYYY-MM-DD)

start_date_maxstring

Maximum start date (RFC3339 or YYYY-MM-DD)

end_date_minstring

Minimum end date (RFC3339 or YYYY-MM-DD)

end_date_maxstring

Maximum end date (RFC3339 or YYYY-MM-DD)

tag_idinteger[] nullable

Tag IDs to filter by

related_tagsstring

Include markets from related tags (true/false)

tag_matchstring

Tag match mode

cyomstring

Filter by CYOM flag (true/false)

rfq_enabledstring

Filter by RFQ-enabled flag (true/false)

combo_statusstring

Filter by combo status (pending/enabled/disabled)

uma_resolution_statusstring

Filter by UMA resolution status

resolution_status'inactive' | 'active' | 'resolved'

Filter by resolution status (inactive/active/resolved). v2 markets only — v1 markets carry no resolution_status and use uma_resolution_status instead

versionstring[] nullable

Protocol versions to return (v1 or v2). Repeat the parameter for several. Omitted means the server default on public lists (v1 while polymarket-v2 is in its builder integration period)

game_idstring

Filter by game ID

sports_market_typesstring[] nullable

Filter by sports market types

rewards_min_sizestring

Filter by minimum rewards size

question_idsstring[] nullable

Question IDs to return

include_tagstring

Include tag data (true/false)

localestring

Locale used to localize returned content

market_metadata_keystring

Filter by market metadata key

market_metadata_valuestring

Filter by market metadata value

limitinteger

Max results returned

offsetinteger

Number of results to skip

orderstring

Comma-separated field names to sort by

ascendingboolean

Sort ascending when true (default true)

after_cursorstring

Opaque keyset pagination cursor from a previous response

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.