Kalshi CLI Trading

Trade prediction markets on Kalshi using the kalshi-cli command-line tool. Use when the user wants to trade event contracts, browse prediction markets, place orders, manage positions, stream live prices, or view candlestick charts. Also use when they mention "prediction market," "event contract," "kalshi," "YES/NO," "order book," "limit order," "market order," "hedge," "arbitrage," or "liquidity rewards."

Lacy Morrow@lacymorrow

Install

openclaw skills install @lacymorrow/kalshi-cli-trading

Kalshi Trading Skill

Trade CFTC-regulated prediction markets on Kalshi through the kalshi-cli command-line tool. Browse markets, place limit and market orders, manage positions, stream real-time prices, and view ASCII candlestick charts — all from the terminal.

Kalshi is fully legal in the US. No crypto wallets, no blockchain, no gas fees — everything settles in USD.

Installation

macOS / Linux (Homebrew)

bash

brew install 6missedcalls/tap/kalshi-cli

Go Install (requires Go 1.25+)

bash

go install github.com/6missedcalls/kalshi-cli/cmd/kalshi-cli@latest

Build from Source

bash

git clone https://github.com/6missedcalls/kalshi-cli.git
cd kalshi-cli
go build -o kalshi-cli ./cmd/kalshi-cli

Authentication

Interactive Login (Recommended first time)

bash

kalshi-cli auth login

Follow the prompts to:

Copy the displayed public key
Add it to your Kalshi account at https://kalshi.com/account/api-keys
Enter the API Key ID when prompted

Credentials are stored securely in your OS keyring (macOS Keychain, GNOME Keyring, or Windows Credential Manager).

Non-Interactive Login (Bots / CI)

bash

# Via flags
kalshi-cli auth login --api-key-id YOUR_KEY_ID --private-key-file /path/to/key.pem

# Via PEM content
kalshi-cli auth login --api-key-id YOUR_KEY_ID --private-key "$(cat /path/to/key.pem)"

# Via environment variables
export KALSHI_API_KEY_ID=your-key-id
export KALSHI_PRIVATE_KEY="$(cat /path/to/key.pem)"
kalshi-cli auth login

Config File

Add to ~/.kalshi/config.yaml:

yaml

api_key_id: your-key-id
private_key_path: /path/to/key.pem

Credentials are resolved in order: config file, environment variables, OS keyring.

Demo vs Production

	Demo (default)	Production
Flag	(default)	`--prod`
API	`demo-api.kalshi.co`	`api.elections.kalshi.com`
Money	Fake/test	Real USD

The CLI defaults to demo mode. You must pass --prod to trade with real money. This is a safety feature.

Overview

You are an expert in using kalshi-cli for prediction market trading on Kalshi. Your goal is to help users trade event contracts efficiently while emphasizing safety and risk awareness.

How to Use This Skill

Safety First: The CLI defaults to demo mode. Only use --prod when the user explicitly wants real trading.
Verify Before Trading: Always show the exact command and confirm with the user before executing trades.
Check Prerequisites: Confirm auth is set up (auth status), exchange is active (exchange status), and sufficient balance exists.
Use JSON Output: For scripting and automation, use --json for machine-readable output.
Understand Tickers: Markets use structured tickers like KXBTC-26FEB12-B97000. Events group related markets.

When to Use This Skill

Use this skill when the user wants to:

Browse or search prediction markets (politics, crypto, sports, economics, weather)
Place bets (limit orders, market orders) on event contracts
Check market prices, spreads, and order books
View ASCII candlestick charts
Stream live price updates via WebSocket
View or manage open orders
Check portfolio positions and P/L
Cancel or amend orders
Monitor trade fills and settlements
Use batch orders for market-making strategies

Common trigger phrases:

"What prediction markets are open on Kalshi?"
"Buy YES on Bitcoin above 100k"
"Show me the order book"
"Stream live prices for this market"
"Show me a candlestick chart"
"Cancel all my orders"
"Check my positions"
"Place a limit order at 50 cents"
"What's my balance?"

When NOT to use this skill:

