# Kalshi

> 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.

App · 16 actions. Web page: https://docs.lodol.com/docs/integrations/kalshi

## Actions

### 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_ticker`, text, required): The event's ticker, e.g. KXFEDDECISION-26OCT, or its kalshi.com link.
- Most markets (`max_markets`, number): How many of the event's markets to include, the leading ones first, 1 to 500. Defaults to 100. From 1 to 500.

**Outputs**

- `category` (text): The event's category, e.g. 'Economics'.
- `competition` (text): The competition or programme, e.g. 'US FED' or 'NFL'.
- `competition_scope` (text): What the competition is about, e.g. 'Fed Decision'.
- `event_ticker` (text): The event's ticker, e.g. KXFEDDECISION-26OCT.
- `image_url` (text): The event's picture.
- `market_count` (number): How many markets the event holds in all.
- `markets` (list): 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_exclusive` (true/false): True when at most one of its markets can resolve Yes.
- `series_ticker` (text): The ticker of the recurring series it belongs to.
- `settlement_sources` (list): Where the results are taken from.
- `strike_date` (text): The date the event is about, when it has one (ISO 8601, UTC).
- `strike_period` (text): The period the event covers, when it has one, e.g. 'week'.
- `subtitle` (text): A short line under the title, e.g. 'On Oct 28, 2026'.
- `summary` (text): One line with the title and who leads, e.g. 'Fed decision in Oct 2026? Fed maintains rate leads at 85% (5 markets).'
- `title` (text): The event's title.

**Example output**

```json
{
  "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_time` (text): During maintenance, when it should end (ISO 8601, UTC).
- `exchange_active` (true/false): False while the exchange is down for maintenance.
- `shards` (list): Each part of the exchange.
- `summary` (text): One line saying what came back.
- `trading_active` (true/false): True while trading is allowed.
- `transfers_active` (true/false): True while moving money between accounts is allowed.

**Example output**

```json
{
  "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_id`, text, required): The game's milestone id, from 'List milestones'.

**Outputs**

- `away_points` (number): The away side's score, counted the same way.
- `clock` (text): The game clock, when the sport has one.
- `details` (object): The sport's own live fields (timeouts left, possession, under review...), which vary by sport.
- `event_tickers` (list): The events whose outcome the game decides.
- `home_points` (number): The home side's score: points, goals or, in tennis, sets.
- `last_play` (text): The most recent play, in words.
- `milestone_id` (text): The milestone's id.
- `period` (text): The quarter, period, inning, half, set or round being played.
- `status` (text): The game's status, e.g. 'scheduled', 'inprogress' or 'closed'.
- `summary` (text): One line saying what came back.
- `title` (text): What the milestone is, e.g. 'WAS Commanders at SF 49ers'.
- `type` (text): The kind, e.g. football_game.
- `updated_at` (text): When the live data last changed (ISO 8601, UTC).
- `winner` (text): The winner, once decided.

**Example output**

