Skip to main content
GET
/
events
cURL
curl --request GET \
  --url http://localhost:10112/events
[
  {
    "id": "",
    "slug": null,
    "title": null,
    "ticker": null,
    "description": null,
    "resolution_source": null,
    "category": null,
    "image_url": null,
    "active": true,
    "closed": false,
    "archived": false,
    "new": false,
    "featured": false,
    "restricted": false,
    "live": false,
    "ended": false,
    "market_count": 0,
    "start_date": null,
    "end_date": null,
    "creation_date": null,
    "published_at": null,
    "neg_risk": false,
    "neg_risk_market_id": null,
    "event_week": null,
    "score": null,
    "elapsed": null,
    "period": null,
    "game_status": null,
    "metrics": {},
    "tags": [],
    "markets": [],
    "series": "<unknown>",
    "show_market_images": false,
    "automatically_resolved": false
  }
]

Query Parameters

​
id
string

Get single event by ID

​
slug
string

Get single event by slug

​
event_slug
string

Alias for slug

​
condition_id
string

Get event by condition ID

​
condition_ids
string

Get event by condition IDs (comma-separated)

​
markets
string

Get event by market slugs (comma-separated)

​
active
boolean

Only active/non-ended events (default: true)

​
featured
boolean

Only featured events (mode=featured)

​
tag_id
string

Filter by tag ID

​
series_id
string

Filter by series ID

​
search
string

Search query (min 3 chars)

​
sort_by
string

Sort: volume, txns, market_count, creation_date, end_date

​
sort_dir
string

Sort direction: asc, desc

​
timeframe
string

Metrics timeframe: 1m, 5m, 30m, 1h, 6h, 24h

​
status
string

Event status: active, resolved, ended, archived

​
categories
string

Comma-separated category filters

​
exclude_categories
string

Comma-separated categories to exclude

​
tags
string

Comma-separated tag slugs to filter

​
exclude_tags
string

Comma-separated tag slugs to exclude

​
min_volume
number<double>

Minimum volume in selected timeframe

​
max_volume
number<double>

Maximum volume in selected timeframe

​
min_txns
integer<int32>

Minimum transactions in selected timeframe

​
max_txns
integer<int32>

Maximum transactions in selected timeframe

​
include_tags
boolean

Include tags array (default: true)

​
include_markets
boolean

Include markets array with outcomes (default: true)

​
limit
integer<int32>

Results limit (default: 50)

​
offset
integer<int32>

Pagination offset

Response

200 - application/json

List of Polymarket events with nested tags, markets, and series

​
id
string
default:""
​
slug
string | null
​
title
string | null
​
ticker
string | null
​
description
string | null
​
resolution_source
string | null
​
category
string | null
​
image_url
string | null
​
active
boolean
default:true
​
closed
boolean
default:false
​
archived
boolean
default:false
​
new
boolean
default:false
​
featured
boolean
default:false
​
restricted
boolean
default:false
​
live
boolean
default:false
​
ended
boolean
default:false
​
market_count
integer<int32>
default:0
​
start_date
integer<int64> | null
​
end_date
integer<int64> | null
​
creation_date
integer<int64> | null
​
published_at
string<date-time> | null
​
neg_risk
boolean
default:false
​
neg_risk_market_id
string | null
​
event_week
integer<int32> | null
​
score
string | null
​
elapsed
string | null
​
period
string | null
​
game_status
string | null
​
metrics
object
​
tags
object[]
​
markets
object[]
​
series
object

A Polymarket series from the Gamma API Series are parent groupings above events (e.g., "NBA Season 2024-25")

​
show_market_images
boolean
default:false
​
automatically_resolved
boolean
default:false
Last modified on February 19, 2026