User wants to trade stocks/ETFs/options (use Alpaca trading skill)
User wants to trade on Polymarket (use Polymarket trading skill)
User wants financial advice (provide tools, not recommendations)

Key Concepts

Tickers

Markets use structured tickers: KXBTC-26FEB12-B97000

KXBTC = series (Bitcoin)
26FEB12 = date (Feb 12, 2026)
B97000 = strike ($97,000)

Events vs Markets

An event groups related markets. For example, "Bitcoin price on Feb 12" is an event containing markets at different strike prices ($90K, $95K, $100K, etc.).

Contracts

Kalshi trades event contracts priced 1-99 cents, settling to $1 or $0. All values are in cents.

Subaccounts

Up to 32 subaccounts per user for multi-strategy isolation.

Order Groups

Cap total fills across multiple orders — useful for market-making where you don't want both sides filled.

Global Flags

Every command accepts these flags:

Flag	Short	Default	Description
`--json`		`false`	Output as JSON for scripts
`--plain`		`false`	Plain text for piping
`--yes`	`-y`	`false`	Skip all confirmation prompts
`--prod`		`false`	Use production API (real money)
`--verbose`	`-v`	`false`	Debug output
`--config`		`~/.kalshi/config.yaml`	Config file path

Core Commands

Authentication

bash

kalshi-cli auth login                        # interactive login
kalshi-cli auth login --api-key-id ID --private-key-file /path/to/key.pem  # non-interactive
kalshi-cli auth logout                       # remove stored credentials
kalshi-cli auth status                       # check auth status + environment
kalshi-cli auth keys list                    # list API keys
kalshi-cli auth keys create --name "my-bot"  # create new API key
kalshi-cli auth keys delete KEY_ID           # delete API key

Market Discovery

List markets:

bash

kalshi-cli markets list --status open --limit 20
kalshi-cli markets list --series KXBTC --json

Flags: --status (open/closed/settled), --series (filter by series ticker), --limit (default 50).

Get market details:

bash

kalshi-cli markets get KXBTC-26FEB12-B97000

View order book:

bash

kalshi-cli markets orderbook KXBTC-26FEB12-B97000
kalshi-cli markets orderbook KXBTC-26FEB12-B97000 --json

View recent trades:

bash

kalshi-cli markets trades KXBTC-26FEB12-B97000 --limit 20

View candlestick chart:

bash

kalshi-cli markets candlesticks KXBTC-26FEB12-B97000 --series KXBTC
kalshi-cli markets candlesticks KXBTC-26FEB12-B97000 --series KXBTC --period 1d
# Periods: 1m, 1h, 1d

Browse series (categories of markets):

bash

kalshi-cli markets series list --category Economics
kalshi-cli markets series list --category Crypto
kalshi-cli markets series list --category Politics
kalshi-cli markets series get KXBTC

Events

List events:

bash

kalshi-cli events list --limit 20
kalshi-cli events list --status active

Flags: --status (active/closed/settled), --limit, --cursor.

Get event details:

bash

kalshi-cli events get KXBTC-26FEB12

Event candlestick chart:

bash

kalshi-cli events candlesticks KXINXU-26FEB11H1600 --period 1h \
  --start 2026-02-10T00:00:00Z --end 2026-02-11T23:00:00Z

Multivariate events:

bash

kalshi-cli events multivariate list --limit 10
kalshi-cli events multivariate get TICKER

Trading

Place a limit order:

bash

kalshi-cli orders create --market KXBTC-26FEB12-B97000 --side yes --qty 10 --price 50

Place a market order:

bash

kalshi-cli orders create --market KXBTC-26FEB12-B97000 --side yes --qty 10 --type market

Sell contracts:

bash

kalshi-cli orders create --market KXBTC-26FEB12-B97000 --side no --qty 5 --price 30 --action sell

Skip confirmation (for bots):

bash

kalshi-cli orders create --market KXBTC-26FEB12-B97000 --side yes --qty 10 --price 50 --yes --json

Production trading (real money):

bash

kalshi-cli --prod orders create --market KXBTC-26FEB12-B97000 --side yes --qty 10 --price 50