```json
{
  "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 (`ticker`, text, required): The market's ticker, e.g. KXFEDDECISION-26OCT-H0, from 'Get event' or 'List markets'.

**Outputs**

- `archived` (true/false): True when the market has moved to Kalshi's archive (settled before its cutoff), which is where it was read from.
- `can_close_early` (true/false): True when trading can stop early if the event happens.
- `close_time` (text): When trading closes (ISO 8601, UTC).
- `event_ticker` (text): The ticker of the event the market belongs to.
- `expected_expiration_time` (text): When the result is expected (ISO 8601, UTC).
- `expiration_value` (text): The figure or outcome the market was settled on.
- `last_price` (number): The price, in dollars, of the most recent Yes trade.
- `market_type` (text): 'binary' (pays $1 or nothing) or 'scalar' (pays in between).
- `more_rules` (text): The finer print of the rules.
- `no_ask` (number): The lowest price, in dollars, a seller is asking for No.
- `no_bid` (number): The highest price, in dollars, a buyer is bidding for No.
- `no_label` (text): What No means on this market.
- `open_interest` (number): Contracts currently held.
- `open_time` (text): When trading opened (ISO 8601, UTC).
- `price_change_24h_points` (number): How far the last price moved in the last day, in percentage points.
- `probability_percent` (number): 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.
- `result` (text): Once settled, 'yes' or 'no' (or 'scalar'); empty before.
- `rules` (text): The main rule: exactly what makes the market resolve Yes.
- `settled_at` (text): When the market settled, once it has (ISO 8601, UTC).
- `settlement_value` (number): What a Yes contract paid out, in dollars, once settled.
- `status` (text): Where the market is in its life: 'not open yet', 'open', 'paused', 'closed' (trading over, awaiting the result), 'determined', 'disputed' or 'settled'.
- `summary` (text): One line with the question and its chance, e.g. '... Yes 85% (bid $0.85, ask $0.86).'
- `ticker` (text): The market's ticker, e.g. KXFEDDECISION-26OCT-H0.
- `title` (text): The market's question.
- `volume` (number): Contracts traded in all.
- `volume_24h` (number): Contracts traded in the last 24 hours.
- `yes_ask` (number): The lowest price, in dollars, a seller is asking for Yes.
- `yes_bid` (number): The highest price, in dollars, a buyer is bidding for Yes.
- `yes_label` (text): What Yes means on this market, e.g. 'Fed maintains rate'.

**Example output**

```json
{
  "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 (`ticker`, text, required): The market's ticker, e.g. KXFEDDECISION-26OCT-H0, from 'Get event' or 'List markets'.
- Price levels (`depth`, number): How many price levels of each side to list, 1 to 100. Defaults to 10. From 1 to 100.

**Outputs**

- `best_yes_ask` (number): The lowest Yes ask, in dollars (1 minus the best No bid).
- `best_yes_bid` (number): The highest Yes bid, in dollars.
- `midpoint` (number): Halfway between the best Yes bid and ask.
- `no_bid_contracts` (number): Contracts bid for No at the levels listed.
- `no_bids` (list): Bids for No, highest first.
- `probability_percent` (number): The midpoint as a chance in percent.
- `spread` (number): The best Yes ask minus the best Yes bid.
- `summary` (text): One line saying what came back.
- `ticker` (text): The market's ticker.
- `yes_bid_contracts` (number): Contracts bid for Yes at the levels listed.
- `yes_bids` (list): Bids for Yes, highest first.

**Example output**

```json
{
  "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 (`ticker`, text, required): The market's ticker, e.g. KXFEDDECISION-26OCT-H0, from 'Get event' or 'List markets'.
- Candle length (`period`, text): 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_time`, date and time): Start of the window. At most 5,000 candlesticks before the end.
- Until (`end_time`, date and time): End of the window. Defaults to now.

**Outputs**

- `candles` (list): The candlesticks, oldest first.
- `change_points` (number): The move from first to last close, in percentage points.
- `count` (number): How many came back on this page.
- `end_time` (text): The window's end (ISO 8601, UTC).
- `first_close` (number): The first candle's closing price, in dollars.
- `high` (number): The highest trade price in the window.
- `last_close` (number): The last candle's closing price, in dollars.
- `low` (number): The lowest trade price in the window.
- `period` (text): The candle length: 1m, 1h or 1d.
- `source` (text): 'live', or 'archive' for a market settled before Kalshi's cutoff.
- `start_time` (text): The window's start (ISO 8601, UTC).
- `summary` (text): One line saying what came back.
- `ticker` (text): The market's ticker.

**Example output**

```json
{
  "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_ticker`, text, required): The series' ticker, e.g. KXFEDDECISION, or its kalshi.com link.

**Outputs**

- `categories` (list): Every category it is listed under.
- `category` (text): Its main category, e.g. 'Economics'.
- `contract_terms_url` (text): The current terms of the contract.
- `contract_url` (text): The contract filing behind the series.
- `fee_multiplier` (number): The multiplier applied to its fees.
- `fee_type` (text): Its fee structure, e.g. 'quadratic'.
- `frequency` (text): How often a new event appears, e.g. 'daily', 'weekly' or 'custom'.
- `settlement_sources` (list): Where its results are taken from.
- `tags` (list): The subjects it is tagged with, e.g. 'Fed'.
- `ticker` (text): The series' ticker, e.g. KXFEDDECISION.
- `title` (text): The series' title.
- `updated_at` (text): When its details last changed (ISO 8601, UTC).
- `volume` (number): Contracts traded across all its events.

**Example output**

```json
{
  "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_windows` (list): Scheduled maintenance.
- `summary` (text): One line saying what came back.
- `time_zone` (text): The hours' time zone.
- `weekly_hours` (list): Each weekday's hours.

