Markets

List venue markets

GET
/venue-markets

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

venue?string

One venue slug. With venueEventId, keeps the cluster but narrows to this venue.

Value in"kalshi""polymarket""limitless""predict""pred""tiprun""myriad""hyperliquid""novig""prophetx""betdex""lighter"
venueEventId?string

Event id. By default the page covers that event's whole matched cluster. Any member id returns the same page.

cluster?string

true (default) returns the matched cluster. false returns only that venue event. Ignored when venueEventId is absent. Only the strings "true" and "false" are accepted.

Value in"true""false"
matchStatus?array<>|

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

status?array<>|

Market status. Repeat the parameter to pass several.

search?stringDeprecated

Text matched against the market question.

createdAtFrom?string

ISO-8601 lower bound on creation time.

createdAtTo?string

ISO-8601 upper bound on creation time.

minVolume?number
Range0 <= value
limit?number

Page size, 1 to 100.

Range1 <= value <= 100
cursor?string

Cursor from the previous page.

sortDir?string

asc or desc.

Value in"asc""desc"
sortBy?string

volume, volume24hr, createdAt, or updatedAt. createdAt requires venueEventId, or externalIdentifier with venue.

Value in"volume""volume24hr""createdAt""updatedAt"
context?string

list collapses axis and date events to volume order. detail, or omitted, keeps structured order.

Value in"list""detail"
projection?string
Value in"summary""full"
aggKey?array<string>|

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

sportsMarketType?array<string>|

Normalized sports market type. Repeat the parameter to pass several.

period?array<string>|

Game segment: full, 1h, 2h, q1 through q4, or ot. Repeat the parameter to pass several.

marketCategory?array<string>|

Normalized subject category for prop tabs. Repeat the parameter to pass several.

marketGroup?array<string>|

Section key for sports markets, such as player_props or totals.

externalIdentifier?array<string>|

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

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-markets'
Example Response
{  "data": [    {      "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"            }          ]        }      ],      "venueEvent": {        "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}