Kalshi

App · 16 actions

Follow Kalshi, the US-regulated exchange for event contracts: browse series, events and markets, read each market's chance, order book, trades and price history, check trading hours, and follow the games markets settle on with live scores. Read-only; no account needed.

Actions

ActionWhat it does
Get eventGet one event with its markets (each with its chance, bid, ask, volume and closing time), its settlement sources and its picture.
Get exchange statusCheck whether Kalshi is up and open for trading right now, part by part, and when it should be back during maintenance.
Get live game dataGet the live state of a game Kalshi follows: its status, score, period, clock, winner and last play, plus the sport's own details.
Get marketGet one market: its chance in percent, Yes and No bids and asks, last price and daily move, volume, open interest, times, rules and, once settled, the result.
Get order bookGet a market's resting Yes and No bids, best first, with the best Yes bid and ask, the midpoint and the spread.
Get price historyGet a market's candlesticks (open, high, low and close of the Yes price, with volume and open interest) by the minute, hour or day over a window, plus the move, high and low across it.
Get seriesGet one series: its title, category, tags, how often it recurs, its fees, settlement sources, contract terms and the volume traded.
Get trading hoursGet Kalshi's weekly trading hours (in Eastern Time) with the stretches each day it is closed, and any scheduled maintenance.
List combo collectionsList Kalshi's combo collections: the sets of events you can combine into one multi-leg market (a parlay), with how many legs a combo takes and which events it draws on.
List eventsList events (one occurrence of a question, holding one or more markets) by status, series and closing time, each with its leading markets and their chances.
List marketsList markets (one yes/no contract each) by event, series, tickers, status and closing time, with their chances, bids, asks and volume.
List milestonesList milestones: the games, matches, races and elections Kalshi's markets settle on, with when they start and which events they decide.
List people and teamsList the people, teams and other subjects Kalshi's markets are about (its 'structured targets'): players, teams, actors, films and more, each with its own facts such as league and position.
List reward programsList Kalshi's reward programs for keeping orders in a market's book or for trading in it: which market, when, the reward in dollars and the order size asked for.
List seriesList the series (recurring questions, such as each Fed decision or daily temperature) in a category or with a tag, most traded first, with their frequency, fees and settlement sources.
List tradesList recent trades, newest first, on one market or across Kalshi: the side taken, Yes and No prices, contracts and dollars.

Get event

Get one event with its markets (each with its chance, bid, ask, volume and closing time), its settlement sources and its picture.

Inputs

Event tickerevent_tickertextRequired
The event's ticker, e.g. KXFEDDECISION-26OCT, or its kalshi.com link.
Most marketsmax_marketsnumber
How many of the event's markets to include, the leading ones first, 1 to 500. Defaults to 100.From 1 to 500.

Outputs

categorytext
The event's category, e.g. 'Economics'.
competitiontext
The competition or programme, e.g. 'US FED' or 'NFL'.
competition_scopetext
What the competition is about, e.g. 'Fed Decision'.
event_tickertext
The event's ticker, e.g. KXFEDDECISION-26OCT.
image_urltext
The event's picture.
market_countnumber
How many markets the event holds in all.
marketslist
The event's markets, the leading ones first: open before closed, the likeliest first when only one can win (else the most traded). Up to the number asked for.
mutually_exclusivetrue/false
True when at most one of its markets can resolve Yes.
series_tickertext
The ticker of the recurring series it belongs to.
settlement_sourceslist
Where the results are taken from.
strike_datetext
The date the event is about, when it has one (ISO 8601, UTC).
strike_periodtext
The period the event covers, when it has one, e.g. 'week'.
subtitletext
A short line under the title, e.g. 'On Oct 28, 2026'.
summarytext
One line with the title and who leads, e.g. 'Fed decision in Oct 2026? Fed maintains rate leads at 85% (5 markets).'
titletext
The event's title.
Example output
{
  "category": "Economics",
  "competition": "US FED",
  "competition_scope": "Fed Decision",
  "event_ticker": "KXFEDDECISION-26OCT",
  "image_url": "https://assets.kalshi.com/series-images-webp/KXFEDDECISION.webp",
  "market_count": 5,
  "markets": [
    {
      "close_time": "2026-10-28T17:59:00Z",
      "label": "Fed maintains rate",
      "last_price": 0.85,
      "open_interest": 1908615.21,
      "probability_percent": 85.0,
      "result": null,
      "status": "open",
      "ticker": "KXFEDDECISION-26OCT-H0",
      "volume_24h": 110498.64,
      "yes_ask": 0.86,
      "yes_bid": 0.85
    }
  ],
  "mutually_exclusive": true,
  "series_ticker": "KXFEDDECISION",
  "settlement_sources": [
    {
      "name": "Federal Reserve",
      "url": "https://www.federalreserve.gov"
    }
  ],
  "strike_date": "2026-10-28T18:00:00Z",
  "strike_period": null,
  "subtitle": "On Oct 28, 2026",
  "summary": "Fed decision in Oct 2026? Fed maintains rate leads at 85% (5 markets).",
  "title": "Fed decision in Oct 2026?"
}

