List events
Public keyset-paginated list of markets. Defaults to live (not-ended) markets ordered by endDate ASC, id ASC. The cursor is opaque; pass it back verbatim to fetch the next page.
/v1/eventsQuery Parameters
Sort key. endDate/startDate sort ASC, volume/liquidity DESC; id ASC is the tiebreak. Defaults to endDate.
Value in
- "endDate"
- "startDate"
- "volume"
- "liquidity"
Upper bound (0..1): every current outcome price must be <= this.
Lower bound (0..1): every current outcome price must be >= this.
Minimum volumeUsd (>= bound).
Minimum liquidityUsd (>= bound).
1 returns only resolved markets; 0 only unresolved. Omit for both.
Value in
- 0
- 1
Case-insensitive substring match across question and description.
Filter to markets carrying this tag id at admission.
Filter by event source, e.g. polymarket.
0 (default) returns live markets only; 1 also includes ended markets.
Value in
- 0
- 1
Opaque pagination cursor from a prior response's nextCursor. Pass verbatim.
Page size, 1..200. Defaults to 50.
Response Body
application/json
curl -X GET "https://example.com/v1/events"{ "items": [ { "id": "string", "source": "polymarket", "sourceMarketId": "string", "question": "string", "description": "string", "outcomes": [ { "outcomeId": "string", "name": "string" } ], "endDate": "2019-08-24T14:15:22Z", "startDate": "2019-08-24T14:15:22Z", "tagsAtAdmission": [ 0 ], "liquidityUsd": 0, "volumeUsd": 0, "volumeRecentUsd": 0, "currentLiquidityUsd": 0, "currentVolumeUsd": 0, "currentOutcomePrices": { "property1": 0, "property2": 0 }, "admittedAt": "2019-08-24T14:15:22Z", "lastSeenAt": "2019-08-24T14:15:22Z", "resolution": { "resolvedAt": "2019-08-24T14:15:22Z", "resolutionStatus": "unresolved", "winningOutcomeId": "string", "winningOutcomeName": "string", "finalOutcomePrices": { "property1": 0, "property2": 0 } } } ], "nextCursor": "string"}