Polymarket API endpoint
Finds Polymarket events similar to a given one. Supply at least one of `id`, `event_title`, `event_slug`, `market_title` or `market_slug`; `limit` defaults to 10 (max 50) and `closed` (`true` or `false`) filters by closed state. Each event has its title, dates, volume, liquidity, tags and nested markets.
/polymarket/events/similarReturns similar events from Polymarket.
Path parameters:
Query parameters:
id, event_title, event_slug, market_title, or market_slug is required.limit: optional integer. Default: 10; maximum: 50.closed: optional enum. Allowed values: true, false.Notable response behavior:
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| slug | 10 | |
| title | 10 | “Manacor (Doubles): Butvilas/Kasnikowski vs Fancutt/Watanabe” and 9 other values |
| description | 10 | median 1,047 characters |
| url | 10 | polymarket.com |
| image_url | 10 | polymarket-upload.s3.us-east-2.amazonaws.com |
| icon_url | 10 | polymarket-upload.s3.us-east-2.amazonaws.com |
| active | 10 | true in 10 of 10 |
| closed | 10 | true in 9 of 10 |
| restricted | 10 | true in 10 of 10 |
| start_date | 10 | 2026-05-15 to 2026-10-11 |
| end_date | 10 | 2026-05-23 to 2026-10-20 |
| updated_at | 10 | 2026-06-12 to 2026-10-13 |
| volume | 9 | 30 to 57,159.29, median 176.49 |
| open_interest | 9 | 15.92 to 24,129.27, median 87 |
| tags | 10 | median 3 entries |
| markets_count | 10 | 0 |
| liquidity | 1 | 0.4 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | integer | No | Polymarket event id | 30615 | |
| event_title | string | No | Event title | World Cup Winner | |
| event_slug | string | No | Event slug | world-cup-winner | |
| market_title | string | No | Market title | Will Spain win the 2026 FIFA World Cup? | |
| market_slug | string | No | Market slug | will-spain-win-the-2026-fifa-world-cup-963 | |
| limit | integer | No | 10 and supports up to 50 | Maximum events, defaults to 10 and supports up to 50 | 10 |
| closed | string | No | Closed filter Allowed values: true, false. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/polymarket/events/similar?limit=10&closed=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://gamma-api.polymarket.com/...",
"fetched_at": "2026-06-07T11:00:00Z",
"events": []
}
}Request schema
No body schema
Response schema
#/definitions/polymarket.similarEventsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | polymarket.SimilarEventsResponse | No | ||||
| data.events | array | No | EventSummary record, 51 fields: active, closed, comment_count, description, end_date, featured, icon_url, id, image_url, liquidity, markets, markets_count and 10 more. Described under List Polymarket events API. | |||
| data.fetched_at | string | No | 2026-06-07T11:00:00Z | |||
| data.limit | integer | No | 10 | |||
| data.source_url | string | No | https://gamma-api.polymarket.com/events/similar?event_slug=world-cup-winner | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/events/similar?limit=10&closed=true" \
-H "x-api-key: $CRAWLORA_API_KEY"