Agent skill

Kalshi Trading

by LeoYeAI in LeoYeAI/openclaw-master-skills

Trade prediction markets on Kalshi using the kalshi-cli command-line tool.

MITAuto-check passedBusiness, Finance & HR

Install Kalshi Trading

skills CLI
$ npx skills add LeoYeAI/openclaw-master-skills --skill kalshi-trading -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install LeoYeAI/openclaw-master-skills kalshi-trading --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kalshi-cli-trading .claude/skills/kalshi-trading && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kalshi-trading
GitHub stars
2.2k
Token cost
~5.9k tokens
SKILL.md length
1,617 words
Files
4
Skills in repo
1,235
Repo updated
First seen
Licence
MIT

At a glance

Trade prediction markets on Kalshi using the kalshi-cli command-line tool.

  • Works in 3 steps: Copy the displayed public key → Add it to your Kalshi account at… → Enter the API Key ID when prompted
  • The user wants to trade event contracts
  • SKILL.md covers Installation, Authentication, Overview and How to Use This Skill, plus 4 more sections
  • Calls jq, go and brew; reaches github.com; needs KALSHI_API_KEY_ID and KALSHI_PRIVATE_KEY

What it does

Kalshi Trading is an agent skill from LeoYeAI/openclaw-master-skills. 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."

Its SKILL.md is about 5.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `AGENTS.md`, `README.md` and `_meta.json`).

It sits in Business, Finance & HR, covering Trading and backtesting. It works with Kalshi. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.

When your agent uses it

  • The user wants to trade event contracts
  • Browse prediction markets
  • Manage positions
  • Stream live prices

Example prompts

  • “prediction market,”
  • “event contract,”
  • “kalshi,”
  • “/kalshi-trading”

Requirements

  • A credential in KALSHI_PRIVATE_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

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

What it can do on your machine

Read from SKILL.md and the folder at commit e5199b5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • go
    • brew
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    Also links to:

    • kalshi.com
    • docs.kalshi.com
    • help.kalshi.com
    • pypi.org
    • npmjs.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • KALSHI_API_KEY_ID
    • KALSHI_PRIVATE_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kalshi Trading loads about 5.9k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 1,617 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~106
When it runs · the whole SKILL.md, loaded when a task matches
~5.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 1,617 words, ~5,852 tokens.

Download SKILL.mdSave it as .claude/skills/kalshi-trading/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
kalshi-trading
description
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."

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

bash
kalshi-cli auth login

Follow the prompts to:

  1. Copy the displayed public key
  2. Add it to your Kalshi account at https://kalshi.com/account/api-keys
  3. 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
APIdemo-api.kalshi.coapi.elections.kalshi.com
MoneyFake/testReal 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

  1. Safety First: The CLI defaults to demo mode. Only use --prod when the user explicitly wants real trading.
  2. Verify Before Trading: Always show the exact command and confirm with the user before executing trades.
  3. Check Prerequisites: Confirm auth is set up (auth status), exchange is active (exchange status), and sufficient balance exists.
  4. Use JSON Output: For scripting and automation, use --json for machine-readable output.
  5. 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:

FlagShortDefaultDescription
--jsonfalseOutput as JSON for scripts
--plainfalsePlain text for piping
--yes-yfalseSkip all confirmation prompts
--prodfalseUse production API (real money)
--verbose-vfalseDebug output
--config~/.kalshi/config.yamlConfig 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:

FlagRequiredDefaultDescription
--marketYesMarket ticker
--sideYesyes or no
--qtyYesNumber of contracts
--priceYes (limit)Price in cents (1-99)
--actionNobuybuy or sell
--typeNolimitlimit 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

VariableDescription
KALSHI_API_KEY_IDAPI Key ID
KALSHI_PRIVATE_KEYPrivate key PEM content
KALSHI_PRIVATE_KEY_FILEPath to private key PEM file
KALSHI_API_PRODUCTIONtrue for production
KALSHI_API_TIMEOUTHTTP timeout (e.g., 60s)
KALSHI_OUTPUT_FORMATDefault 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
  1. Demo first — the CLI defaults to demo mode. Test everything before going live.
  2. Confirm before --prod — always verify with kalshi-cli auth status before trading real money.
  3. Use --yes carefully — it skips all confirmations. Only use in tested bot scripts.
  4. Set position limits — use order groups to cap maximum exposure.
  5. Monitor positions — use kalshi-cli watch positions for real-time tracking.
Order Management
  1. Prefer limit orders — better price control, lower fees.
  2. Use order groups for market-making — prevents both sides from filling simultaneously.
  3. Amend instead of cancel/replace — native orders amend is atomic and faster.
  4. Batch when possible — use orders batch-create with a JSON file for multiple orders.
  5. Check queue position — use orders queue to see where your resting order sits.
