Markets

List venue events

GET
/venue-events

Authorization

appId
headerx-app-id<token>

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.

search?stringDeprecated

Case-insensitive text matched against the event title.

Match^[^\u0000]*$
matchStatus?array<>|

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

categoryIds?array<string>|

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

status?array<>|

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

sortDir?string

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

Value in"asc""desc"
sortBy?string

volume, volume24hr, createdAt, endDate, or arbReturn.

Value in"volume""volume24hr""createdAt""endDate""arbReturn"
limit?number

Page size, 1 to 100.

Range1 <= value <= 100
cursor?string

Cursor from the previous page.

grouped?string

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

Value in"true""false"
live?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.

Value in"true""false"
minVolume?number
Range0 <= value
aggKey?array<string>|

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

externalIdentifier?array<string>|

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

venue?string

One venue slug. Required when externalIdentifier is set.

Value in"kalshi""polymarket""limitless""predict""pred""tiprun""myriad""hyperliquid""novig""prophetx""betdex""lighter"
recurrence?array<>|

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

Response Body

200

application/json
  1. response
data*array<>

This page of results.

nextCursor*string

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

hasMore*boolean

true when another page exists.

Example Request
curl -X GET 'https://api.t.sufwankhalid.com/venue-events'
Example Response
{  "data": [    {      "id": "string",      "externalIdentifier": "string",      "title": "string",      "description": "string",      "image": "string",      "venue": "kalshi",      "deployerVenue": "string",      "volume": 0,      "status": "open",      "startDate": "string",      "endDate": "string",      "creationDate": "string",      "gameStartTime": "string",      "categories": [        {          "id": "string",          "category": {            "id": "string",            "name": "string",            "displayName": "string",            "parentId": "string",            "eventCount": 0,            "volume24hr": 0,            "volume": 0          }        }      ],      "slug": "string",      "subtitle": "string",      "venues": [        "kalshi"      ],      "marketCount": 0,      "venueCount": 0,      "groupMarketCount": 0,      "groupParentId": "string",      "updatedAt": "string",      "venueMarkets": [        {          "id": "string",          "venue": "kalshi",          "deployerVenue": "string",          "marketId": "string",          "externalIdentifier": "string",          "venueEventId": "string",          "question": "string",          "detailsDeferred": true,          "description": "string",          "rulesPrimary": "string",          "rulesSecondary": "string",          "conditionId": "string",          "volume": 0,          "volume24hr": 0,          "image": "string",          "venueMarketOutcomes": [            {              "id": "string",              "venueMarketId": "string",              "externalIdentifier": "string",              "label": "string",              "title": "string",              "price": 0,              "priceChange24h": 0,              "winner": true,              "payoutPerShare": 0,              "refundAtCost": true,              "winnerSource": "venue",              "matchedVenueMarketOutcomes": [                {                  "venueMarketId": "string",                  "venueMarketOutcomeId": "string"                }              ]            }          ],          "status": "open",          "startDate": "string",          "endDate": "string",          "creationDate": "string",          "createdAt": "string",          "resolutionDate": "string",          "negRisk": true,          "venues": [            "kalshi"          ],          "venueCount": 0,          "arbReturn": 0,          "aggKey": "string",          "sportsMarketType": "string",          "sectionRank": 0,          "period": "string",          "marketCategory": "string",          "marketGroup": "string",          "marketSubtype": "string",          "lineValue": 0,          "minOrderSize": 0,          "tickSize": 0,          "feeRate": 0,          "feeExponent": 0,          "feeBasis": "fill",          "matchedVenueMarkets": [            {              "id": "string",              "venue": "kalshi",              "deployerVenue": "string",              "externalIdentifier": "string",              "question": "string",              "detailsDeferred": true,              "description": "string",              "rulesPrimary": "string",              "rulesSecondary": "string",              "volume": 0,              "volume24hr": 0,              "status": "open",              "conditionId": "string",              "arbReturn": 0,              "shortTitle": "string",              "image": "string",              "venueEvent": {                "id": "string",                "externalIdentifier": "string",                "slug": "string",                "title": "string",                "series": {                  "id": "string",                  "name": "string",                  "venue": "string",                  "externalIdentifier": "string"                }              },              "venueMarketOutcomes": [                {                  "id": "string",                  "venueMarketId": "string",                  "externalIdentifier": "string",                  "label": "string",                  "title": "string",                  "price": 0,                  "winner": true,                  "payoutPerShare": 0,                  "refundAtCost": true,                  "winnerSource": "venue"                }              ]            }          ]        }      ],      "arbReturn": 0,      "series": {        "externalIdentifier": "string"      },      "recurrence": "string",      "aggKey": "string",      "structureType": "candidate",      "sport": "string",      "settlementDiff": {        "sharedSummary": "string",        "differences": [          {            "type": "string",            "title": "string",            "perVenue": {              "property1": "string",              "property2": "string"            },            "summary": "string"          }        ]      },      "settlementDiffStatus": "computed",      "matchedVenueEvents": [        {          "id": "string",          "venue": "kalshi",          "externalIdentifier": "string",          "title": "string",          "slug": "string",          "status": "open",          "series": {            "externalIdentifier": "string"          }        }      ]    }  ],  "nextCursor": "string",  "hasMore": true}