Kalshi Trade API

GET `/api_keys`

Get API Keys

Response

POST `/api_keys`

Create API Key

Request Body

Response

POST `/api_keys/generate`

Generate API Key

Request Body

Response

DELETE `/api_keys/{api_key}`

Delete API Key

api_key

API key ID to delete

Response

GET `/cached/events/{ticker}/forecast_history`

ticker

Ticker

Response

GET `/communications/id`

Get Communications ID

Response

GET `/communications/quotes`

Get Quotes

Response

POST `/communications/quotes`

Create Quote

Request Body

Response

DELETE `/communications/quotes/{quote_id}`

Delete Quote

quote_id

Quote ID

Response

GET `/communications/quotes/{quote_id}`

Get Quote

quote_id

Quote ID

Response

PUT `/communications/quotes/{quote_id}/accept`

Accept Quote

quote_id

Quote ID

Request Body

Response

PUT `/communications/quotes/{quote_id}/confirm`

Confirm Quote

quote_id

Quote ID

Response

GET `/communications/rfqs`

Get RFQs

Response

POST `/communications/rfqs`

Create RFQ

Request Body

Response

DELETE `/communications/rfqs/{rfq_id}`

Delete RFQ

rfq_id

RFQ ID

Response

GET `/communications/rfqs/{rfq_id}`

Get RFQ

rfq_id

RFQ ID

Response

GET `/events`

Get Events

limit

Parameter to specify the number of results per page. Defaults to 100. Maximum value is 200.

cursor

Parameter to specify the pagination cursor. Use the cursor value returned from the previous response to get the next page of results. Leave empty for the first page.

Parameter to specify if nested markets should be included in the response. When true, each event will include a 'markets' field containing a list of Market objects associated with that event.

with_nested_markets

status

Filter by event status. Possible values: 'open', 'closed', 'settled'. Leave empty to return events with any status.

series_ticker

Filter events by series ticker. Returns only events belonging to the specified series.

min_close_ts

Filter events with at least one market with close timestamp greater than this Unix timestamp (in seconds).

If true, includes related milestones as a field alongside events.

with_milestones

Response

GET `/events/{event_ticker}`

Get Event

event_ticker

Event ticker

If true, markets are included within the event object. If false (default), markets are returned as a separate top-level field in the response.

with_nested_markets

Response

GET `/events/{event_ticker}/metadata`

Get Event Metadata

event_ticker

Event ticker

Response

GET `/exchange/announcements`

Get Exchange Announcements

Response

GET `/exchange/schedule`

Get Exchange Schedule

Response

GET `/exchange/status`

Get Exchange Status

Response

GET `/exchange/user_data_timestamp`

Get User Data Timestamp

Response

GET `/incentive_programs`

Get Incentives

limit

Number of results per page. Defaults to 100. Maximum value is 10000.

Response

GET `/markets`

Get Markets

limit

Number of results per page. Defaults to 100. Maximum value is 1000.

cursor

Pagination cursor. Use the cursor value returned from the previous response to get the next page of results. Leave empty for the first page.

event_ticker

Filter markets by event ticker. Returns only markets belonging to the specified event.

series_ticker

Filter markets by series ticker. Returns only markets belonging to events in the specified series.

max_close_ts

Filter markets that close before this Unix timestamp.

min_close_ts

Filter markets that close after this Unix timestamp.

status

Filter by market status. Comma-separated list. Possible values: 'unopened', 'open', 'closed', 'settled'. Leave empty to return markets with any status.

tickers

Filter by specific market tickers. Comma-separated list of market tickers to retrieve.

Response

GET `/markets/trades`

Get Trades

limit

Number of results per page. Defaults to 100. Maximum value is 1000.

cursor

Pagination cursor. Use the cursor value returned from the previous response to get the next page of results. Leave empty for the first page.

ticker

Filter trades by market ticker. Returns only trades for the specified market.

min_ts

Filter trades that occurred after this Unix timestamp.

max_ts

Filter trades that occurred before this Unix timestamp.

Response

GET `/markets/{ticker}`

Get Market

ticker

Market ticker - unique identifier for the specific market

Response

GET `/markets/{ticker}/orderbook`

Get Market Order Book

ticker

Market ticker - unique identifier for the specific market

depth

Maximum number of price levels to return per side (yes bids/no bids). Defaults to all levels. Maximum value is 100.

Response

GET `/milestones`

Get Milestones

minimum_start_date

Minimum start date to filter milestones. Format: RFC3339 timestamp

GET `/milestones/{milestone_id}`

Get Milestone

milestone_id

Milestone ID

Response

GET `/multivariate_event_collections`

Get Multivariate Event Collections

Response

GET `/multivariate_event_collections/{collection_ticker}`

Get Multivariate Event Collection

collection_ticker

Collection ticker

Response

POST `/multivariate_event_collections/{collection_ticker}`

Create Market In Multivariate Event Collection

collection_ticker

Collection ticker

Request Body

Response

GET `/multivariate_event_collections/{collection_ticker}/lookup`

Get Multivariate Event Collection Lookup History

collection_ticker

Collection ticker

Response

PUT `/multivariate_event_collections/{collection_ticker}/lookup`