Order flags:

Flag	Required	Default	Description
`--market`	Yes		Market ticker
`--side`	Yes		`yes` or `no`
`--qty`	Yes		Number of contracts
`--price`	Yes (limit)		Price in cents (1-99)
`--action`	No	`buy`	`buy` or `sell`
`--type`	No	`limit`	`limit` or `market`

Amend an order:

bash

kalshi-cli orders amend ORDER_ID --price 55
kalshi-cli orders amend ORDER_ID --qty 20
kalshi-cli orders amend ORDER_ID --price 55 --qty 20

Cancel orders:

bash

kalshi-cli orders cancel ORDER_ID
kalshi-cli orders cancel-all
kalshi-cli orders cancel-all --market KXBTC-26FEB12-B97000

List and inspect orders:

bash

kalshi-cli orders list --status resting
kalshi-cli orders list --market KXBTC-26FEB12-B97000 --json
kalshi-cli orders get ORDER_ID
kalshi-cli orders queue ORDER_ID  # check queue position

Batch create orders from JSON file:

bash

kalshi-cli orders batch-create --file orders.json

The JSON file format:

json

[
  { "ticker": "MARKET1", "side": "yes", "action": "buy", "type": "limit", "count": 10, "yes_price": 50 },
  { "ticker": "MARKET2", "side": "no", "action": "buy", "type": "limit", "count": 5, "no_price": 30 }
]

Portfolio

Check balance:

bash

kalshi-cli portfolio balance
kalshi-cli portfolio balance --json

All values are in cents. Example JSON:

json

{ "available_balance": 10000, "portfolio_value": 5000, "total_balance": 15000 }

View positions:

bash

kalshi-cli portfolio positions
kalshi-cli portfolio positions --market KXBTC-26FEB12-B97000

View trade fills:

bash

kalshi-cli portfolio fills --limit 50

View settlements (resolved market payouts):

bash

kalshi-cli portfolio settlements --limit 20

Subaccount management:

bash

kalshi-cli portfolio subaccounts list
kalshi-cli portfolio subaccounts create
kalshi-cli portfolio subaccounts transfer --from 1 --to 2 --amount 50000  # $500 in cents

Order Groups

Order groups cap total fills across multiple orders — useful for market-making. Alias: og.

bash

kalshi-cli order-groups create --limit 100          # max 100 contracts across group
kalshi-cli order-groups list
kalshi-cli og list --status active                  # alias
kalshi-cli order-groups get GROUP_ID
kalshi-cli order-groups update-limit GROUP_ID --limit 200
kalshi-cli order-groups reset GROUP_ID              # reset filled count
kalshi-cli order-groups trigger GROUP_ID             # execute orders
kalshi-cli order-groups delete GROUP_ID              # cancels all orders in group

RFQ (Request for Quotes / Block Trading)

bash

kalshi-cli rfq create --market KXBTC-26FEB12-B97000 --qty 1000
kalshi-cli rfq list --status open
kalshi-cli rfq get RFQ_ID
kalshi-cli rfq delete RFQ_ID

Quotes (Respond to RFQs)

bash

kalshi-cli quotes list --rfq-id RFQ_ID
kalshi-cli quotes create --rfq RFQ_ID --price 65
kalshi-cli quotes accept QUOTE_ID
kalshi-cli quotes confirm QUOTE_ID

Real-Time Streaming (WebSocket)

All watch commands require auth. Press Ctrl+C to stop. Auto-reconnects with exponential backoff.

bash

kalshi-cli watch ticker KXBTC-26FEB12-B97000       # live price updates
kalshi-cli watch orderbook KXBTC-26FEB12-B97000     # orderbook deltas
kalshi-cli watch trades                              # all public trades
kalshi-cli watch trades --market KXBTC-26FEB12-B97000  # trades for one market
kalshi-cli watch orders                              # your order status changes
kalshi-cli watch fills                               # your fill notifications
kalshi-cli watch positions                           # your position changes

# JSON output for programmatic consumption
kalshi-cli watch ticker KXBTC-26FEB12-B97000 --json

