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
| Action | What it does |
|---|---|
| Get event | Get one event with its markets (each with its chance, bid, ask, volume and closing time), its settlement sources and its picture. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| Get series | Get one series: its title, category, tags, how often it recurs, its fees, settlement sources, contract terms and the volume traded. |
| Get trading hours | Get Kalshi's weekly trading hours (in Eastern Time) with the stretches each day it is closed, and any scheduled maintenance. |
| 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. |
| 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. |
| List markets | List markets (one yes/no contract each) by event, series, tickers, status and closing time, with their chances, bids, asks and volume. |
| List milestones | List milestones: the games, matches, races and elections Kalshi's markets settle on, with when they start and which events they decide. |
| 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. |
| 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. |
| 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. |
| List trades | List 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 ticker
event_tickertextRequired - The event's ticker, e.g. KXFEDDECISION-26OCT, or its kalshi.com link.
- Most markets
max_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 ID
milestone_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 ticker
tickertextRequired - 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 ticker
tickertextRequired - The market's ticker, e.g. KXFEDDECISION-26OCT-H0, from 'Get event' or 'List markets'.
- Price levels
depthnumber - 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 ticker
tickertextRequired - The market's ticker, e.g. KXFEDDECISION-26OCT-H0, from 'Get event' or 'List markets'.
- Candle length
periodtext - 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). - From
start_timedate and time - Start of the window. At most 5,000 candlesticks before the end.
- Until
end_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 ticker
series_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
- Status
statustext - Only collections in this state. Leave blank for any.One of:
open,unopened(Not open yet),closed. - Series ticker
series_tickertext - Only this series, e.g. KXFEDDECISION.
- Event ticker
event_tickertext - Only collections that can include this event.
- How many
limitnumber - How many collections to return, 1 to 200. Defaults to 20.From 1 to 200.
- Next page cursor
cursortext - 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
- Status
statustext - Only events in this state. Leave blank for any.One of:
open,unopened(Not open yet),closed(Closed, awaiting the result),settled. - Series ticker
series_tickertext - Only this series, e.g. KXFEDDECISION.
- Closing after
closing_afterdate and time - Only events with a market that closes after this time.
- Markets per event
markets_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 many
limitnumber - How many events to return, 1 to 200. Defaults to 20.From 1 to 200.
- Next page cursor
cursortext - 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 ticker
event_tickertext - Only this event, e.g. KXFEDDECISION-26OCT.
- Series ticker
series_tickertext - Only this series, e.g. KXFEDDECISION.
- Market tickers
tickerstext - Only these markets: up to 100 tickers, separated by commas.
- Status
statustext - Only markets in this state. Leave blank for any.One of:
open,unopened(Not open yet),paused,closed(Closed, awaiting the result),settled. - Closes after
closes_afterdate and time - Only markets that close after this time.
- Closes before
closes_beforedate and time - Only markets that close before this time.
- Combos
combostext - 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 many
limitnumber - How many markets to return, 1 to 1,000. Defaults to 20.From 1 to 1000.
- Next page cursor
cursortext - 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
- Category
categorytext - Only milestones of this kind.One of:
Sports,Esports,Elections,Crypto. - Competition
competitiontext - Only this competition, e.g. Pro Football or Pro Basketball (M).
- Type
milestone_typetext - Only this type, e.g. football_game, basketball_game or tennis_match.
- Starting after
starting_afterdate and time - Only milestones that start at or after this time.
- Event ticker
event_tickertext - Only milestones connected with this event.
- How many
limitnumber - How many milestones to return, 1 to 500. Defaults to 20.From 1 to 500.
- Next page cursor
cursortext - 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
- Type
target_typetext - Only this kind, e.g. basketball_player, football_team or actor.
- Competition
competitiontext - Only those in this league, conference or tour, e.g. NFL.
- How many
limitnumber - How many to return, 1 to 2,000. Defaults to 20.From 1 to 2000.
- Next page cursor
cursortext - 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
- Status
statustext - Which programs. Defaults to those running now.One of:
active(Running now),upcoming,closed(Ended),paid_out(Paid out),all. - Rewards for
incentive_typetext - Rewards for resting orders, for trading, or both. Defaults to both.One of:
all,liquidity(Liquidity (resting orders)),volume(Volume (trading)). - How many
limitnumber - How many programs to return, 1 to 1,000. Defaults to 20.From 1 to 1000.
- Next page cursor
cursortext - 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
- Category
categorytext - Series in this category. Give a category, a tag, or both.
- Tag
tagtext - Series with this tag, e.g. Fed. Pick a category first to choose from its tags.
- Title contains
title_containstext - Only series whose title contains these words.
- How many
limitnumber - 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 ticker
tickertext - Only this market's trades. Leave blank for trades across Kalshi.
- From
start_timedate and time - Only trades from this time on.
- Until
end_timedate and time - Only trades up to this time.
- Block trades only
block_trades_onlytrue/false - Only large trades arranged off the order book.
- How many
limitnumber - How many trades to return, 1 to 1,000. Defaults to 20.From 1 to 1000.
- Next page cursor
cursortext - 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
}
]
}