FED-RATE-JUL 0.61¢ +2.4% | CPI-ABOVE-3 0.34¢ -0.8% | GDP-Q3-POS 0.72¢ +1.2% | NFL-CHIEFS 0.47¢ +0.5% | HIGH-TEMP-NYC 0.55¢ +3.1% | BTC-EOY-100K 0.41¢ -0.3% | SENATE-CTRL 0.52¢ +0.9% | JOBS-200K 0.38¢ +1.7% | SP500-ATH 0.66¢ -1.1% | FED-RATE-JUL 0.61¢ +2.4% | CPI-ABOVE-3 0.34¢ -0.8% | GDP-Q3-POS 0.72¢ +1.2% | NFL-CHIEFS 0.47¢ +0.5% | HIGH-TEMP-NYC 0.55¢ +3.1% | BTC-EOY-100K 0.41¢ -0.3% | SENATE-CTRL 0.52¢ +0.9% | JOBS-200K 0.38¢ +1.7% | SP500-ATH 0.66¢ -1.1% |
Skip to content
Mail Kalshitradingbot::terminal [exec] init →
CONNECTED · KALSHI API · STREAM LIVE

A Kalshi trading bot for automated event contracts.

A Kalshi trading bot automates Yes/No event-contract orders through Kalshi's official API. This one streams the order book, scores signals, mirrors ranked traders, and runs every order through a risk gate before it reaches the exchange — using your own API key, on your own regulated account.

ACCESS
API key
SETTLE
USD
FEED
WebSocket
CUSTODY
Yours
~ /kalshi-bot/stream
$ kbot run --strategy=signal --series=FED-RATE
▸ api key verified · ws feed online
[14:02:18] tick · FED-RATE-JUL YES bid 0.60 ask 0.61
[14:02:18] signal · momentum +0.8 · threshold met
[14:02:18] risk gate · per-trade cap OK · liquidity OK
[14:02:18] order · BUY 120 YES @ 0.61 · limit
[14:02:18] ✓ resting · order_id 9f31a · 84ms
[14:08:42] fill · 120 YES @ 0.61 · $73.20 staked
[14:08:42] bracket · take-profit 0.78 · stop 0.49
[14:08:43] ✓ brackets armed · position live
// engine.json

What runs inside the Kalshi trading engine.

Six modules sit between Kalshi's API and your strategy. The feed decodes every order-book change; the signal layer scores it; the risk gate vetoes anything outside policy — all before a single order reaches the matching engine.

// 01 / module
[OK]

FEED

Subscribes to Kalshi's WebSocket order book and trade feed. Decodes every Yes/No tick across the series you track, with REST polling fallback if the socket drops.

// 02 / module
[OK]

SIGNAL

Scores each market from momentum, spread, and resolution proximity. You choose the strategy — signal-driven, leaderboard mirror, or a fixed rules set — and the threshold that triggers an order.

// 03 / module
[OK]

RISK GATE

Per-trade hard cap, daily-loss circuit breaker, exposure ceiling per series, and a liquidity floor — every one evaluated before submission, never after a bad fill.

// 04 / module
[OK]

SIZER

Translates your bankroll and contract price into a contract count. Caps stake per market so a single event resolving No cannot blow the account.

// 05 / module
[OK]

EXECUTOR

Places limit orders over Kalshi's REST API with optional take-profit and stop brackets. Re-prices toward the book to lift fill rate without crossing the spread blindly.

// 06 / module
[OK]

LEDGER

Logs every signal, order, fill, and settlement with timestamps. The audit trail reconciles against Kalshi's own fills so your P&L is verifiable, not estimated.

// flow(7) — manual page

From API key to first automated order in about two minutes.

The bot never holds your money. You paste a read-and-trade Kalshi API key, set policy, and arm it. Every step is reversible, and you can revoke the key from your Kalshi account at any moment.

01
KEY
paste a Kalshi API key with trade scope — place and cancel orders only, no withdrawal authority, revocable from your account
02
POLICY
set per-trade cap, daily-loss limit, exposure ceiling, and a minimum-liquidity floor so the bot only acts in markets deep enough for your size
03
STRATEGY
pick signal-driven, leaderboard mirror, or fixed rules — then choose the series and categories the bot is allowed to trade
04
ARM
bot.start() — the feed connects, the risk gate arms, and orders route to Kalshi over REST on every qualifying trigger
05
WATCH
the dashboard shows fills, open positions, latency, and P&L — optional; the bot keeps running with the tab closed
// leaders · mirror

