Kalshi

Trade on Kalshi prediction markets via a self-contained CLI script. Supports market search, portfolio tracking, and full order lifecycle (place/cancel/monitor).

Quick Start

All commands route through a single script. Output is JSON.

CLI

Primary script:

CODEBLOCK0

Helper script:

CODEBLOCK1

Combines market details + orderbook in a single call for fast analysis.

Commands

Examples

CODEBLOCK2

Output

All commands output JSON to stdout. Parse the result to present it to the user.

Trading Rules

Critical: ALWAYS confirm with the user before placing any buy or sell order.

Before executing a trade, show the user:

• - Ticker
• Side (YES or NO)
• Count (number of contracts)
• Price (in cents)
• Total cost = count × price cents = $X.XX

Price format:

• - Prices are in cents (1-99)
• 65 cents = $0.65 per contract
• Minimum: 1 cent, Maximum: 99 cents

Payouts:

• - All contracts pay $1.00 (100 cents) if correct, $0 if wrong
• YES at 65¢: costs 65¢, pays $1.00 if YES wins → 35¢ profit per contract
• NO at 35¢: costs 35¢, pays $1.00 if NO wins → 65¢ profit per contract
• YES price + NO price ≈ 100¢ (spreads cause small deviations)

Before selling: Verify the user holds the position by checking portfolio first

Reference Documentation

• - setup-guide.md - Getting API credentials, configuration, troubleshooting
• trading-guide.md - Market mechanics, strategy tips, risk management
• api-notes.md - Technical API details, data formats, common patterns

Environment Variables

Required:

• - KALSHI_API_KEY_ID — your Kalshi API key UUID
• INLINECODE12 — absolute path to your RSA private key PEM file

See setup-guide.md for detailed configuration instructions.