Lookup Tickers For Market In Multivariate Event Collection

collection_ticker

Collection ticker

Request Body

Response

GET `/portfolio/balance`

Get Balance

Response

GET `/portfolio/fills`

Get Fills

ticker

Restricts the response to trades in a specific market.

order_id

Restricts the response to trades related to a specific order.

min_ts

Restricts the response to trades after a timestamp.

max_ts

Restricts the response to trades before a timestamp.

limit

Parameter to specify the number of results per page. Defaults to 100.

cursor

The Cursor represents a pointer to the next page of records in the pagination. Use the value returned from the previous response to get the next page.

Response

GET `/portfolio/order_groups`

Get Order Groups

Response

POST `/portfolio/order_groups/create`

Create Order Group

Request Body

Response

DELETE `/portfolio/order_groups/{order_group_id}`

Delete Order Group

order_group_id

Order group ID

Response

GET `/portfolio/order_groups/{order_group_id}`

Get Order Group

order_group_id

Order group ID

Response

PUT `/portfolio/order_groups/{order_group_id}/reset`

Reset Order Group

order_group_id

Order group ID

Response

GET `/portfolio/orders`

Get Orders

ticker

Restricts the response to orders in a single market.

event_ticker

Restricts the response to orders in one or more events. Multiple event tickers can be provided as a comma-separated list.

min_ts

Restricts the response to orders after a timestamp, formatted as a Unix Timestamp.

max_ts

Restricts the response to orders before a timestamp, formatted as a Unix Timestamp.

status

Restricts the response to orders that have a certain status: resting, canceled, or executed.

cursor

The Cursor represents a pointer to the next page of records in the pagination. Use the value returned from the previous response to get the next page.

limit

Parameter to specify the number of results per page. Defaults to 100.

Response

POST `/portfolio/orders`

Create Order

Request Body

Response

DELETE `/portfolio/orders/batched`

Batch Cancel Orders

Request Body

Response

POST `/portfolio/orders/batched`

Batch Create Orders

Request Body

Response

GET `/portfolio/orders/queue_positions`

Get Queue Positions for Orders

market_tickers

Comma-separated list of market tickers to filter by

event_ticker

Event ticker to filter by

Response

DELETE `/portfolio/orders/{order_id}`

Cancel Order

order_id

Order ID

Response

GET `/portfolio/orders/{order_id}`

Get Order

order_id

Order ID

Response

POST `/portfolio/orders/{order_id}/amend`

Amend Order

order_id

Order ID

Request Body

Response

POST `/portfolio/orders/{order_id}/decrease`

Decrease Order

order_id

Order ID

Request Body

Response

GET `/portfolio/orders/{order_id}/queue_position`

Get Queue Position for Order

order_id

Order ID

Response

GET `/portfolio/positions`

Get Positions

cursor

The Cursor represents a pointer to the next page of records in the pagination. Use the value returned from the previous response to get the next page.

limit

Parameter to specify the number of results per page. Defaults to 100.

count_filter

Restricts the positions to those with any of following fields with non-zero values, as a comma separated list. The following values are accepted: position, total_traded, resting_order_count

settlement_status

Settlement status of the markets to return. Defaults to unsettled.

ticker

Ticker of desired positions.

event_ticker

Event ticker of desired positions.

Response

GET `/portfolio/settlements`

Get Settlements

limit

Parameter to specify the number of results per page. Defaults to 100.

ticker

Restricts the response to settlements in a specific market.

event_ticker

Restricts the response to settlements in a single event.

min_ts

Restricts the response to settlements after a timestamp.

max_ts

Restricts the response to settlements before a timestamp.

cursor

The Cursor represents a pointer to the next page of records in the pagination. Use the value returned from the previous response to get the next page.

Response

GET `/portfolio/summary/total_resting_order_value`

Get Portfolio Resting Order Total Value

Response

GET `/series`

Get Series List

GET `/series/fee_changes`

Response

GET `/series/{series_ticker}`

Get Series

series_ticker

Series ticker - unique identifier for the specific series

Response

GET `/series/{series_ticker}/events/{ticker}/candlesticks`

series_ticker

Series Ticker

ticker

Event Ticker

start_ts

Start timestamp for the range

end_ts

End timestamp for the range

period_interval

Specifies the length of each candlestick period, in minutes. Must be one minute, one hour, or one day.

Response

GET `/series/{series_ticker}/markets/{ticker}/candlesticks`

Get Market Candlesticks

series_ticker

Series ticker - the series that contains the target market

ticker

Market ticker - unique identifier for the specific market

start_ts

Start timestamp (Unix timestamp). Candlesticks will include those ending on or after this time.

end_ts

End timestamp (Unix timestamp). Candlesticks will include those ending on or before this time.

period_interval

Time period length of each candlestick in minutes. Valid values: 1 (1 minute), 60 (1 hour), 1440 (1 day).

Response

GET `/structured_targets`

Get Structured Targets

type

Type of structured target

competition

Competition filter

page_size

Page size (min: 1, max: 2000)

cursor

Pagination cursor

Response

GET `/structured_targets/{structured_target_id}`