Get exchange status

Check whether Kalshi is up and open for trading right now, part by part, and when it should be back during maintenance.

Inputs

None.

Outputs

estimated_resume_timetext
During maintenance, when it should end (ISO 8601, UTC).
exchange_activetrue/false
False while the exchange is down for maintenance.
shardslist
Each part of the exchange.
summarytext
One line saying what came back.
trading_activetrue/false
True while trading is allowed.
transfers_activetrue/false
True while moving money between accounts is allowed.
Example output
{
  "estimated_resume_time": null,
  "exchange_active": true,
  "shards": [
    {
      "exchange_active": true,
      "name": "Default",
      "trading_active": true
    }
  ],
  "summary": "Kalshi is open for trading.",
  "trading_active": true,
  "transfers_active": true
}

Get live game data

Get the live state of a game Kalshi follows: its status, score, period, clock, winner and last play, plus the sport's own details.

Inputs

Milestone IDmilestone_idtextRequired
The game's milestone id, from 'List milestones'.

Outputs

away_pointsnumber
The away side's score, counted the same way.
clocktext
The game clock, when the sport has one.
detailsobject
The sport's own live fields (timeouts left, possession, under review...), which vary by sport.
event_tickerslist
The events whose outcome the game decides.
home_pointsnumber
The home side's score: points, goals or, in tennis, sets.
last_playtext
The most recent play, in words.
milestone_idtext
The milestone's id.
periodtext
The quarter, period, inning, half, set or round being played.
statustext
The game's status, e.g. 'scheduled', 'inprogress' or 'closed'.
summarytext
One line saying what came back.
titletext
What the milestone is, e.g. 'WAS Commanders at SF 49ers'.
typetext
The kind, e.g. football_game.
updated_attext
When the live data last changed (ISO 8601, UTC).
winnertext
The winner, once decided.
Example output
{
  "away_points": 3.0,
  "clock": "4:03",
  "details": {
    "home_timeouts_remaining": 2,
    "is_under_review": false
  },
  "event_tickers": [
    "KXNFLGAME-26OCT19WASSF"
  ],
  "home_points": 13.0,
  "last_play": "E.Pineiro kicks off from SF 35 to the WAS 3.",
  "milestone_id": "794d4c92-b7cd-4f5e-ae33-0c5c9028be62",
  "period": "1",
  "status": "inprogress",
  "summary": "WAS Commanders at SF 49ers: in progress, 3-13 (away-home), quarter 1, 4:03 on the clock.",
  "title": "WAS Commanders at SF 49ers",
  "type": "football_game",
  "updated_at": "2026-10-20T00:45:13Z",
  "winner": null
}

Get market

Get one market: its chance in percent, Yes and No bids and asks, last price and daily move, volume, open interest, times, rules and, once settled, the result. Settled markets are read from Kalshi's archive too.

Inputs

Market tickertickertextRequired
The market's ticker, e.g. KXFEDDECISION-26OCT-H0, from 'Get event' or 'List markets'.

Outputs

