Polymarket API endpoint
Returns one Polymarket event. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
/polymarket/event/id/{id}Path parameters:
id: required Polymarket event id.Notable response behavior:
MarketSummary shape as Polymarket list endpoints.| Field | Filled in, of 60 checked | Values in the sample |
|---|---|---|
| id | 60 | |
| slug | 60 | |
| condition_id | 60 | |
| question | 60 | “Will Spain win the 2026 FIFA World Cup?” and 59 other values |
| url | 60 | polymarket.com |
| active | 60 | true in 50 of 60 |
| closed | 60 | true in 60 of 60 |
| end_date | 60 | 2026-07-20 |
| volume | 60 | 0 to 174,315,688.26, median 77,727,053.21 |
| best_bid | 11 | 0 to 1, median 0 |
| best_ask | 60 | 0 to 1, median 0 |
| last_trade_price | 60 | 0 to 1, median 0 |
| token_ids | 60 | |
| outcomes | 60 | median 2 entries |
| volume_24h | 10 | 0 |
| liquidity | 10 | 0 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Polymarket event id | 30615 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/polymarket/event/id/30615" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "world-cup-winner",
"event": {
"id": "30615",
"slug": "world-cup-winner",
"title": "World Cup Winner",
"markets_count": 64
}
}
}Request schema
No body schema
Response schema
#/definitions/polymarket.eventDetailResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | polymarket.EventDetailResponse | No | ||||
| data.event | object | No | Full details of the event. | |||
| data.event.active | boolean | No | `true` when the event is active. | |||
| data.event.closed | boolean | No | `true` when the event is closed. | |||
| data.event.comment_count | integer | No | Number of comments on the event. | |||
| data.event.description | string | No | Event description as shown on Polymarket. | |||
| data.event.end_date | string | No | Date and time the event is scheduled to end (ISO 8601). | |||
| data.event.featured | boolean | No | `true` when Polymarket features the event. | |||
| data.event.icon_url | string | No | URL of the event's icon image. | |||
| data.event.id | string | No | 545095 | Polymarket event id. | ||
| data.event.image_url | string | No | URL of the event's main image. | |||
| data.event.liquidity | number | No | Liquidity Polymarket reports for the event. | |||
| data.event.markets | array | No | Markets inside the event, one item per market. MarketSummary record, 26 fields: active, best_ask, best_bid, closed, condition_id, end_date, id, last_trade_price, liquidity, outcomes, question, slug and 4 more. Described under List Polymarket markets API. | |||
| data.event.markets_count | integer | No | 15 | Number of markets inside the event. | ||
| data.event.open_interest | number | No | Open interest Polymarket reports for the event. | |||
| data.event.restricted | boolean | No | `true` when Polymarket marks the event as restricted. | |||
| data.event.slug | string | No | bitcoin-above-on-june-7-2026 | URL slug of the event. | ||
| data.event.start_date | string | No | Date and time the event starts (ISO 8601). | |||
| data.event.tags | array | No | Tags attached to the event, one item per tag. | |||
| data.event.tags[].id | string | No | 21 | Polymarket tag id. | ||
| data.event.tags[].label | string | No | Crypto | Display name of the tag, for example `Crypto`. | ||
| data.event.tags[].slug | string | No | crypto | URL slug of the tag, for example `crypto`. | ||
| data.event.title | string | No | Bitcoin above ___ on June 7? | Event title as shown on Polymarket. | ||
| data.event.updated_at | string | No | Time Polymarket last updated the event (ISO 8601). | |||
| data.event.url | string | No | https://polymarket.com/event/bitcoin-above-on-june-7-2026 | Link to the event on polymarket.com. | ||
| data.event.volume | number | No | Total trading volume of the event. | |||
| data.event.volume_24h | number | No | Trading volume of the event over the last 24 hours. | |||
| data.fetched_at | string | No | 2026-06-07T11:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.slug | string | No | world-cup-winner | URL slug of the event that was requested. | ||
| data.source_url | string | No | https://gamma-api.polymarket.com/events/slug/world-cup-winner | 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/event/id/30615" \
-H "x-api-key: $CRAWLORA_API_KEY"