Kalshi
Access prediction markets and trade on Kalshi
Configuration
Get Markets
Operation
Get Markets
Status
Select...
Series Ticker
Filter by series ticker
Event Ticker
Event ticker
Limit
Number of results (1-1000, default: 100)
Cursor
Pagination cursor
Get Markets (
kalshi_get_markets)Retrieve a list of prediction markets from Kalshi with optional filtering
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status (unopened, open, closed, settled) |
seriesTicker | string | No | Filter by series ticker |
eventTicker | string | No | Filter by event ticker |
limit | string | No | Number of results (1-1000, default: 100) |
cursor | string | No | Pagination cursor for next page |
Output
| Parameter | Type | Description |
|---|---|---|
markets | array | Array of market objects |
paging | object | Pagination cursor for fetching more results |
Get Market
Operation
Get Market
Market Ticker*
Market ticker (e.g., KXBTC-24DEC31)
Get Market (
kalshi_get_market)Retrieve details of a specific prediction market by ticker
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker | string | Yes | The market ticker (e.g., "KXBTC-24DEC31") |
Output
| Parameter | Type | Description |
|---|---|---|
market | object | Market object with details |
Get Events
Operation
Get Events
Status
Select...
Series Ticker
Filter by series ticker
Include Markets
Select...
Limit
Number of results (1-1000, default: 100)
Cursor
Pagination cursor
Get Events (
kalshi_get_events)Retrieve a list of events from Kalshi with optional filtering
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status (open, closed, settled) |
seriesTicker | string | No | Filter by series ticker |
withNestedMarkets | string | No | Include nested markets in response (true/false) |
limit | string | No | Number of results (1-200, default: 200) |
cursor | string | No | Pagination cursor for next page |
Output
| Parameter | Type | Description |
|---|---|---|
events | array | Array of event objects |
paging | object | Pagination cursor for fetching more results |
Get Event
Operation
Get Event
Event Ticker*
Event ticker
Include Markets
Select...
Get Event (
kalshi_get_event)Retrieve details of a specific event by ticker
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
eventTicker | string | Yes | The event ticker |
withNestedMarkets | string | No | Include nested markets in response (true/false) |
Output
| Parameter | Type | Description |
|---|---|---|
event | object | Event object with details |
Get Balance
Operation
Get Balance
API Key ID*
Your Kalshi API Key ID
Private Key*
Your RSA Private Key (PEM format)
Get Balance (
kalshi_get_balance)Retrieve your account balance and portfolio value from Kalshi
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
keyId | string | Yes | Your Kalshi API Key ID |
privateKey | string | Yes | Your RSA Private Key (PEM format) |
Output
| Parameter | Type | Description |
|---|---|---|
balance | number | Account balance in cents |
portfolioValue | number | Portfolio value in cents |
Get Positions
Operation
Get Positions
API Key ID*
Your Kalshi API Key ID
Private Key*
Your RSA Private Key (PEM format)
Event Ticker
Event ticker
Market Ticker
Filter by market ticker (optional)
Settlement Status
Select...
Limit
Number of results (1-1000, default: 100)
Cursor
Pagination cursor
Get Positions (
kalshi_get_positions)Retrieve your open positions from Kalshi
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
keyId | string | Yes | Your Kalshi API Key ID |
privateKey | string | Yes | Your RSA Private Key (PEM format) |
ticker | string | No | Filter by market ticker |
eventTicker | string | No | Filter by event ticker (max 10 comma-separated) |
settlementStatus | string | No | Filter by settlement status (all, unsettled, settled). Default: unsettled |
limit | string | No | Number of results (1-1000, default: 100) |
cursor | string | No | Pagination cursor for next page |
Output
| Parameter | Type | Description |
|---|---|---|
positions | array | Array of position objects |
paging | object | Pagination cursor for fetching more results |
Get Orders
Operation
Get Orders
API Key ID*
Your Kalshi API Key ID
Private Key*
Your RSA Private Key (PEM format)
Event Ticker
Event ticker
Market Ticker
Filter by market ticker (optional)
Order Status
Select...
Limit
Number of results (1-1000, default: 100)
Cursor
Pagination cursor
Get Orders (
kalshi_get_orders)Retrieve your orders from Kalshi with optional filtering
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
keyId | string | Yes | Your Kalshi API Key ID |
privateKey | string | Yes | Your RSA Private Key (PEM format) |
ticker | string | No | Filter by market ticker |
eventTicker | string | No | Filter by event ticker (max 10 comma-separated) |
status | string | No | Filter by status (resting, canceled, executed) |
limit | string | No | Number of results (1-200, default: 100) |
cursor | string | No | Pagination cursor for next page |
Output
| Parameter | Type | Description |
|---|---|---|
orders | array | Array of order objects |
paging | object | Pagination cursor for fetching more results |
Get Order
Operation
Get Order
API Key ID*
Your Kalshi API Key ID
Private Key*
Your RSA Private Key (PEM format)
Order ID*
Order ID
Get Order (
kalshi_get_order)Retrieve details of a specific order by ID from Kalshi
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
keyId | string | Yes | Your Kalshi API Key ID |
privateKey | string | Yes | Your RSA Private Key (PEM format) |
orderId | string | Yes | The order ID to retrieve |
Output
| Parameter | Type | Description |
|---|---|---|
order | object | Order object with details |
Get Orderbook
Operation
Get Orderbook
Market Ticker*
Market ticker (e.g., KXBTC-24DEC31)
Get Orderbook (
kalshi_get_orderbook)Retrieve the orderbook (yes and no bids) for a specific market
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker | string | Yes | Market ticker (e.g., KXBTC-24DEC31) |
Output
| Parameter | Type | Description |
|---|---|---|
orderbook | object | Orderbook with yes/no bids and asks |
Get Trades
Operation
Get Trades
Limit
Number of results (1-1000, default: 100)
Cursor
Pagination cursor
Get Trades (
kalshi_get_trades)Retrieve recent trades across all markets
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | string | No | Number of results (1-1000, default: 100) |
cursor | string | No | Pagination cursor for next page |
Output
| Parameter | Type | Description |
|---|---|---|
trades | array | Array of trade objects |
paging | object | Pagination cursor for fetching more results |
Get Candlesticks
Operation
Get Candlesticks
Series Ticker*
Series ticker
Market Ticker*
Market ticker (e.g., KXBTC-24DEC31)
Start Timestamp*
Start timestamp (Unix seconds)
End Timestamp*
End timestamp (Unix seconds)
Period Interval*
Select...
Get Candlesticks (
kalshi_get_candlesticks)Retrieve OHLC candlestick data for a specific market
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
seriesTicker | string | Yes | Series ticker |
ticker | string | Yes | Market ticker (e.g., KXBTC-24DEC31) |
startTs | number | Yes | Start timestamp (Unix seconds) |
endTs | number | Yes | End timestamp (Unix seconds) |
periodInterval | number | Yes | Period interval: 1 (1min), 60 (1hour), or 1440 (1day) |
Output
| Parameter | Type | Description |
|---|---|---|
candlesticks | array | Array of OHLC candlestick data |
Get Fills
Operation
Get Fills
API Key ID*
Your Kalshi API Key ID
Private Key*
Your RSA Private Key (PEM format)
Min Timestamp
Minimum timestamp (Unix milliseconds)
Max Timestamp
Maximum timestamp (Unix milliseconds)
Market Ticker
Filter by market ticker (optional)
Order ID
Filter by order ID (optional)
Limit
Number of results (1-1000, default: 100)
Cursor
Pagination cursor
Get Fills (
kalshi_get_fills)Retrieve your portfolio's fills/trades from Kalshi
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
keyId | string | Yes | Your Kalshi API Key ID |
privateKey | string | Yes | Your RSA Private Key (PEM format) |
ticker | string | No | Filter by market ticker |
orderId | string | No | Filter by order ID |
minTs | number | No | Minimum timestamp (Unix milliseconds) |
maxTs | number | No | Maximum timestamp (Unix milliseconds) |
limit | string | No | Number of results (1-1000, default: 100) |
cursor | string | No | Pagination cursor for next page |
Output
| Parameter | Type | Description |
|---|---|---|
fills | array | Array of fill/trade objects |
paging | object | Pagination cursor for fetching more results |
Get Series by Ticker
Operation
Get Series by Ticker
Series Ticker*
Series ticker
Get Series by Ticker (
kalshi_get_series_by_ticker)Retrieve details of a specific market series by ticker
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
seriesTicker | string | Yes | Series ticker |
Output
| Parameter | Type | Description |
|---|---|---|
series | object | Series object with details |
Get Exchange Status
Operation
Get Exchange Status
Get Exchange Status (
kalshi_get_exchange_status)Retrieve the current status of the Kalshi exchange (trading and exchange activity)
Input
This operation has no direct parameters.
Output
| Parameter | Type | Description |
|---|---|---|
status | object | Exchange status with trading_active and exchange_active flags |
Create Order
Operation
Create Order
API Key ID*
Your Kalshi API Key ID
Private Key*
Your RSA Private Key (PEM format)
Market Ticker*
Market ticker (e.g., KXBTC-24DEC31)
Side*
Select...
Action*
Select...
Contracts*
Number of contracts
Order Type
Select...
Yes Price (cents)
Yes price in cents (1-99)
No Price (cents)
No price in cents (1-99)
Client Order ID
Custom order identifier (optional)
Time in Force
Select...
Expiration
Unix timestamp for order expiration
Post Only
Select...
Reduce Only
Select...
Create Order (
kalshi_create_order)Create a new order on a Kalshi prediction market
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
keyId | string | Yes | Your Kalshi API Key ID |
privateKey | string | Yes | Your RSA Private Key (PEM format) |
ticker | string | Yes | Market ticker (e.g., KXBTC-24DEC31) |
side | string | Yes | Side of the order: 'yes' or 'no' |
action | string | Yes | Action type: 'buy' or 'sell' |
count | string | Yes | Number of contracts (minimum 1) |
type | string | No | Order type: 'limit' or 'market' (default: limit) |
yesPrice | string | No | Yes price in cents (1-99) |
noPrice | string | No | No price in cents (1-99) |
yesPriceDollars | string | No | Yes price in dollars (e.g., "0.56") |
noPriceDollars | string | No | No price in dollars (e.g., "0.56") |
clientOrderId | string | No | Custom order identifier |
expirationTs | string | No | Unix timestamp for order expiration |
timeInForce | string | No | Time in force: 'fill_or_kill', 'good_till_canceled', 'immediate_or_cancel' |
buyMaxCost | string | No | Maximum cost in cents (auto-enables fill_or_kill) |
postOnly | string | No | Set to 'true' for maker-only orders |
reduceOnly | string | No | Set to 'true' for position reduction only |
selfTradePreventionType | string | No | Self-trade prevention: 'taker_at_cross' or 'maker' |
orderGroupId | string | No | Associated order group ID |
Output
| Parameter | Type | Description |
|---|---|---|
order | object | The created order object |
Cancel Order
Operation
Cancel Order
API Key ID*
Your Kalshi API Key ID
Private Key*
Your RSA Private Key (PEM format)
Order ID*
Order ID
Cancel Order (
kalshi_cancel_order)Cancel an existing order on Kalshi
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
keyId | string | Yes | Your Kalshi API Key ID |
privateKey | string | Yes | Your RSA Private Key (PEM format) |
orderId | string | Yes | The order ID to cancel |
Output
| Parameter | Type | Description |
|---|---|---|
order | object | The canceled order object |
reducedBy | number | Number of contracts canceled |
Amend Order
Operation
Amend Order
API Key ID*
Your Kalshi API Key ID
Private Key*
Your RSA Private Key (PEM format)
Order ID*
Order ID
Market Ticker*
Market ticker (e.g., KXBTC-24DEC31)
Side*
Select...
Action*
Select...
Contracts
Updated number of contracts (optional)
Yes Price (cents)
Yes price in cents (1-99)
No Price (cents)
No price in cents (1-99)
Client Order ID*
Original client order ID
New Client Order ID*
New client order ID after amendment
Amend Order (
kalshi_amend_order)Modify the price or quantity of an existing order on Kalshi
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
keyId | string | Yes | Your Kalshi API Key ID |
privateKey | string | Yes | Your RSA Private Key (PEM format) |
orderId | string | Yes | The order ID to amend |
ticker | string | Yes | Market ticker |
side | string | Yes | Side of the order: 'yes' or 'no' |
action | string | Yes | Action type: 'buy' or 'sell' |
clientOrderId | string | Yes | The original client-specified order ID |
updatedClientOrderId | string | Yes | The new client-specified order ID after amendment |
count | string | No | Updated quantity for the order |
yesPrice | string | No | Updated yes price in cents (1-99) |
noPrice | string | No | Updated no price in cents (1-99) |
yesPriceDollars | string | No | Updated yes price in dollars (e.g., "0.56") |
noPriceDollars | string | No | Updated no price in dollars (e.g., "0.56") |
Output
| Parameter | Type | Description |
|---|---|---|
order | object | The amended order object |
Usage Instructions
Integrate Kalshi prediction markets into the workflow. Can get markets, market, events, event, balance, positions, orders, orderbook, trades, candlesticks, fills, series, exchange status, and place/cancel/amend trades.
Notes
- Category:
tools - Type:
kalshi