Exchange Info

bash

kalshi-cli exchange status         # exchange status, trading active?
kalshi-cli exchange schedule       # trading schedule
kalshi-cli exchange announcements  # latest announcements

Configuration

bash

kalshi-cli config show                      # all settings
kalshi-cli config get output.format         # get a setting
kalshi-cli config set output.format json    # change default output
kalshi-cli config set defaults.limit 100    # change default list limit

Config file: ~/.kalshi/config.yaml

Utility Commands

bash

kalshi-cli version                 # print version
kalshi-cli completion bash         # shell autocompletion
kalshi-cli completion zsh

Environment Variables

Variable	Description
`KALSHI_API_KEY_ID`	API Key ID
`KALSHI_PRIVATE_KEY`	Private key PEM content
`KALSHI_PRIVATE_KEY_FILE`	Path to private key PEM file
`KALSHI_API_PRODUCTION`	`true` for production
`KALSHI_API_TIMEOUT`	HTTP timeout (e.g., `60s`)
`KALSHI_OUTPUT_FORMAT`	Default output format

Output Formats

All commands support --json, --plain, and default table output.

bash

# Human-readable table (default)
kalshi-cli markets list --limit 5

# Machine-readable JSON
kalshi-cli --json markets list --limit 5

# Plain text for piping
kalshi-cli --plain portfolio balance

Exit codes: 0=success, 1=general error, 2=auth error, 3=validation error, 4=API error, 5=network error.

Common Workflows

Browse markets and research

bash

# 1. Browse by category
kalshi-cli markets series list --category Crypto

# 2. List open markets in a series
kalshi-cli markets list --series KXBTC --status open

# 3. Get market details
kalshi-cli markets get KXBTC-26FEB12-B97000

# 4. Check the order book
kalshi-cli markets orderbook KXBTC-26FEB12-B97000

# 5. View candlestick chart
kalshi-cli markets candlesticks KXBTC-26FEB12-B97000 --series KXBTC --period 1h

# 6. View recent trades
kalshi-cli markets trades KXBTC-26FEB12-B97000 --limit 10

Place a limit order and monitor

bash

# 1. Check balance
kalshi-cli portfolio balance

# 2. Place limit order (demo mode)
kalshi-cli orders create --market KXBTC-26FEB12-B97000 --side yes --qty 10 --price 50

# 3. Check order status
kalshi-cli orders list --status resting

# 4. Check queue position
kalshi-cli orders queue ORDER_ID

# 5. Amend if needed
kalshi-cli orders amend ORDER_ID --price 52

# 6. Or cancel
kalshi-cli orders cancel ORDER_ID

Market making with order groups

bash

# 1. Create an order group (cap total fills)
kalshi-cli order-groups create --limit 50

# 2. Place orders on both sides
kalshi-cli orders create --market TICKER --side yes --action buy --qty 10 --price 45 --yes
kalshi-cli orders create --market TICKER --side yes --action sell --qty 10 --price 55 --yes

# 3. Monitor fills
kalshi-cli watch fills

Bot automation (market-making script)

bash

#!/bin/bash
MARKET="KXBTC-26FEB12-B97000"
BOOK=$(kalshi-cli markets orderbook $MARKET --json)
BEST_BID=$(echo $BOOK | jq '.yes_bids[0].price // 0')
BEST_ASK=$(echo $BOOK | jq '.yes_asks[0].price // 100')

kalshi-cli orders create --market $MARKET --side yes --action buy  --qty 10 --price $((BEST_BID + 1)) --yes --json
kalshi-cli orders create --market $MARKET --side yes --action sell --qty 10 --price $((BEST_ASK - 1)) --yes --json

Stream live prices

bash

# Terminal display
kalshi-cli watch ticker KXBTC-26FEB12-B97000

# Pipe JSON to a script
kalshi-cli watch ticker KXBTC-26FEB12-B97000 --json | while read line; do
  PRICE=$(echo $line | jq '.yes_price')
  echo "Current price: $PRICE"
done

Portfolio review

bash

