Polymarket API endpoint
Returns one Polymarket market by condition id. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
/polymarket/market/condition/{condition_id}Path parameters:
condition_id: required Polymarket market condition id.Notable response behavior:
| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| slug | Has a value | |
| condition_id | Has a value | |
| market.id | Has a value | |
| market.slug | Has a value | |
| market.condition_id | Has a value | |
| market.question | Has a value | “Putin out as President of Russia by December 31, 2026?” |
| market.active | Has a value | true |
| market.closed | Has a value | false |
| market.end_date | Has a value | 2027-01-01 |
| market.volume | Has a value | 25,271,599.45 |
| market.volume_24h | Has a value | 378,733.58 |
| market.liquidity | Has a value | 617,108.65 |
| market.best_bid | Has a value | 0.03 |
| market.best_ask | Has a value | 0.03 |
| market.last_trade_price | Has a value | 0.03 |
| market.token_ids | Has a value | |
| market.outcomes | Has a value | 2 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| condition_id (path) | string | Yes | Polymarket market condition id | 0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/polymarket/market/condition/0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"condition_id": "0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327",
"market": {
"condition_id": "0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327",
"question": "Call of Duty: Paris Gentle Mates vs OpTic Texas - Game 4 Winner"
}
}
}Request schema
No body schema
Response schema
#/definitions/polymarket.marketDetailResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | polymarket.MarketDetailResponse | No | ||||
| data.condition_id | string | No | 0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327 | Condition id of the market that was requested. | ||
| data.fetched_at | string | No | 2026-06-07T11:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.id | string | No | 558934 | Polymarket market id that was requested. | ||
| data.market | object | No | Full details of the market. | |||
| data.market.active | boolean | No | `true` when the market is active. | |||
| data.market.best_ask | number | No | Lowest ask price currently offered on the market. | |||
| data.market.best_bid | number | No | Highest bid price currently offered on the market. | |||
| data.market.closed | boolean | No | `true` when the market is closed. | |||
| data.market.condition_id | string | No | 0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327 | Condition id that identifies the market on Polymarket. | ||
| data.market.end_date | string | No | Date and time the market is scheduled to end (ISO 8601). | |||
| data.market.id | string | No | 558934 | Polymarket market id. | ||
| data.market.last_trade_price | number | No | Price of the most recent trade on the market. | |||
| data.market.liquidity | number | No | Liquidity Polymarket reports for the market. | |||
| data.market.outcomes | array | No | Outcomes of the market with their current prices, one item per outcome. OutcomePricePoint record, 10 fields: best_ask, best_bid, last_trade_price, liquidity, market_id, market_slug, outcome, price, question, volume. Described under List Polymarket markets API. | |||
| data.market.question | string | No | Will Spain win the 2026 FIFA World Cup? | Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`. | ||
| data.market.slug | string | No | will-spain-win-the-2026-fifa-world-cup-963 | URL slug of the market. | ||
| data.market.token_ids | array | No | Token ids of the market outcomes, in the same order as `outcomes`. | |||
| data.market.url | string | No | https://polymarket.com/event/world-cup-winner/will-spain-win-the-2026-fifa-world-cup-963 | Link to the market on polymarket.com. | ||
| data.market.volume | number | No | Total trading volume of the market. | |||
| data.market.volume_24h | number | No | Trading volume of the market over the last 24 hours. | |||
| data.slug | string | No | will-spain-win-the-2026-fifa-world-cup-963 | URL slug of the market that was requested. | ||
| data.source_url | string | No | https://gamma-api.polymarket.com/markets/558934 | URL the data was read from. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/polymarket/market/condition/0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327" \
-H "x-api-key: $CRAWLORA_API_KEY"