Skip to main content
GET
/
markets
List Markets
curl --request GET \
  --url https://api.totalis.trade/markets \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "events": [
      {
        "event_ticker": "<string>",
        "series_ticker": "<string>",
        "category": "<string>",
        "total_markets": 123,
        "markets": [
          {
            "ticker": "<string>",
            "event_ticker": "<string>",
            "series_ticker": "<string>",
            "title": "<string>",
            "subtitle": "<string>",
            "yes_sub_title": "<string>",
            "no_sub_title": "<string>",
            "bet_group": "<string>",
            "category": "<string>",
            "subcategory": "<string>",
            "frequency": "<string>",
            "status": "<string>",
            "yes_bid": 123,
            "yes_ask": 123,
            "no_bid": 123,
            "no_ask": 123,
            "last_price": 123,
            "price_to_beat": 123,
            "volume": 123,
            "volume_24h": 123,
            "open_interest": 123,
            "venue_url": "<string>",
            "open_time": "2023-11-07T05:31:56Z",
            "close_time": "2023-11-07T05:31:56Z",
            "expiration_time": "2023-11-07T05:31:56Z",
            "exclusion_keys": [
              "<string>"
            ]
          }
        ],
        "series_title": "<string>",
        "event_title": "<string>",
        "event_sub_title": "<string>",
        "image_url": "<string>"
      }
    ]
  },
  "meta": {
    "cursor": "<string>",
    "has_more": true,
    "total_events": 123,
    "available_subcategories": [],
    "available_frequencies": []
  }
}
Building parlays? Every market in the response carries an exclusion_keys array. Two markets cannot be combined in the same parlay if (and only if) their exclusion_keys intersect — apply a pure set-intersection, with no correlation rule tables to maintain client-side. The keys encode every rule (cross-series groups, threshold ladders, same-game sports correlation, Polymarket sub-events). See the exclusion_keys field in the response schema below.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
category
enum<string>

Filter by category. Pass all to disable the default category filter.

Available options:
politics,
sports,
crypto,
finance,
economics,
entertainment,
weather,
tech,
all
​
venue
enum<string>

Filter by venue. Omit to include all venues. Source venue for a market.

Available options:
kalshi,
polymarket
​
subcategory
enum<string>

Filter events by subcategory. Valid values depend on the selected category (requires category to also be set). Subcategory wire format (lowercase snake_case). Valid values depend on the selected category and are enforced server-side.

Available options:
nba,
ncaa,
nfl,
nhl,
mlb,
ufc,
lol,
epl,
efl,
la_liga,
world_cup,
bundesliga,
liga_portugal,
ligue_1,
f1,
ipl,
btc,
eth,
sol,
stocks,
indices,
etfs,
earnings,
rates,
inflation,
commodities,
fx,
jobs,
ai,
companies,
other
​
frequency
enum<string>

Filter events by the cadence of the underlying series. other is intentionally rejected — it's a residual response bucket, not a filter target.

Available options:
daily,
weekly,
monthly,
hourly
​
date_filter
enum<string>

Time bucket filter. If omitted, a default 7-day horizon is applied. Pass all to retrieve all active markets regardless of close date.

Available options:
1h,
1h-1d,
1d-7d,
today,
this_week,
this_month,
all
​
search
string

Full-text search across event/market titles.

​
cursor
string

Opaque pagination cursor from a previous response's meta.cursor. Do not construct manually.

​
limit
integer
default:21

Events per page. Default 21, max 100. The product limit × markets_per_event must not exceed 2000.

Required range: 1 <= x <= 100
​
markets_per_event
integer
default:10

Max markets returned per event group. Default 10, max 50.

Required range: 1 <= x <= 50

Response

Events grouped by event_ticker, plus subcategory/frequency facets for the current result set

​
data
object
​
meta
object