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.
- 型: integerlimit最小値:0
Maximum number of events to return.
- 型: integeroffset最小値:0
Number of events to skip for offset-based pagination.
- 型: stringorder
Comma-separated list of fields to order by.
- 型: booleanascending
Sort ascending when true.
- 型: array integer[]id
Filter by one or more event IDs.
- 型: array string[]slug
Filter by one or more event slugs.
- 型: integertag
_id Filter by tag ID.
- 型: stringtag
_slug Filter by tag slug.
- 型: booleanactive
Filter by active events.
- 型: booleanarchived
Filter by archived events.
- 型: booleanfeatured
Filter by featured events.
- 型: booleanclosed
Filter by whether the event is closed.
- 型: numberliquidity
_min Minimum liquidity.
- 型: numberliquidity
_max Maximum liquidity.
- 型: numbervolume
_min Minimum volume.
- 型: numbervolume
_max Maximum volume.
- 型: string 形式: date-timestart
_date _min Filter events starting after this ISO timestamp.
- 型: string 形式: date-timestart
_date _max Filter events starting before this ISO timestamp.
- 型: string 形式: date-timeend
_date _min Filter events ending after this ISO timestamp.
- 型: string 形式: date-timeend
_date _max Filter events ending before this ISO timestamp.
- 型: array object[]200
Top-level array of Polymarket event objects
- active型: boolean
- archived型: boolean
- closed型: boolean
- description型: string
- end型: string 形式: date-time
Date the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- icon型: string
- id型: string
- image型: string
- liquidity型: number
- markets型: array object[]
- property型: anything
Name
- slug型: string
- start型: string 形式: date-time
Date the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- ticker型: string
- title型: string
- volume型: string
- volume24hr型: number
- property型: anything
Name
application/json - 型: object400
Bad Request - Invalid parameters
- 型: stringerror
- 型: 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.
- 型: object500
Internal Server Error
- 型: stringerror
- 型: 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"
}
]