Trading

Krypt Trader Setup Guide: Free Kalshi Bot with AI Agents, FAQ

7 min read

Krypt Trader puts your own AI agent on Kalshi, and tells you whether it actually beats the market. Connect Claude, an OpenAI model, Gemini or a local model; let it research markets, record forecasts and trade on paper; and a scoreboard checks those forecasts against the market price. You go live only when you choose to, inside hard rails.

It's free and open source, and runs on your computer with no telemetry. This guide gets you from install to your first scored forecasts in about five minutes.

Get Krypt Traderkrypt.cc/tools/trader

What Krypt Trader does

  • AI agents with hard rails: your AI researches Kalshi markets, records forecasts and trades, but the backend enforces caps, approvals and a daily loss stop.
  • The scoreboard: Does the AI beat the market? scores every forecast against the market price at the moment it was made (Brier score), per agent.
  • Trading terminal: any Kalshi market with order book, trade tape, probability chart, your position, a trade ticket, standing stop-loss / take-profit / alert rules, and read-only Polymarket prices for the same question.
  • AI analysis: click Analyse on a market for a fair value and an argument, using your own key or a local model. It has no trade button.
  • The bot and scanners: a whale tracker, a momentum scanner and an auto-trader, with a fee-aware backtest.
  • 15-minute crypto: Kalshi's 15-minute BTC, ETH, SOL and other crypto markets, with a configurable strategy.
  • Strategy scripts: your own Python strategies, sandboxed by default, with size caps and a per-script daily loss stop.
  • Remote control: check on the app, approve agent orders or trade from your phone over a Discord or Telegram bot you own.

How to download and install Krypt Trader

Windows is the main build; the macOS and Linux builds get less testing. Every build starts in Paper mode with every live switch off.

  1. Open the Krypt Trader page on krypt.cc. That page is the only official download; copies re-uploaded elsewhere can be modified.
  2. Pick the build for your system (Windows, macOS or Linux).
  3. Read and accept the Software Download Terms in the prompt. The file downloads as soon as you agree, and you won't be asked again for that tool until the terms change.
  4. Optional but sensible: upload the file to VirusTotal before you run it.

Windows

  1. Run the installer you downloaded.
  2. If Windows SmartScreen says "Windows protected your PC", click More info, then Run anyway. Krypt builds aren't code-signed yet, so SmartScreen treats them as unrecognised apps. That warning is about the missing signature, not about anything it found in the file.
  3. Follow the installer, then launch Krypt Trader from the Start menu or the desktop shortcut.

macOS

  1. Open the download and drag Krypt Trader into your Applications folder.
  2. The first time you open it, macOS blocks it because it's from an unidentified developer. Click Done, then go to System Settings → Privacy & Security, scroll down and click Open Anyway next to Krypt Trader. On macOS 14 and older you can instead right-click the app and choose Open.
  3. If macOS instead says the app "is damaged and can't be opened", the file isn't damaged: Gatekeeper is refusing an unsigned download. Clear its quarantine flag once in Terminal, then open the app again:
xattr -cr "/Applications/Krypt Trader.app"

If you saved the app somewhere other than Applications, drag it from Finder into the Terminal window after xattr -cr to paste its real path.

Linux

The Linux build is an AppImage: one file, nothing to install. Make it executable, then run it:

chmod +x ./*.AppImage
./*.AppImage

Or right-click it in your file manager, tick Allow executing file as program in Properties, and double-click it.

Start on Paper (no Kalshi account needed)

The app opens in Paper mode: Kalshi's real production markets, order books and outcomes, with an imaginary bankroll you choose under Settings → Account (with a Reset). Everything works in Paper (the bot, 15-minute crypto, scripts, the terminal, phone orders, AI agents and Autopilot), and none of it can send a real order. Market data comes from Kalshi's public endpoints, so you don't need an account yet.

Connect your AI

On the AI Agents page, pick one:

  • Autopilot (in-app): add an API key for Anthropic, OpenAI, OpenRouter or Gemini, or point it at a local Ollama or LM Studio model (it has to support tool calls). It runs the agent on a timer you set, inside daily run, token and tool-call budgets. Off until you switch it on.
  • Your own MCP client: Claude Code, Cursor, Claude Desktop or Codex. Click Copy config and paste it into the client. The token goes from the app to your clipboard and never appears on screen.
  • The HTTP API (/api/v1, with an OpenAPI spec) for scripts, n8n, LangChain or anything else that doesn't speak MCP. Off until its own switch is on.

Then give your agent a job, for example: "Use krypt-trader. Look through closing markets, read the rules, record honest forecasts, and only trade where your edge clears the minimum."

Reading the scoreboard

Each forecast is scored against the market price at the moment it was made, once the market settles. The scoreboard won't give a verdict before 30 settled markets, and it calls a difference within two standard errors "no measurable difference". Most AI "edges" on a liquid market turn out to be the model being wrong; the scoreboard is how you find out before a dollar is at risk.

The rails your agent can't get around

These are enforced in the backend, not just the UI:

  • No buy without a forecast: a buy must cite a forecast the agent recorded on that market in the last 30 minutes, and it must beat the limit price by your minimum edge after Kalshi's fee.
  • Caps per order, per day and on open positions.
  • Approvals on by default: each live order waits for you, in the app or from your phone (approve N), is re-checked when you approve, and expires after 10 minutes.
  • Daily loss stop on realised plus open losses for the UTC day. Unrealised gains never offset it, and exits are never blocked.
  • Agents only exit what they opened, and can't touch your keys, their own caps, or the Paper/Live switch.
  • Stop all: one button in the top bar turns off every engine that trades by itself.

Add a Kalshi API key and go live

  1. Create an API key in your account at kalshi.com.
  2. In Krypt Trader, open API Keys. A step-by-step wizard checks the key.
  3. Go to Settings → Account → Go live: the key is verified, every engine that would start spending is named, and you confirm explicitly.
  4. For agents, the Go live button on AI Agents adds their record, caps and approvals.

Each engine's own live switch still applies on top. Paper is always one click away.

Quick tips

  • Kalshi hosts its own official MCP connector. You can connect it alongside Krypt Trader for account reading and Kalshi price alerts; every order still goes through Krypt Trader's rails.
  • Treat scripts shared by others as untrusted until you've read them, especially in the optional un-sandboxed trusted mode.
  • The in-app Privacy page lists every outbound host and how to switch it off.
  • If you connect an AI client, it sends what it reads to its own provider. In live mode that includes your positions.

Krypt Trader FAQ

Is Krypt Trader free?

Yes. It's free and open source under the MIT licence.

Is Krypt Trader safe and legit?

Krypt Trader is published by Krypt, and the only official download is on krypt.cc. The source code is public on GitHub, so you, or anyone, can read exactly what it does. Builds aren't code-signed yet, which is why Windows SmartScreen or macOS may warn you the first time; the install steps explain it. Never download it from a re-upload, and if you want a second opinion, scan the file on VirusTotal before opening it.

Do I need a Kalshi account to try it?

No. Paper mode uses Kalshi's public market data with an imaginary bankroll. You only need a Kalshi API key to go live.

Which AI models work with it?

Claude Code, Cursor, Claude Desktop or Codex over MCP; Anthropic, OpenAI, OpenRouter or Gemini keys for Autopilot; or a local Ollama or LM Studio model that supports tool calls.

Can the AI trade real money without me?

Not by default. Live orders wait for your approval, and turning approvals off takes its own confirmation. Caps and a daily loss stop apply either way.

Where are my keys stored?

On your machine. On Windows they're encrypted with DPAPI and tied to your user account; on macOS and Linux they're in files only your user can read. Logs are scrubbed of keys and tokens.

Is there a Polymarket version?

Yes: Krypt PolyBot for polymarket.com and Polybot US for Polymarket US.

Is Krypt Trader affiliated with Kalshi?

No. It's an independent open-source app that works with Kalshi.

Get Krypt Traderkrypt.cc/tools/trader

← All guides

All software published here is free and provided as-is, without warranty of any kind. You download and run it at your own risk — always scan binaries and review the source before running them. Krypt is not liable for any loss or damage arising from this software, and using it may breach the terms of third-party services. Downloading means you accept the Software Download Terms, which include an arbitration agreement and a class-action waiver.

Nothing here is financial, investment, or legal advice. Product, game, and company names are the trademarks of their respective owners and are used only to describe compatibility — no affiliation, sponsorship, or endorsement is implied. Tools are for lawful use only, on systems you own or are authorised to administer.