archivedtrue/false
True when the market has moved to Kalshi's archive (settled before its cutoff), which is where it was read from.
can_close_earlytrue/false
True when trading can stop early if the event happens.
close_timetext
When trading closes (ISO 8601, UTC).
event_tickertext
The ticker of the event the market belongs to.
expected_expiration_timetext
When the result is expected (ISO 8601, UTC).
expiration_valuetext
The figure or outcome the market was settled on.
last_pricenumber
The price, in dollars, of the most recent Yes trade.
market_typetext
'binary' (pays $1 or nothing) or 'scalar' (pays in between).
more_rulestext
The finer print of the rules.
no_asknumber
The lowest price, in dollars, a seller is asking for No.
no_bidnumber
The highest price, in dollars, a buyer is bidding for No.
no_labeltext
What No means on this market.
open_interestnumber
Contracts currently held.
open_timetext
When trading opened (ISO 8601, UTC).
price_change_24h_pointsnumber
How far the last price moved in the last day, in percentage points.
probability_percentnumber
The chance of Yes, in percent: 100 or 0 once settled, else the last trade price (or, before any trade, halfway between the best Yes bid and ask). A contract pays $1, so $0.85 is an 85% chance.
resulttext
Once settled, 'yes' or 'no' (or 'scalar'); empty before.
rulestext
The main rule: exactly what makes the market resolve Yes.
settled_attext
When the market settled, once it has (ISO 8601, UTC).
settlement_valuenumber
What a Yes contract paid out, in dollars, once settled.
statustext
Where the market is in its life: 'not open yet', 'open', 'paused', 'closed' (trading over, awaiting the result), 'determined', 'disputed' or 'settled'.
summarytext
One line with the question and its chance, e.g. '... Yes 85% (bid $0.85, ask $0.86).'
tickertext
The market's ticker, e.g. KXFEDDECISION-26OCT-H0.
titletext
The market's question.
volumenumber
Contracts traded in all.
volume_24hnumber
Contracts traded in the last 24 hours.
yes_asknumber
The lowest price, in dollars, a seller is asking for Yes.
yes_bidnumber
The highest price, in dollars, a buyer is bidding for Yes.
yes_labeltext
What Yes means on this market, e.g. 'Fed maintains rate'.
Example output
{
  "archived": false,
  "can_close_early": true,
  "close_time": "2026-10-28T17:59:00Z",
  "event_ticker": "KXFEDDECISION-26OCT",
  "expected_expiration_time": "2026-10-28T18:05:00Z",
  "expiration_value": null,
  "last_price": 0.85,
  "market_type": "binary",
  "more_rules": "The outcomes are mutually exclusive: at most one can resolve to Yes.",
  "no_ask": 0.15,
  "no_bid": 0.14,
  "no_label": "Fed maintains rate",
  "open_interest": 1908615.21,
  "open_time": "2025-09-29T14:00:00Z",
  "price_change_24h_points": -2.0,
  "probability_percent": 85.0,
  "result": null,
  "rules": "If the Federal Reserve does a Hike of 0bps on October 28, 2026, then the market resolves to Yes.",
  "settled_at": null,
  "settlement_value": null,
  "status": "open",
  "summary": "Will the Federal Reserve Hike rates by 0bps at their October 2026 meeting? Yes 85% (bid $0.85, ask $0.86).",
  "ticker": "KXFEDDECISION-26OCT-H0",
  "title": "Will the Federal Reserve Hike rates by 0bps at their October 2026 meeting?",
  "volume": 5795506.73,
  "volume_24h": 110498.64,
  "yes_ask": 0.86,
  "yes_bid": 0.85,
  "yes_label": "Fed maintains rate"
}

Get order book

Get a market's resting Yes and No bids, best first, with the best Yes bid and ask, the midpoint and the spread. (A No bid at $0.14 is an offer to sell Yes at $0.86.)

Inputs

Market tickertickertextRequired
The market's ticker, e.g. KXFEDDECISION-26OCT-H0, from 'Get event' or 'List markets'.
Price levelsdepthnumber
How many price levels of each side to list, 1 to 100. Defaults to 10.From 1 to 100.

Outputs

best_yes_asknumber
The lowest Yes ask, in dollars (1 minus the best No bid).
best_yes_bidnumber
The highest Yes bid, in dollars.
midpointnumber
Halfway between the best Yes bid and ask.
no_bid_contractsnumber
Contracts bid for No at the levels listed.
no_bidslist
Bids for No, highest first.
probability_percentnumber
The midpoint as a chance in percent.
spreadnumber
The best Yes ask minus the best Yes bid.
summarytext
One line saying what came back.
tickertext
The market's ticker.
yes_bid_contractsnumber
Contracts bid for Yes at the levels listed.
yes_bidslist
Bids for Yes, highest first.
Example output
{
  "best_yes_ask": 0.86,
  "best_yes_bid": 0.85,
  "midpoint": 0.855,
  "no_bid_contracts": 19086.88,
  "no_bids": [
    {
      "contracts": 19086.88,
      "price": 0.14
    }
  ],
  "probability_percent": 85.5,
  "spread": 0.01,
  "summary": "KXFEDDECISION-26OCT-H0: Yes bid $0.85, ask $0.86.",
  "ticker": "KXFEDDECISION-26OCT-H0",
  "yes_bid_contracts": 24594.0,
  "yes_bids": [
    {
      "contracts": 24594.0,
      "price": 0.85
    }
  ]
}