Show full SKILL.md (619 more words)Show less
Bot Development
  1. Use --json --yes — machine-parseable output, no interactive prompts.
  2. Check exit codes — 0=success, 2=auth error, 4=API error, 5=network error.
  3. Handle rate limits — Basic: 10 writes/sec, 20 reads/sec. Apply for higher tiers if needed.
  4. Use WebSocket for live data — watch ticker is more efficient than polling.
  5. Store credentials securely — use env vars or keyring, never hardcode.

Command Reference

TaskCommand
Auth
Loginkalshi-cli auth login
Check statuskalshi-cli auth status
List API keyskalshi-cli auth keys list
Markets
List marketskalshi-cli markets list --status open --limit 20
Get marketkalshi-cli markets get TICKER
Order bookkalshi-cli markets orderbook TICKER
Recent tradeskalshi-cli markets trades TICKER --limit 20
Candlestick chartkalshi-cli markets candlesticks TICKER --series SERIES --period 1h
Browse serieskalshi-cli markets series list --category Crypto
Events
List eventskalshi-cli events list --status active --limit 20
Get eventkalshi-cli events get EVENT_TICKER
Event chartkalshi-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 orderkalshi-cli orders create --market TICKER --side yes --qty 10 --type market
Sell contractskalshi-cli orders create --market TICKER --side no --qty 5 --price 30 --action sell
Amend orderkalshi-cli orders amend ORDER_ID --price 55
Cancel orderkalshi-cli orders cancel ORDER_ID
Cancel allkalshi-cli orders cancel-all
Batch createkalshi-cli orders batch-create --file orders.json
List resting orderskalshi-cli orders list --status resting
Queue positionkalshi-cli orders queue ORDER_ID
Portfolio
Balancekalshi-cli portfolio balance
Positionskalshi-cli portfolio positions
Fillskalshi-cli portfolio fills --limit 50
Settlementskalshi-cli portfolio settlements
Subaccounts
Listkalshi-cli portfolio subaccounts list
Createkalshi-cli portfolio subaccounts create
Transferkalshi-cli portfolio subaccounts transfer --from 1 --to 2 --amount 50000
Order Groups
Create groupkalshi-cli order-groups create --limit 100
List groupskalshi-cli og list
Update limitkalshi-cli order-groups update-limit GROUP_ID --limit 200
Delete groupkalshi-cli order-groups delete GROUP_ID
Block Trading
Create RFQkalshi-cli rfq create --market TICKER --qty 1000
List RFQskalshi-cli rfq list
Create quotekalshi-cli quotes create --rfq RFQ_ID --price 65
Accept quotekalshi-cli quotes accept QUOTE_ID
Streaming
Live priceskalshi-cli watch ticker TICKER
Orderbook deltaskalshi-cli watch orderbook TICKER
Public tradeskalshi-cli watch trades
Your orderskalshi-cli watch orders
Your fillskalshi-cli watch fills
Your positionskalshi-cli watch positions
Exchange
Exchange statuskalshi-cli exchange status
Schedulekalshi-cli exchange schedule
Announcementskalshi-cli exchange announcements
Config
Show configkalshi-cli config show
Set valuekalshi-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

TypeFormulaMax at 50/50
Takerroundup(0.07 * C * P * (1-P))1.75c/contract
Makerroundup(0.0175 * C * P * (1-P))~0.44c/contract
S&P/Nasdaq marketsHalf 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

© LeoYeAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skills/kalshi-cli-trading of LeoYeAI/openclaw-master-skills.

  • SKILL.md
  • AGENTS.md
  • README.md
  • _meta.json

Open the folder on GitHubat commit e5199b5

Compare with similar skills

Kalshi Trading next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kalshi Trading compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kalshi Trading this skillLeoYeAI/openclaw-master-skills2.2k—~5.9kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle878—~5.9kAutomated safety check: PassMIT
Dr Manhattanguzus/dr-manhattan204—~2kAutomated safety check: PassApache-2.0
Kalshi Traderyanfrigo/kalshi-ai-trading-bot613—~3.4kAutomated safety check: PassMIT
Polymarket Tennislivetennisapi/livetennisapi-mcp152—~3kAutomated safety check: PassMIT
Trading Kalshialsk1992/CloddsBot3k—~856Automated safety check: PassMIT

Similar skills

  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    878 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Dr Manhattan

    guzus/dr-manhattan

    Trade prediction markets (Polymarket, Kalshi, Opinion, Limitless, Predict.fun) using a unified CCXT-style API.

    204 GitHub stars~2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Kalshi Trade

    ryanfrigo/kalshi-ai-trading-bot

    The disciplined process for autonomously and profitably trading the live Kalshi account on each /loop tick, with Claude as the decision-maker.

    613 GitHub stars~3.4k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Polymarket Tennis

    livetennisapi/livetennisapi-mcp

    Build observe-only Polymarket and Kalshi tennis market tooling on the polymarket-tennis Python package (MIT) plus the Live Tennis API free tier.

    152 GitHub stars~3k tokensUpdated 4 days ago
    Business, Finance & HRAuto-check passed
  • Trading Kalshi

    alsk1992/CloddsBot

    Kalshi trading - search markets, place orders, stream prices, advanced order types

    3k GitHub stars~856 tokensUpdated 8 days ago
    Business, Finance & HRAuto-check passed
  • Prediction Market Strategy

    agiprolabs/claude-trading-skills

    Venue- and market-type-agnostic strategy, sizing, and backtesting layer for binary prediction markets (Kalshi, Polymarket, ForecastEx).

    410 GitHub stars~3.4k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed

