Kalshi CLI
The first third-party command-line tool for Kalshi. Search markets, track positions, analyze orderbooks — all from your terminal.
$ npm install -g @spfunctions/cli
$ sf setupFree during beta · no Kalshi affiliation
Search markets
Keyword search, series drill-down, or single market detail. No auth required.
$ sf scan --series KXWTIMAX
KXWTIMAX — WTI Crude Oil Maximum Price
KXWTIMAX-26DEC31
├── WTI $120 YES 72¢ vol 2.1M
├── WTI $130 YES 63¢ vol 1.8M
├── WTI $135 YES 56¢ vol 890K
├── WTI $140 YES 50¢ vol 1.2M
├── WTI $150 YES 38¢ vol 654K
└── WTI $160 YES 29¢ vol 312KTrack your positions
Connect your Kalshi API key. See positions, live P&L, and thesis edge overlay.
$ sf positions
Positions
KXWTIMAX-T135 YES 795 @ 57¢ now 60¢ +$23 ▲
KXRECSSNBER-26 YES 3022 @ 32¢ now 35¢ +$91 ▲
────────────────────────────────────────
Total P&L: +$114
Edge overlay from thesis f582bf76:
KXWTIMAX-T135 mkt 60¢ thesis 80¢ edge +20 HOLD
KXRECSSNBER-26 mkt 35¢ thesis 72¢ edge +37 HOLDAnalyze edges across all theses
One command shows the best trading opportunities ranked by executable edge.
$ sf edges
Top Edges Across 2 Theses
Recession 2026 YES 35¢ 72¢ +37 +36 1¢ high f582bf76
WTI $150 YES 38¢ 75¢ +37 +36 1¢ high 641ba280
Gas $4.50 Mar YES 14¢ 55¢ +41 +39 3¢ med 641ba280
WTI $135 YES 56¢ 80¢ +24 +23 2¢ med f582bf76
Total positioned: $1,407 cost | P&L: +$114
Top unpositioned: WTI $150 @ 38¢ (exec +36, high liq)Interactive agent
Ask questions in natural language. The agent calls tools automatically.
$ sf agent f582bf76
> What's the best entry right now?
⚡ get_context ✓ (0.3s)
WTI $150 YES at 38¢ has the largest executable edge (+36)
with high liquidity (spread 1¢, bid depth $800+).
Your thesis implies 75¢. If war persists and Hormuz stays
blocked, this contract is massively underpriced.
> What about recession plays?
⚡ scan_markets ✓ (0.5s)
Recession 2026 YES at 35¢ — your thesis implies 72¢.
Edge +37, spread 1¢, high liquidity.
You already hold 3022 contracts at 32¢ (+$91 P&L).Setup (2 minutes)
$ npm install -g @spfunctions/cli
$ sf setupConfig saved to ~/.sf/config.json. No exports needed.
How it connects to Kalshi
SimpleFunctions reads your Kalshi positions via authenticated API (RSA-PSS signing). It overlays thesis-driven edge analysis on top of your real positions.
It never places orders or moves funds — read-only access to your portfolio.
Your private key stays on your machine. Never uploaded.
Pricing
Free during beta. Charge by token after 15M.