Get price history

Get a market's candlesticks (open, high, low and close of the Yes price, with volume and open interest) by the minute, hour or day over a window, plus the move, high and low across it.

Inputs

Market tickertickertextRequired
The market's ticker, e.g. KXFEDDECISION-26OCT-H0, from 'Get event' or 'List markets'.
Candle lengthperiodtext
How long each candlestick covers. Defaults to 1 hour. Without a start time: 1 minute shows the last 2 hours, 1 hour the last 2 days, 1 day the last 30 days.One of: 1m (1 minute), 1h (1 hour), 1d (1 day).
Fromstart_timedate and time
Start of the window. At most 5,000 candlesticks before the end.
Untilend_timedate and time
End of the window. Defaults to now.

Outputs

candleslist
The candlesticks, oldest first.
change_pointsnumber
The move from first to last close, in percentage points.
countnumber
How many came back on this page.
end_timetext
The window's end (ISO 8601, UTC).
first_closenumber
The first candle's closing price, in dollars.
highnumber
The highest trade price in the window.
last_closenumber
The last candle's closing price, in dollars.
lownumber
The lowest trade price in the window.
periodtext
The candle length: 1m, 1h or 1d.
sourcetext
'live', or 'archive' for a market settled before Kalshi's cutoff.
start_timetext
The window's start (ISO 8601, UTC).
summarytext
One line saying what came back.
tickertext
The market's ticker.
Example output
{
  "candles": [
    {
      "close": 0.45,
      "high": 0.45,
      "low": 0.44,
      "mean": 0.4491,
      "open": 0.45,
      "open_interest": 413231.67,
      "time": "2026-09-20T04:00:00Z",
      "volume": 7116.45,
      "yes_ask_close": 0.45,
      "yes_bid_close": 0.44
    }
  ],
  "change_points": 42.0,
  "count": 1,
  "end_time": "2026-10-20T00:44:07Z",
  "first_close": 0.45,
  "high": 0.88,
  "last_close": 0.87,
  "low": 0.28,
  "period": "1d",
  "source": "live",
  "start_time": "2026-09-20T00:44:07Z",
  "summary": "KXFEDDECISION-26OCT-H0 went from 45% to 87% (+42 points).",
  "ticker": "KXFEDDECISION-26OCT-H0"
}

Get series

Get one series: its title, category, tags, how often it recurs, its fees, settlement sources, contract terms and the volume traded.

Inputs

Series tickerseries_tickertextRequired
The series' ticker, e.g. KXFEDDECISION, or its kalshi.com link.

Outputs

categorieslist
Every category it is listed under.
categorytext
Its main category, e.g. 'Economics'.
contract_terms_urltext
The current terms of the contract.
contract_urltext
The contract filing behind the series.
fee_multipliernumber
The multiplier applied to its fees.
fee_typetext
Its fee structure, e.g. 'quadratic'.
frequencytext
How often a new event appears, e.g. 'daily', 'weekly' or 'custom'.
settlement_sourceslist
Where its results are taken from.
tagslist
The subjects it is tagged with, e.g. 'Fed'.
tickertext
The series' ticker, e.g. KXFEDDECISION.
titletext
The series' title.
updated_attext
When its details last changed (ISO 8601, UTC).
volumenumber
Contracts traded across all its events.
Example output
{
  "categories": [
    "Economics"
  ],
  "category": "Economics",
  "contract_terms_url": "https://assets.kalshi.com/contract_terms/FEDDECISION.pdf",
  "contract_url": "https://assets.kalshi.com/regulatory/product-certifications/FEDDECISION.pdf",
  "fee_multiplier": 1.0,
  "fee_type": "quadratic_with_maker_fees",
  "frequency": "custom",
  "settlement_sources": [
    {
      "name": "Federal Reserve",
      "url": "https://www.federalreserve.gov"
    }
  ],
  "tags": [
    "Fed"
  ],
  "ticker": "KXFEDDECISION",
  "title": "Fed meeting",
  "updated_at": "2026-10-15T08:14:10Z",
  "volume": 623996212.0
}

