Polymarket
Prediction-market discovery and market data.
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.
- Type: integerlimitmin:0
Maximum number of events to return.
- Type: integeroffsetmin:0
Number of events to skip for offset-based pagination.
- Type: stringorder
Comma-separated list of fields to order by.
- Type: booleanascending
Sort ascending when true.
- Type: array integer[]id
Filter by one or more event IDs.
- Type: array string[]slug
Filter by one or more event slugs.
- Type: integertag
_id Filter by tag ID.
- Type: stringtag
_slug Filter by tag slug.
- Type: booleanactive
Filter by active events.
- Type: booleanarchived
Filter by archived events.
- Type: booleanfeatured
Filter by featured events.
- Type: booleanclosed
Filter by whether the event is closed.
- Type: numberliquidity
_min Minimum liquidity.
- Type: numberliquidity
_max Maximum liquidity.
- Type: numbervolume
_min Minimum volume.
- Type: numbervolume
_max Maximum volume.
- Type: string Format: date-timestart
_date _min Filter events starting after this ISO timestamp.
- Type: string Format: date-timestart
_date _max Filter events starting before this ISO timestamp.
- Type: string Format: date-timeend
_date _min Filter events ending after this ISO timestamp.
- Type: string Format: date-timeend
_date _max Filter events ending before this ISO timestamp.
- Type: array object[]200
Top-level array of Polymarket event objects
- activeType: boolean
- archivedType: boolean
- closedType: boolean
- descriptionType: string
- endType: string Format: date-time
Date the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- iconType: string
- idType: string
- imageType: string
- liquidityType: number
- marketsType: array object[]
- propertyType: anything
Name
- slugType: string
- startType: string Format: date-time
Date the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- tickerType: string
- titleType: string
- volumeType: string
- volume24hrType: number
- propertyType: anything
Name
application/json - Type: object400
Bad Request - Invalid parameters
- Type: stringerror
- Type: stringmessage
application/json - 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- Type: object500
Internal Server Error
- Type: stringerror
- Type: stringmessage
application/json - 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl https://openapi.felo.ai/v1/beta/polymarket/events \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
{
"id": "string",
"ticker": "string",
"slug": "string",
"title": "string",
"description": "string",
"active": true,
"closed": true,
"archived": true,
"startDate": "2026-09-30T03:09:45.799Z",
"endDate": "2026-09-30T03:09:45.799Z",
"volume": "string",
"volume24hr": 1,
"liquidity": 1,
"image": "string",
"icon": "string",
"markets": [
{
"additionalProperty": "anything"
}
],
"additionalProperty": "anything"
}
]