**Example output**

```json
{
  "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 (`status`, text): Only collections in this state. Leave blank for any. One of: `open`, `unopened` (Not open yet), `closed`.
- Series ticker (`series_ticker`, text): Only this series, e.g. KXFEDDECISION.
- Event ticker (`event_ticker`, text): Only collections that can include this event.
- How many (`limit`, number): How many collections to return, 1 to 200. Defaults to 20. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `collections` (list): The collections.
- `count` (number): How many came back on this page.
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.

**Example output**

```json
{
  "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 (`status`, text): 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_ticker`, text): Only this series, e.g. KXFEDDECISION.
- Closing after (`closing_after`, date and time): Only events with a market that closes after this time.
- Markets per event (`markets_per_event`, number): 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 (`limit`, number): How many events to return, 1 to 200. Defaults to 20. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back on this page.
- `events` (list): The events.
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.

**Example output**

```json
{
  "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_ticker`, text): Only this event, e.g. KXFEDDECISION-26OCT.
- Series ticker (`series_ticker`, text): Only this series, e.g. KXFEDDECISION.
- Market tickers (`tickers`, text): Only these markets: up to 100 tickers, separated by commas.
- Status (`status`, text): 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_after`, date and time): Only markets that close after this time.
- Closes before (`closes_before`, date and time): Only markets that close before this time.
- Combos (`combos`, text): 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 (`limit`, number): How many markets to return, 1 to 1,000. Defaults to 20. From 1 to 1000.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back on this page.
- `markets` (list): The markets.
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.

**Example output**

```json
{
  "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 (`category`, text): Only milestones of this kind. One of: `Sports`, `Esports`, `Elections`, `Crypto`.
- Competition (`competition`, text): Only this competition, e.g. Pro Football or Pro Basketball (M).
- Type (`milestone_type`, text): Only this type, e.g. football_game, basketball_game or tennis_match.
- Starting after (`starting_after`, date and time): Only milestones that start at or after this time.
- Event ticker (`event_ticker`, text): Only milestones connected with this event.
- How many (`limit`, number): How many milestones to return, 1 to 500. Defaults to 20. From 1 to 500.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back on this page.
- `milestones` (list): The milestones.
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.

**Example output**

```json
{
  "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_type`, text): Only this kind, e.g. basketball_player, football_team or actor.
- Competition (`competition`, text): Only those in this league, conference or tour, e.g. NFL.
- How many (`limit`, number): How many to return, 1 to 2,000. Defaults to 20. From 1 to 2000.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back on this page.
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
- `targets` (list): The people, teams and subjects.

**Example output**

```json
{
  "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 (`status`, text): Which programs. Defaults to those running now. One of: `active` (Running now), `upcoming`, `closed` (Ended), `paid_out` (Paid out), `all`.
- Rewards for (`incentive_type`, text): Rewards for resting orders, for trading, or both. Defaults to both. One of: `all`, `liquidity` (Liquidity (resting orders)), `volume` (Volume (trading)).
- How many (`limit`, number): How many programs to return, 1 to 1,000. Defaults to 20. From 1 to 1000.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back on this page.
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
- `programs` (list): The reward programs.

**Example output**

```json
{
  "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 (`category`, text): Series in this category. Give a category, a tag, or both.
- Tag (`tag`, text): Series with this tag, e.g. Fed. Pick a category first to choose from its tags.
- Title contains (`title_contains`, text): Only series whose title contains these words.
- How many (`limit`, number): How many series to return, most traded first, 1 to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many came back on this page.
- `series` (list): The series, most traded first.
- `total` (number): How many series matched in all.

**Example output**

```json
{
  "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 (`ticker`, text): Only this market's trades. Leave blank for trades across Kalshi.
- From (`start_time`, date and time): Only trades from this time on.
- Until (`end_time`, date and time): Only trades up to this time.
- Block trades only (`block_trades_only`, true/false): Only large trades arranged off the order book.
- How many (`limit`, number): How many trades to return, 1 to 1,000. Defaults to 20. From 1 to 1000.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back on this page.
- `newest_at` (text): When the newest trade happened.
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page. Empty when this is the last page.
- `source` (text): 'live', or 'archive' for a market settled before Kalshi's cutoff.
- `trades` (list): The trades, newest first.

**Example output**

```json
{
  "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
    }
  ]
}
```