Get trading hours

Get Kalshi's weekly trading hours (in Eastern Time) with the stretches each day it is closed, and any scheduled maintenance.

Inputs

None.

Outputs

maintenance_windowslist
Scheduled maintenance.
summarytext
One line saying what came back.
time_zonetext
The hours' time zone.
weekly_hourslist
Each weekday's hours.
Example output
{
  "maintenance_windows": [
    {
      "ends": "2026-10-22T09:00:00Z",
      "starts": "2026-10-22T07:00:00Z"
    }
  ],
  "summary": "Kalshi trades around the clock except Thursday 03:00-05:00 (Eastern Time).",
  "time_zone": "America/New_York",
  "weekly_hours": [
    {
      "closed": [
        "03:00-05:00"
      ],
      "day": "thursday",
      "sessions": [
        {
          "closes": "03:00",
          "opens": "00:00"
        },
        {
          "closes": "00:00",
          "opens": "05:00"
        }
      ]
    }
  ]
}

List combo collections

List Kalshi's combo collections: the sets of events you can combine into one multi-leg market (a parlay), with how many legs a combo takes and which events it draws on.

Inputs

Statusstatustext
Only collections in this state. Leave blank for any.One of: open, unopened (Not open yet), closed.
Series tickerseries_tickertext
Only this series, e.g. KXFEDDECISION.
Event tickerevent_tickertext
Only collections that can include this event.
How manylimitnumber
How many collections to return, 1 to 200. Defaults to 20.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

collectionslist
The collections.
countnumber
How many came back on this page.
next_cursortext
Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
Example output
{
  "collections": [
    {
      "closes": "2029-11-07T15:00:00Z",
      "description": "Choose any combination of game stats and props.",
      "event_count": 2246,
      "first_event_tickers": [
        "KXNFLGAME-26OCT19WASSF"
      ],
      "max_legs": 0,
      "min_legs": 2,
      "opens": "2026-10-19T18:25:15Z",
      "series_ticker": "KXMVESPORTSMULTIGAMEEXTENDED",
      "ticker": "KXMVESPORTSMULTIGAMEEXTENDED-R",
      "title": "What will happen across all games?"
    }
  ],
  "count": 1,
  "next_cursor": ""
}

List events

List events (one occurrence of a question, holding one or more markets) by status, series and closing time, each with its leading markets and their chances. Gets one page; to see more, run it again with the next page it gives.

Inputs

Statusstatustext
Only events in this state. Leave blank for any.One of: open, unopened (Not open yet), closed (Closed, awaiting the result), settled.
Series tickerseries_tickertext
Only this series, e.g. KXFEDDECISION.
Closing afterclosing_afterdate and time
Only events with a market that closes after this time.
Markets per eventmarkets_per_eventnumber
How many of each event's markets to include, the leading ones first, 0 to 50. Defaults to 5; 'Get event' gives more.From 0 to 50.
How manylimitnumber
How many events to return, 1 to 200. Defaults to 20.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many came back on this page.
eventslist
The events.
next_cursortext
Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
Example output
{
  "count": 1,
  "events": [
    {
      "category": "Economics",
      "competition": "US FED",
      "event_ticker": "KXFEDDECISION-26OCT",
      "market_count": 5,
      "markets": [
        {
          "label": "Fed maintains rate",
          "probability_percent": 85.0,
          "status": "open",
          "ticker": "KXFEDDECISION-26OCT-H0",
          "volume_24h": 110498.64
        }
      ],
      "mutually_exclusive": true,
      "series_ticker": "KXFEDDECISION",
      "settlement_sources": [
        {
          "name": "Federal Reserve",
          "url": "https://www.federalreserve.gov"
        }
      ],
      "strike_date": "2026-10-28T18:00:00Z",
      "strike_period": null,
      "subtitle": "On Oct 28, 2026",
      "summary": "Fed decision in Oct 2026? Fed maintains rate leads at 85% (5 markets).",
      "title": "Fed decision in Oct 2026?"
    }
  ],
  "next_cursor": ""
}

List markets

List markets (one yes/no contract each) by event, series, tickers, status and closing time, with their chances, bids, asks and volume. Gets one page; to see more, run it again with the next page it gives.

Inputs