kalshi-cli portfolio balance --json | jq '{available: .available_balance, total: .total_balance}'
kalshi-cli portfolio positions --json | jq '.[] | {ticker, position, pnl}'
kalshi-cli portfolio fills --limit 10
kalshi-cli portfolio settlements --limit 10

Go live (production)

bash

# Verify you're on demo first
kalshi-cli auth status

# Switch to production for a single command
kalshi-cli --prod orders create --market KXBTC-26FEB12-B97000 --side yes --qty 10 --price 50

# Or set globally
export KALSHI_API_PRODUCTION=true

Best Practices

Safety

Demo first — the CLI defaults to demo mode. Test everything before going live.
Confirm before --prod — always verify with kalshi-cli auth status before trading real money.
Use --yes carefully — it skips all confirmations. Only use in tested bot scripts.
Set position limits — use order groups to cap maximum exposure.
Monitor positions — use kalshi-cli watch positions for real-time tracking.

Order Management

Prefer limit orders — better price control, lower fees.
Use order groups for market-making — prevents both sides from filling simultaneously.
Amend instead of cancel/replace — native orders amend is atomic and faster.
Batch when possible — use orders batch-create with a JSON file for multiple orders.
Check queue position — use orders queue to see where your resting order sits.

Bot Development

Use --json --yes — machine-parseable output, no interactive prompts.
Check exit codes — 0=success, 2=auth error, 4=API error, 5=network error.
Handle rate limits — Basic: 10 writes/sec, 20 reads/sec. Apply for higher tiers if needed.
Use WebSocket for live data — watch ticker is more efficient than polling.
Store credentials securely — use env vars or keyring, never hardcode.

Command Reference

Task	Command
Auth
Login	`kalshi-cli auth login`
Check status	`kalshi-cli auth status`
List API keys	`kalshi-cli auth keys list`
Markets
List markets	`kalshi-cli markets list --status open --limit 20`
Get market	`kalshi-cli markets get TICKER`
Order book	`kalshi-cli markets orderbook TICKER`
Recent trades	`kalshi-cli markets trades TICKER --limit 20`
Candlestick chart	`kalshi-cli markets candlesticks TICKER --series SERIES --period 1h`
Browse series	`kalshi-cli markets series list --category Crypto`
Events
List events	`kalshi-cli events list --status active --limit 20`
Get event	`kalshi-cli events get EVENT_TICKER`
Event chart	`kalshi-cli events candlesticks EVENT_TICKER --period 1h`
Trading
Limit order (buy YES)	`kalshi-cli orders create --market TICKER --side yes --qty 10 --price 50`
Market order	`kalshi-cli orders create --market TICKER --side yes --qty 10 --type market`
Sell contracts	`kalshi-cli orders create --market TICKER --side no --qty 5 --price 30 --action sell`
Amend order	`kalshi-cli orders amend ORDER_ID --price 55`
Cancel order	`kalshi-cli orders cancel ORDER_ID`
Cancel all	`kalshi-cli orders cancel-all`
Batch create	`kalshi-cli orders batch-create --file orders.json`
List resting orders	`kalshi-cli orders list --status resting`
Queue position	`kalshi-cli orders queue ORDER_ID`
Portfolio
Balance	`kalshi-cli portfolio balance`
Positions	`kalshi-cli portfolio positions`
Fills	`kalshi-cli portfolio fills --limit 50`
Settlements	`kalshi-cli portfolio settlements`
Subaccounts
List	`kalshi-cli portfolio subaccounts list`
Create	`kalshi-cli portfolio subaccounts create`
Transfer	`kalshi-cli portfolio subaccounts transfer --from 1 --to 2 --amount 50000`
Order Groups
Create group	`kalshi-cli order-groups create --limit 100`
List groups	`kalshi-cli og list`
Update limit	`kalshi-cli order-groups update-limit GROUP_ID --limit 200`
Delete group	`kalshi-cli order-groups delete GROUP_ID`
Block Trading
Create RFQ	`kalshi-cli rfq create --market TICKER --qty 1000`
List RFQs	`kalshi-cli rfq list`
Create quote	`kalshi-cli quotes create --rfq RFQ_ID --price 65`
Accept quote	`kalshi-cli quotes accept QUOTE_ID`
Streaming
Live prices	`kalshi-cli watch ticker TICKER`
Orderbook deltas	`kalshi-cli watch orderbook TICKER`
Public trades	`kalshi-cli watch trades`
Your orders	`kalshi-cli watch orders`
Your fills	`kalshi-cli watch fills`
Your positions	`kalshi-cli watch positions`
Exchange
Exchange status	`kalshi-cli exchange status`
Schedule	`kalshi-cli exchange schedule`
Announcements	`kalshi-cli exchange announcements`
Config
Show config	`kalshi-cli config show`
Set value	`kalshi-cli config set output.format json`

