TOtotalistrading
Markets

List Markets

Changed on

List active markets grouped by event across supported venues (Kalshi and Polymarket). Filters: category, venue, subcategory (validated against the selected category), frequency (daily/weekly/monthly/hourly), date_filter (time bucket), and search. Pagination is cursor-based at the event level. The response includes available_subcategories and available_frequencies so clients can drive filter chips from the same result set.

get/markets

Request

Query parameters

category'politics' | 'sports' | 'crypto' | 'finance' | 'economics' | 'entertainment' | 'weather' | 'tech' | 'all'

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

venue'kalshi' | 'polymarket'

Source venue for a market.

Filter by venue. Omit to include all venues.

subcategory'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'

Subcategory wire format (lowercase snake_case). Valid values depend on the selected category and are enforced server-side.

Filter events by subcategory. Valid values depend on the selected category (requires category to also be set).

frequency'daily' | 'weekly' | 'monthly' | 'hourly'

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

date_filter'1h' | '1h-1d' | '1d-7d' | 'today' | 'this_week' | 'this_month' | 'all'

Time bucket filter. If omitted, no date filter applies, the same as passing all.

searchstring

Full-text search across event/market titles.

cursorstring

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

limitinteger

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

markets_per_eventinteger

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

Response

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

Changes

  • 822d557efc12Revision changes
    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

  • 5a003bd664f9Revision changes
    • info

      added the optional property ///// to the response with the status