Event tickerevent_tickertext
Only this event, e.g. KXFEDDECISION-26OCT.
Series tickerseries_tickertext
Only this series, e.g. KXFEDDECISION.
Market tickerstickerstext
Only these markets: up to 100 tickers, separated by commas.
Statusstatustext
Only markets in this state. Leave blank for any.One of: open, unopened (Not open yet), paused, closed (Closed, awaiting the result), settled.
Closes aftercloses_afterdate and time
Only markets that close after this time.
Closes beforecloses_beforedate and time
Only markets that close before this time.
Comboscombostext
Whether to include combo markets (parlays built from several markets). Defaults to leaving them out.One of: exclude (Leave combos out), include (Include combos), only (Only combos).
How manylimitnumber
How many markets to return, 1 to 1,000. Defaults to 20.From 1 to 1000.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many came back on this page.
marketslist
The markets.
next_cursortext
Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
Example output
{
  "count": 1,
  "markets": [
    {
      "archived": false,
      "can_close_early": true,
      "close_time": "2026-10-28T17:59:00Z",
      "event_ticker": "KXFEDDECISION-26OCT",
      "expected_expiration_time": "2026-10-28T18:05:00Z",
      "expiration_value": null,
      "last_price": 0.85,
      "market_type": "binary",
      "more_rules": "The outcomes are mutually exclusive: at most one can resolve to Yes.",
      "no_ask": 0.15,
      "no_bid": 0.14,
      "no_label": "Fed maintains rate",
      "open_interest": 1908615.21,
      "open_time": "2025-09-29T14:00:00Z",
      "price_change_24h_points": -2.0,
      "probability_percent": 85.0,
      "result": null,
      "rules": "If the Federal Reserve does a Hike of 0bps on October 28, 2026, then the market resolves to Yes.",
      "settled_at": null,
      "settlement_value": null,
      "status": "open",
      "summary": "Will the Federal Reserve Hike rates by 0bps at their October 2026 meeting? Yes 85% (bid $0.85, ask $0.86).",
      "ticker": "KXFEDDECISION-26OCT-H0",
      "title": "Will the Federal Reserve Hike rates by 0bps at their October 2026 meeting?",
      "volume": 5795506.73,
      "volume_24h": 110498.64,
      "yes_ask": 0.86,
      "yes_bid": 0.85,
      "yes_label": "Fed maintains rate"
    }
  ],
  "next_cursor": ""
}

List milestones

List milestones: the games, matches, races and elections Kalshi's markets settle on, with when they start and which events they decide. Gets one page; to see more, run it again with the next page it gives.

Inputs

Categorycategorytext
Only milestones of this kind.One of: Sports, Esports, Elections, Crypto.
Competitioncompetitiontext
Only this competition, e.g. Pro Football or Pro Basketball (M).
Typemilestone_typetext
Only this type, e.g. football_game, basketball_game or tennis_match.
Starting afterstarting_afterdate and time
Only milestones that start at or after this time.
Event tickerevent_tickertext
Only milestones connected with this event.
How manylimitnumber
How many milestones to return, 1 to 500. Defaults to 20.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many came back on this page.
milestoneslist
The milestones.
next_cursortext
Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
Example output
{
  "count": 1,
  "milestones": [
    {
      "category": "Sports",
      "end_date": null,
      "event_tickers": [
        "KXNFLGAME-26OCT19WASSF"
      ],
      "id": "794d4c92-b7cd-4f5e-ae33-0c5c9028be62",
      "league": "NFL",
      "related_event_tickers": [
        "KXNFLGAME-26OCT19WASSF"
      ],
      "start_date": "2026-10-20T00:15:00Z",
      "status": null,
      "title": "WAS Commanders at SF 49ers",
      "type": "football_game",
      "updated_at": "2026-10-19T12:02:10Z"
    }
  ],
  "next_cursor": ""
}

List people and teams

List the people, teams and other subjects Kalshi's markets are about (its 'structured targets'): players, teams, actors, films and more, each with its own facts such as league and position.

Inputs

Typetarget_typetext
Only this kind, e.g. basketball_player, football_team or actor.
Competitioncompetitiontext
Only those in this league, conference or tour, e.g. NFL.
How manylimitnumber
How many to return, 1 to 2,000. Defaults to 20.From 1 to 2000.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many came back on this page.
next_cursortext
Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
targetslist
The people, teams and subjects.
Example output
{
  "count": 1,
  "next_cursor": "",
  "targets": [
    {
      "details": {
        "league": "NCAAMB",
        "position": "G"
      },
      "id": "00007b77-b477-4399-9eef-a7760434ad33",
      "name": "Landin Roozenboom",
      "type": "basketball_player",
      "updated_at": "2026-02-16T17:14:52Z"
    }
  ]
}