More from LeoYeAI/openclaw-master-skills

All 1,200 skills in this repo
  • DevOps Pipeline Management

    LeoYeAI/openclaw-master-skills

    Manages pipelines on a DevOps quality and efficiency platform through its OpenAPI: list workspaces and templates, create, update, run and cancel pipelines, and read run records.

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Auto-check: notes
  • Feishu Document Collaboration

    LeoYeAI/openclaw-master-skills

    Patches OpenClaw's Feishu extension so an edited document triggers an isolated agent session that reads the doc and replies inline, turning it into a live chat space.

    2.2k GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Files Memory System

    LeoYeAI/openclaw-master-skills

    Multi-context memory management system for OpenClaw agents with group-isolated storage, global shared memory, workspace organization, and group-specific skills isolation.

    2.2k GitHub stars~3.8k tokensUpdated 2 mo ago
    Auto-check passed
  • GEO-Claw AI Visibility Agent

    LeoYeAI/openclaw-master-skills

    Runs a brand's AI-search visibility work end to end: diagnosing how AI platforms represent it, repositioning it, producing AI-optimized content and monitoring ongoing mentions.

    2.2k GitHub stars~4.7k tokensUpdated 2 mo ago
    Auto-check passed
  • Google Workspace CLI

    LeoYeAI/openclaw-master-skills

    Installs and authenticates the gws CLI, then automates Gmail, Drive, Sheets, Calendar, Docs, Chat and Tasks with ready-made recipes, persona bundles and security audits.

    2.2k GitHub stars~2.6k tokensUpdated 2 mo ago
    Auto-check: notes
  • HealthFit Health Advisors

    LeoYeAI/openclaw-master-skills

    Runs four advisor roles, a fitness coach, nutritionist, data analyst and TCM practitioner, to build a health profile and track workouts, diet and wellness over time.

    2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Kalshi Trading

What does Kalshi Trading do?

Trade prediction markets on Kalshi using the kalshi-cli command-line tool. Kalshi Trading is an agent skill from LeoYeAI/openclaw-master-skills. Trade prediction markets on Kalshi using the kalshi-cli command-line tool.

When should I use Kalshi Trading?

Kalshi Trading fits situations like: the user wants to trade event contracts; browse prediction markets; manage positions; stream live prices.

How do I install Kalshi Trading in Claude Code?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill kalshi-trading -a claude-code`. Or copy the skill folder (skills/kalshi-cli-trading in LeoYeAI/openclaw-master-skills) into .claude/skills/kalshi-trading in your project. Claude Code loads it when a task matches its description.

How do I install Kalshi Trading in Codex?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill kalshi-trading -a codex`. Or copy the skill folder (skills/kalshi-cli-trading in LeoYeAI/openclaw-master-skills) into .agents/skills/kalshi-trading in your project. Codex loads it when a task matches its description.

Can I use Kalshi Trading in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LeoYeAI/openclaw-master-skills --skill kalshi-trading -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kalshi-trading, .gemini/skills/kalshi-trading, .github/skills/kalshi-trading and .opencode/skills/kalshi-trading in your project.

What does Kalshi Trading need to run?

Going by SKILL.md and its folder, Kalshi Trading needs the command-line tools its instructions call (jq, go, brew and git) and credentials named KALSHI_API_KEY_ID and KALSHI_PRIVATE_KEY. Our summary lists: A credential in KALSHI_PRIVATE_KEY.

Does Kalshi Trading access the network?

SKILL.md names 6 domains. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. As links in the text: kalshi.com, docs.kalshi.com, help.kalshi.com, pypi.org and npmjs.com. This is read from the text; nothing was executed.

Is Kalshi Trading safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kalshi Trading use?

Kalshi Trading is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kalshi Trading use?

About 5.9k tokens (SKILL.md is roughly 23k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kalshi Trading?

Skills that share tags, products or a category with Kalshi Trading: Digital Oracle (komako-workshop/digital-oracle, 878 stars), Dr Manhattan (guzus/dr-manhattan, 204 stars), Kalshi Trade (ryanfrigo/kalshi-ai-trading-bot, 613 stars) and Polymarket Tennis (livetennisapi/livetennisapi-mcp, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kalshi Trading?

LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,161 GitHub stars. The repository holds 1,235 skills in this directory. The repository was last updated on July 20, 2026.

Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.