Important Notes

All values in cents — prices are 1-99, balances are in cents ($100 = 10000 cents).
Demo by default — use --prod flag for real trading.
Tickers are structured — KXBTC-26FEB12-B97000 = series + date + strike.
Events group markets — browse events to find related markets at different strike levels.
Order groups cap total fills — essential for market-making strategies.
Rate limits — Basic: 10 writes/sec, 20 reads/sec. Apply for higher tiers via Kalshi.
RSA-PSS auth — private key never leaves your machine. No passwords, no sessions to manage.
USD settlement — no crypto, no wallets, no gas fees.
CFTC-regulated — fully legal in the United States.

Fees

Type	Formula	Max at 50/50
Taker	`roundup(0.07 * C * P * (1-P))`	1.75c/contract
Maker	`roundup(0.0175 * C * P * (1-P))`	~0.44c/contract
S&P/Nasdaq markets	Half the normal rate	~0.88c taker

Lower fees for orders near the extremes (close to 0 or 100). No settlement or withdrawal fees (ACH).

Troubleshooting

Not authenticated

bash

kalshi-cli auth status  # check status
kalshi-cli auth login   # re-authenticate

Wrong environment (demo vs prod)

bash

kalshi-cli auth status  # shows current environment
# Use --prod for production, omit for demo

Order rejected

Check balance: kalshi-cli portfolio balance
Verify market is open: kalshi-cli markets get TICKER
Check exchange status: kalshi-cli exchange status
Price must be 1-99 cents

Rate limited

Basic tier: 10 writes/sec, 20 reads/sec
Apply for Advanced/Premier tier at Kalshi for higher limits
Use batch operations where possible

Additional Resources

kalshi-cli: https://github.com/6missedcalls/kalshi-cli
Kalshi API Docs: https://docs.kalshi.com/welcome
Kalshi Fee Schedule: https://kalshi.com/fee-schedule
Liquidity Incentive Program: https://help.kalshi.com/incentive-programs/liquidity-incentive-program
Kalshi Python SDK: https://pypi.org/project/kalshi-python/
Kalshi TypeScript SDK: https://www.npmjs.com/package/kalshi-typescript

Kalshi CLI Trading

Install

Kalshi Trading Skill

Installation

macOS / Linux (Homebrew)

Go Install (requires Go 1.25+)

Build from Source

Authentication

Interactive Login (Recommended first time)

Non-Interactive Login (Bots / CI)

Config File

Demo vs Production

Overview

How to Use This Skill

When to Use This Skill

Key Concepts

Tickers

Events vs Markets

Contracts

Subaccounts

Order Groups

Global Flags

Core Commands

Authentication

Market Discovery

Events

Trading

Portfolio

Order Groups

RFQ (Request for Quotes / Block Trading)

Quotes (Respond to RFQs)

Real-Time Streaming (WebSocket)

Exchange Info

Configuration

Utility Commands

Environment Variables

Output Formats

Common Workflows

Browse markets and research

Place a limit order and monitor

Market making with order groups

Bot automation (market-making script)

Stream live prices

Portfolio review

Go live (production)

Best Practices

Safety

Order Management

Bot Development

Command Reference

Important Notes

Fees

Troubleshooting

Not authenticated

Wrong environment (demo vs prod)

Order rejected

Rate limited

Additional Resources

Related skills