Skip to main content
GET
Get Polymarket Events
List Polymarket events — the topic-level grouping that bundles related markets, such as an election or a season-long series. Use this to browse by subject rather than by individual question, or to find every market attached to one storyline; filter with tag_slug, active, featured, archived, closed, and the liquidity / volume ranges. Returns a top-level array of event objects with title, ticker, slug, volume, volume24hr, liquidity, startDate / endDate, and a nested markets array holding the tradable questions. When you already know which question you want and need its price, use get_polymarket_markets instead.

Authorizations

Authorization
string
header
required

Your AIsa API key as a Bearer token.

Query Parameters

limit
integer

Maximum number of events to return.

Required range: x >= 0
Example:

20

offset
integer

Number of events to skip for offset-based pagination.

Required range: x >= 0
Example:

0

order
string

Comma-separated list of fields to order by.

Example:

"volume"

ascending
boolean

Sort ascending when true.

Example:

false

id
integer[]

Filter by one or more event IDs.

slug
string[]

Filter by one or more event slugs.

tag_id
integer

Filter by tag ID.

tag_slug
string

Filter by tag slug.

Example:

"sports"

active
boolean

Filter by active events.

archived
boolean

Filter by archived events.

Filter by featured events.

closed
boolean

Filter by whether the event is closed.

liquidity_min
number

Minimum liquidity.

liquidity_max
number

Maximum liquidity.

volume_min
number

Minimum volume.

volume_max
number

Maximum volume.

start_date_min
string<date-time>

Filter events starting after this ISO timestamp.

start_date_max
string<date-time>

Filter events starting before this ISO timestamp.

end_date_min
string<date-time>

Filter events ending after this ISO timestamp.

end_date_max
string<date-time>

Filter events ending before this ISO timestamp.

Response

Top-level array of Polymarket event objects

id
string
ticker
string
slug
string
title
string
description
string
active
boolean
closed
boolean
archived
boolean
startDate
string<date-time>
endDate
string<date-time>
volume
string
volume24hr
number
liquidity
number
image
string
icon
string
markets
object[]