Skip to main content
GET
List venue events

Integration guide

Authorizations

x-app-id
string
header
required

Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.

Query Parameters

venues
string

Comma-separated venue slugs, for example polymarket,kalshi. Repeat the parameter to pass several. An empty value is ignored.

Case-insensitive text matched against the event title. Deprecated: use GET /search?type=events for text search. Case-insensitive title substring match, limited to events the search index matches by word or typed prefix. Must not contain null characters.

Pattern: ^[^\u0000]*$
matchStatus

Match-review status. Repeat the parameter to pass several.

Available options:
pending,
unmatched,
review,
matched,
verified,
rejected
categoryIds

Category ids. Repeat the parameter or send a comma-separated list.

status

Market status: open, closed, resolved, unopened, or paused. Repeat to pass several.

Available options:
open,
closed,
resolved,
unopened,
paused
sortDir
enum<string>

asc or desc. Defaults to asc when sortBy is endDate.

Available options:
asc,
desc
sortBy
enum<string>

volume, volume24hr, createdAt, endDate, or arbReturn.

Available options:
volume,
volume24hr,
createdAt,
endDate,
arbReturn
limit
number

Page size, 1 to 100.

Required range: 1 <= x <= 100
cursor
string

Cursor from the previous page.

grouped
enum<string>

true folds same-venue companion events into one tile per game. Absent leaves events ungrouped.

Available options:
true,
false
live
enum<string>

true returns only sports events in play: open, with a sport, and a gameStartTime within the last 6 hours. Venues send no end-of-game signal, so 6 hours after the start is the cutoff: it covers most matches, but long games such as cricket, golf rounds or long tennis matches drop out before they end. Pass the ids to GET /sports/live for scores.

Available options:
true,
false
minVolume
number
Required range: x >= 0
aggKey

Exact cross-venue key. Repeat the parameter to pass several. Optional filter, not the join key.

externalIdentifier

The venue's own event key. Requires venue. Returns that member, not the cluster anchor. At most 20.

Maximum array length: 20
venue
enum<string>

One venue slug. Required when externalIdentifier is set.

Available options:
kalshi,
polymarket,
limitless,
predict,
pred,
tiprun,
myriad,
hyperliquid,
novig,
prophetx,
betdex,
lighter
recurrence

Cadence filter: PT5M, PT10M, PT15M, PT30M, PT1H, PT4H, P1D, P1W, P1M, P1Y, or null. Repeat the parameter to pass several.

Available options:
PT5M,
PT10M,
PT15M,
PT30M,
PT1H,
PT4H,
P1D,
P1W,
P1M,
P1Y,
null

Response

200

data
object[]
required

This page of results.

nextCursor
string | null
required

Pass as cursor to fetch the next page; null on the last page.

hasMore
boolean
required

true when another page exists.