Kalshi Trading

Full access to Kalshi prediction markets: search, trade, stream real-time data, and use advanced order types (TWAP, bracket, trigger).

Required Environment Variables

KALSHI_API_KEY_ID=your_api_key_id KALSHI_PRIVATE_KEY=your_private_key_pem_contents

OR

KALSHI_PRIVATE_KEY_PATH=/path/to/private_key.pem

Authentication uses RSA key-pair signing (not email/password). Generate an API key from the Kalshi dashboard.

Optional:

DRY_RUN=true # Simulate trades without executing

Commands

Market Data

/kalshi search <query> - Search markets /kalshi market <ticker> - Market details /kalshi book <ticker> - View orderbook (REST snapshot) /kalshi events [query] - Browse events /kalshi event <event-ticker> - Event details + markets

Trading

/kalshi buy <ticker> <contracts> <price> - Buy YES contracts /kalshi sell <ticker> <contracts> <price> - Sell YES contracts /kalshi orders - View open orders /kalshi cancel <order-id> - Cancel an order /kalshi cancel all - Cancel all orders /kalshi balance - Account balance

Advanced Orders

/kalshi twap <buy|sell> <ticker> <total> <price> [slices] [interval-sec] /kalshi twap status - Active TWAP progress /kalshi twap cancel <id> - Cancel TWAP

/kalshi bracket <ticker> <size> <tp> <sl> - Set take-profit / stop-loss /kalshi bracket status - Active brackets /kalshi bracket cancel <id> - Cancel bracket

/kalshi trigger buy <ticker> <size> <price> [limit] - Buy when price drops /kalshi trigger sell <ticker> <size> <price> [limit] - Sell when price rises /kalshi trigger list - Active triggers /kalshi trigger cancel <id> - Cancel trigger

Real-Time Streaming (WebSocket)

/kalshi stream <ticker> [channels] - Start streaming (ticker,trade,orderbook) /kalshi stream-fills - Stream your order fills /kalshi streams - List active streams /kalshi unstream <ticker> - Stop streaming a market /kalshi unstream-fills - Stop fill notifications /kalshi realtime-book <ticker> - Get real-time orderbook from stream

Cross-Platform

/kalshi route <ticker> <buy|sell> <size> - Compare prices across platforms /kalshi circuit - Circuit breaker status

Examples

/kalshi search bitcoin /kalshi market KXBTC-24JAN01 /kalshi book KXBTC-24JAN01 /kalshi buy KXBTC-24JAN01 10 0.65 /kalshi sell KXBTC-24JAN01 5 0.70 /kalshi stream KXBTC-24JAN01 ticker,trade /kalshi twap buy KXBTC-24JAN01 50 0.60 10 30 /kalshi bracket KXBTC-24JAN01 10 0.80 0.40 /kalshi trigger buy KXBTC-24JAN01 10 45

Notes

• Prices are in decimal format for commands (0.65 = 65 cents)

• Trigger prices are in cents (45 = 45 cents)

• Contracts pay $1 if correct; cost is the price

• Circuit breaker integration blocks trades when risk limits are hit

• Trigger orders poll every 5 seconds