Mirror ranked Kalshi traders, sized to your own bankroll.

Pick traders from a ranking calibrated against resolved Kalshi markets — win rate, realized profit, sample size, and category focus, not self-reported claims. The reasoning behind ranking forecasters is grounded in the academic prediction-market literature.

Sample leaderboard of Kalshi traders available to mirror, with category, win rate, realized profit, recent trend, and trade count.
Rank Trader Focus Win Realized 7D Trades Action
01 forecaster_01 ECONOMICS 71.4% +$48,210 612 [mirror]
02 quant_macro FINANCIALS 64.9% +$39,880 1,204 [mirror]
03 weather_edge WEATHER 77.2% +$31,540 904 [mirror]
04 rates_desk ECONOMICS 62.1% +$27,910 743 [mirror]
05 poll_signal POLITICS 58.6% +$24,330 1,389 [mirror]
06 vol_harvest FINANCIALS 66.8% +$21,470 587 [mirror]
07 climate_line CLIMATE 69.3% +$18,240 478 [mirror]
08 event_scout SPORTS 61.0% +$15,090 1,012 [mirror]

Ranking shown is an illustrative sample of leaderboard structure. Past performance does not predict future results.

// order latency · sample · ms
submit → ack
00:0006:0012:0018:00now
// orders by category · sample
share of activity
ECONOMICS78%
FINANCIALS62%
POLITICS44%
WEATHER31%
CLIMATE14%
// plans

Three plans. All API-key only. All cancellable.

Every tier connects through your own Kalshi account with a trade-scoped API key. The bot can place and cancel orders — it can never withdraw your funds.

SCOUT
$59 /mo

For new automated traders running a single careful strategy.

  • Mirror up to 3 traders
  • Per-trade hard cap
  • Daily-loss circuit breaker
  • Email + chat support
[exec] subscribe
// recommended
OPERATOR
$149 /mo

For traders running multiple series with active exposure control.

  • Mirror up to 15 traders
  • Liquidity-floor filtering
  • Stop + take-profit brackets
  • Priority support, full analytics
[exec] subscribe
DESK
$349 /mo

For teams running institutional rules across many Kalshi series.

  • Unlimited mirrored traders
  • Custom risk-policy engine
  • Webhook + API integration
  • Dedicated solutions engineer
[exec] subscribe
// faq

Kalshi bot Q&A.

Straight answers about how a Kalshi trading bot works, what it can and cannot touch, and where the real limits are. The Kalshi API documentation is the authoritative source.

What is a Kalshi trading bot?

Software that places and manages Yes/No event-contract orders on the Kalshi exchange through Kalshi's official API. It reacts to price signals or mirrors selected traders and submits orders against your own Kalshi account, with risk limits checked before every order.

Does the bot have access to my Kalshi funds?

No. It connects with a read-and-trade Kalshi API key you generate and can revoke at any time. It can place and cancel orders but cannot withdraw money. Your funds stay inside your regulated Kalshi account.

Is Kalshi automated trading legal in the US?

Kalshi is a CFTC-regulated designated contract market and publishes a public API meant for programmatic trading. Using a bot to trade your own account through that API is permitted within Kalshi's API terms, which you are responsible for following.

How fast does the bot react?

It streams order-book and trade updates over Kalshi's WebSocket feed and submits orders over REST. Detection-to-submission typically completes in well under a second; final fill time still depends on Kalshi's matching engine and market liquidity.

What does a Kalshi trading bot cost?

Three monthly plans: Scout $59, Operator $149, and Desk $349. Every tier is non-custodial API-key access and can be cancelled at any time.

Can I copy or mirror other Kalshi traders?

Yes. You can mirror a ranked list of public traders, sized to your own bankroll, with a per-trade cap, liquidity floor, and category filter so one event cannot dominate your exposure.

Which Kalshi markets can the bot trade?

Any Yes/No market Kalshi lists — economics, financials, politics, weather, and climate series among them. You set category filters and a liquidity floor so the bot only acts in markets deep enough for your size.

What are the practical risks?

Event contracts can resolve fully against you, returning zero on staked capital. Markets carry liquidity risk and resolution risk, and an automated strategy can lose quickly. Per-trade caps and daily-loss limits are a baseline, not a guarantee. Nothing here is financial advice.

// init.sh

$ kbot init --your-key

About two minutes from this page to your first automated Kalshi order. Your strategy, your risk policy, your API key — running on your own regulated account, never a custodial deposit.