GET/markets-by-token/{token_id}

Get market by token

Returns the parent market for a given token ID. Useful when you have a token ID and need to resolve its parent market without knowing the condition ID in advance.

Base URL: https://clob.polymarket.com
Auth: Public, no key
Rate limit: 9,000 req / 10s (900 per second)
Limit applies to: CLOB API general

Parameters

Name	In	Type	Required	Description
token_id	path	string	yes	The token ID to look up the parent market for

Example

curl -X GET "https://clob.polymarket.com/markets-by-token/<token_id>"

Response fields

Field	Type	Description
condition_id	string	The condition ID of the market containing the given token
primary_token_id	string	The primary (Yes) token ID
secondary_token_id	string	The secondary (No) token ID

Responses

Status	Meaning
200	Successfully retrieved market
400	Invalid market - empty token_id
404	Market not found for token
500	Internal server error

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.