List reward programs

List Kalshi's reward programs for keeping orders in a market's book or for trading in it: which market, when, the reward in dollars and the order size asked for.

Inputs

Statusstatustext
Which programs. Defaults to those running now.One of: active (Running now), upcoming, closed (Ended), paid_out (Paid out), all.
Rewards forincentive_typetext
Rewards for resting orders, for trading, or both. Defaults to both.One of: all, liquidity (Liquidity (resting orders)), volume (Volume (trading)).
How manylimitnumber
How many programs to return, 1 to 1,000. Defaults to 20.From 1 to 1000.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many came back on this page.
next_cursortext
Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
programslist
The reward programs.
Example output
{
  "count": 1,
  "next_cursor": "",
  "programs": [
    {
      "description": "series_lip",
      "discount_factor_bps": 5000,
      "ends": "2026-10-20T01:00:00Z",
      "id": "fec5fd9a-e035-4dfc-8df9-9107a2e9be29",
      "market_ticker": "KXCRYPTOLEAD15M-26OCT192100-BTC",
      "max_reward_per_account_usd": null,
      "paid_out": false,
      "reward_usd": 20.0,
      "starts": "2026-10-20T00:45:00Z",
      "target_contracts": 1000.0,
      "type": "liquidity"
    }
  ]
}

List series

List the series (recurring questions, such as each Fed decision or daily temperature) in a category or with a tag, most traded first, with their frequency, fees and settlement sources.

Inputs

Categorycategorytext
Series in this category. Give a category, a tag, or both.
Tagtagtext
Series with this tag, e.g. Fed. Pick a category first to choose from its tags.
Title containstitle_containstext
Only series whose title contains these words.
How manylimitnumber
How many series to return, most traded first, 1 to 200. Defaults to 25.From 1 to 200.

Outputs

countnumber
How many came back on this page.
serieslist
The series, most traded first.
totalnumber
How many series matched in all.
Example output
{
  "count": 1,
  "series": [
    {
      "categories": [
        "Economics"
      ],
      "category": "Economics",
      "contract_terms_url": "https://assets.kalshi.com/contract_terms/FEDDECISION.pdf",
      "contract_url": "https://assets.kalshi.com/regulatory/product-certifications/FEDDECISION.pdf",
      "fee_multiplier": 1.0,
      "fee_type": "quadratic_with_maker_fees",
      "frequency": "custom",
      "settlement_sources": [
        {
          "name": "Federal Reserve",
          "url": "https://www.federalreserve.gov"
        }
      ],
      "tags": [
        "Fed"
      ],
      "ticker": "KXFEDDECISION",
      "title": "Fed meeting",
      "updated_at": "2026-10-15T08:14:10Z",
      "volume": 623996212.0
    }
  ],
  "total": 44
}

List trades

List recent trades, newest first, on one market or across Kalshi: the side taken, Yes and No prices, contracts and dollars. A settled market's trades are read from Kalshi's archive. Gets one page; to see more, run it again with the next page it gives.

Inputs

Market tickertickertext
Only this market's trades. Leave blank for trades across Kalshi.
Fromstart_timedate and time
Only trades from this time on.
Untilend_timedate and time
Only trades up to this time.
Block trades onlyblock_trades_onlytrue/false
Only large trades arranged off the order book.
How manylimitnumber
How many trades to return, 1 to 1,000. Defaults to 20.From 1 to 1000.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many came back on this page.
newest_attext
When the newest trade happened.
next_cursortext
Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
sourcetext
'live', or 'archive' for a market settled before Kalshi's cutoff.
tradeslist
The trades, newest first.
Example output
{
  "count": 1,
  "newest_at": "2026-10-20T00:21:06Z",
  "next_cursor": "",
  "source": "live",
  "trades": [
    {
      "contracts": 5.69,
      "is_block_trade": false,
      "no_price": 0.15,
      "taker_side": "no",
      "ticker": "KXFEDDECISION-26OCT-H0",
      "time": "2026-10-20T00:21:06Z",
      "trade_id": "07240f6f-b4a1-b506-6793-9c2c35d6f507",
      "value_usd": 0.85,
      "yes_price": 0.85
    }
  ]
}

On this page