# Kalshi Prediction Markets API

> Kalshi events and markets with live yes/no prices, volume, open interest and rules

- Vendor: `kalshipredictionmarketsapi` · version 1.0 · category Finance · tags kalshi api, prediction market api, event contracts api, election odds api, event probability api, cftc market data api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/kalshipredictionmarketsapi
- This document: https://apiclay.com/docs/kalshipredictionmarketsapi.md
- OpenAPI 3.1: https://apiclay.com/api/kalshipredictionmarketsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `kalshipredictionmarketsapi`
- Updated: 2026-11-18

## About

## Kalshi Prediction Markets API

List Kalshi events and markets with their yes/no bid and ask prices in dollars, last price, 24h and total volume, open interest, open/close times, status and the rules each market settles on.

Data comes from **kalshi.com** (https://kalshi.com/markets). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://kalshi.com/markets) and returns it unchanged.

Typical flow: `/events` or `/markets?status=open`, then `/market` or `/event` by ticker; page with `cursor`.

### Routes

#### GET `/markets` - Markets
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | number | no | 1-1000 (default 100). |
| cursor | query | string | no | `cursor` from the previous page. |
| status | query | string | no | `unopened`, `open`, `closed` or `settled`. |
| event_ticker | query | string | no | Markets of one event. |
| series_ticker | query | string | no | Markets of one series, e.g. `KXFED`. |
| tickers | query | string | no | Comma-separated market tickers. |
| min_close_ts | query | number | no | Unix seconds. |
| max_close_ts | query | number | no | Unix seconds. |

Returns: `markets[]` (`ticker`, `event_ticker`, `title`, `status`, `yes_bid_dollars`, `yes_ask_dollars`, `no_bid_dollars`, `no_ask_dollars`, `last_price_dollars`, `volume_fp`, `volume_24h_fp`, `open_interest_fp`, `close_time`, `rules_primary`) and `cursor`.

#### GET `/market` - Market by ticker
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ticker | path | string | yes | Market ticker. |

Returns: `market` with the fields above.

#### GET `/events` - Events
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | number | no | 1-200. |
| cursor | query | string | no |  |
| status | query | string | no | `open`, `closed` or `settled`. |
| series_ticker | query | string | no |  |
| with_nested_markets | query | string | no | `true` to include markets. |

Returns: `events[]` (`event_ticker`, `series_ticker`, `title`, `category`, `mutually_exclusive`) and `cursor`.

#### GET `/event` - Event by ticker
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| event_ticker | path | string | yes | Event ticker. |
| with_nested_markets | query | string | no | `true` to nest markets. |

Returns: `event` and `markets[]`.

#### GET `/series` - Series by ticker
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| series_ticker | path | string | yes | e.g. `KXFED`. |

Returns: `series` (`title`, `category`, `frequency`, `settlement_sources`).

### Caveats

- Market data only; no trading or account routes.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by kalshi.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /markets — Markets
- Gateway: `GET https://api.apiclay.com/v1/api/kalshipredictionmarketsapi/markets`
- Public query params: `limit` (number), `cursor` (string), `status` (string), `event_ticker` (string), `series_ticker` (string), `tickers` (string), `min_close_ts` (number), `max_close_ts` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /market — Market by ticker
- Gateway: `GET https://api.apiclay.com/v1/api/kalshipredictionmarketsapi/market`
- Public query params: `ticker` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /events — Events
- Gateway: `GET https://api.apiclay.com/v1/api/kalshipredictionmarketsapi/events`
- Public query params: `limit` (number), `cursor` (string), `status` (string), `series_ticker` (string), `with_nested_markets` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /event — Event by ticker
- Gateway: `GET https://api.apiclay.com/v1/api/kalshipredictionmarketsapi/event`
- Public query params: `with_nested_markets` (string), `event_ticker` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /series — Series by ticker
- Gateway: `GET https://api.apiclay.com/v1/api/kalshipredictionmarketsapi/series`
- Public query params: `series_ticker` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/kalshipredictionmarketsapi/markets" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