Get Structured Target

structured_target_id

Structured Target ID

Response

Kalshi Trade API

API Endpoints

GET /api_keys

POST /api_keys

POST /api_keys/generate

DELETE /api_keys/{api_key}

GET /cached/events/{ticker}/forecast_history

GET /communications/id

GET /communications/quotes

POST /communications/quotes

DELETE /communications/quotes/{quote_id}

GET /communications/quotes/{quote_id}

PUT /communications/quotes/{quote_id}/accept

PUT /communications/quotes/{quote_id}/confirm

GET /communications/rfqs

POST /communications/rfqs

DELETE /communications/rfqs/{rfq_id}

GET /communications/rfqs/{rfq_id}

GET /events

GET /events/{event_ticker}

GET /events/{event_ticker}/metadata

GET /exchange/announcements

GET /exchange/schedule

GET /exchange/status

GET /exchange/user_data_timestamp

GET /incentive_programs

GET /markets

GET /markets/trades

GET /markets/{ticker}

GET /markets/{ticker}/orderbook

GET /milestones

GET /milestones/{milestone_id}

GET /multivariate_event_collections

GET /multivariate_event_collections/{collection_ticker}

POST /multivariate_event_collections/{collection_ticker}

GET /multivariate_event_collections/{collection_ticker}/lookup

PUT /multivariate_event_collections/{collection_ticker}/lookup

GET /portfolio/balance

GET /portfolio/fills

GET /portfolio/order_groups

POST /portfolio/order_groups/create

DELETE /portfolio/order_groups/{order_group_id}

GET /portfolio/order_groups/{order_group_id}

PUT /portfolio/order_groups/{order_group_id}/reset

GET /portfolio/orders

POST /portfolio/orders

DELETE /portfolio/orders/batched

POST /portfolio/orders/batched

GET /portfolio/orders/queue_positions

DELETE /portfolio/orders/{order_id}

GET /portfolio/orders/{order_id}

POST /portfolio/orders/{order_id}/amend

POST /portfolio/orders/{order_id}/decrease

GET /portfolio/orders/{order_id}/queue_position

GET /portfolio/positions

GET /portfolio/settlements

GET /portfolio/summary/total_resting_order_value

GET /series

GET /series/fee_changes

GET /series/{series_ticker}

GET /series/{series_ticker}/events/{ticker}/candlesticks

GET /series/{series_ticker}/markets/{ticker}/candlesticks

GET /structured_targets

GET /structured_targets/{structured_target_id}

GET `/api_keys`

POST `/api_keys`

POST `/api_keys/generate`

DELETE `/api_keys/{api_key}`

GET `/cached/events/{ticker}/forecast_history`

GET `/communications/id`

GET `/communications/quotes`

POST `/communications/quotes`

DELETE `/communications/quotes/{quote_id}`

GET `/communications/quotes/{quote_id}`

PUT `/communications/quotes/{quote_id}/accept`

PUT `/communications/quotes/{quote_id}/confirm`

GET `/communications/rfqs`

POST `/communications/rfqs`

DELETE `/communications/rfqs/{rfq_id}`

GET `/communications/rfqs/{rfq_id}`

GET `/events`

GET `/events/{event_ticker}`

GET `/events/{event_ticker}/metadata`

GET `/exchange/announcements`

GET `/exchange/schedule`

GET `/exchange/status`

GET `/exchange/user_data_timestamp`

GET `/incentive_programs`

GET `/markets`

GET `/markets/trades`

GET `/markets/{ticker}`

GET `/markets/{ticker}/orderbook`

GET `/milestones`

GET `/milestones/{milestone_id}`

GET `/multivariate_event_collections`

GET `/multivariate_event_collections/{collection_ticker}`

POST `/multivariate_event_collections/{collection_ticker}`

GET `/multivariate_event_collections/{collection_ticker}/lookup`

PUT `/multivariate_event_collections/{collection_ticker}/lookup`

GET `/portfolio/balance`

GET `/portfolio/fills`

GET `/portfolio/order_groups`

POST `/portfolio/order_groups/create`

DELETE `/portfolio/order_groups/{order_group_id}`

GET `/portfolio/order_groups/{order_group_id}`

PUT `/portfolio/order_groups/{order_group_id}/reset`

GET `/portfolio/orders`

POST `/portfolio/orders`

DELETE `/portfolio/orders/batched`

POST `/portfolio/orders/batched`

GET `/portfolio/orders/queue_positions`

DELETE `/portfolio/orders/{order_id}`

GET `/portfolio/orders/{order_id}`

POST `/portfolio/orders/{order_id}/amend`

POST `/portfolio/orders/{order_id}/decrease`

GET `/portfolio/orders/{order_id}/queue_position`

GET `/portfolio/positions`

GET `/portfolio/settlements`

GET `/portfolio/summary/total_resting_order_value`

GET `/series`

GET `/series/fee_changes`

GET `/series/{series_ticker}`

GET `/series/{series_ticker}/events/{ticker}/candlesticks`

GET `/series/{series_ticker}/markets/{ticker}/candlesticks`

GET `/structured_targets`

GET `/structured_targets/{structured_target_id}`