explaingit

siva-chidambaram12/kalshi-trading-bot

Analysis updated 2026-05-18

82TypeScriptAudience · researcherComplexity · 4/5Setup · hard

TLDR

An educational multi-agent AI trading bot that debates and places automated bets on Kalshi's regulated prediction markets.

Mindmap

mindmap
  root((kalshi trading bot))
    What it does
      Multi agent debate
      Automated prediction trades
      Risk management
    Tech stack
      TypeScript
      Node.js
      OpenRouter
    Use cases
      Research prediction markets
      Test trading strategies
      Study multi agent AI
    Audience
      Researchers and developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Research how multiple debating AI agents can reach a trading consensus.

USE CASE 2

Paper trade on Kalshi prediction markets without risking real money.

USE CASE 3

Study Kelly Criterion position sizing applied to prediction market bets.

USE CASE 4

Track which market categories an automated strategy performs well in.

What is it built with?

TypeScriptNode.jsOpenRouterSQLite

How does it compare?

siva-chidambaram12/kalshi-trading-botneuralinverse/neuralinverseyangshun/reclassify
Stars828282
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderateeasy
Complexity4/54/53/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires OpenRouter API access and a Kalshi account, real trading involves financial risk.

In plain English

Kalshi AI Trading Bot is an automated trading system that places bets on Kalshi, a regulated prediction market platform where users trade on the outcomes of real-world events like elections, economic data releases, and sports results. The bot is described as educational and research-oriented. The system's distinguishing feature is its multi-agent architecture. Rather than a single AI model making decisions, it runs five specialized AI agents in parallel: a forecaster that assesses probability, a news analyst that scores incoming headlines for relevance, a bull researcher arguing for a trade, a bear researcher arguing against it, and a risk manager with veto power. The agents debate and the system aggregates their outputs into a consensus probability, penalizing confidence when the agents strongly disagree. Position sizing uses the Kelly Criterion, a mathematically-derived method for betting a fraction proportional to your estimated edge, with a default cap at 25 percent of the theoretical optimal to reduce variance. The bot includes a hard daily AI spending cap, paper trading mode for testing without real money, WebSocket streaming for real-time market prices, RSS news aggregation from major sources, and a category scoring system that tracks which types of markets the bot has historically performed well in. A developer interested in prediction market trading systems or AI-driven decision making research would use this. The tech stack is TypeScript on Node.js 22.5, using OpenRouter to access multiple language models and SQLite for trade logging.

Copy-paste prompts

Prompt 1
Explain how the forecaster, bull, bear, and risk manager agents interact in this bot.
Prompt 2
Set this bot up in paper trading mode so I can test it without real money.
Prompt 3
Show me how the Kelly Criterion position sizing is implemented here.
Prompt 4
Walk me through configuring the daily AI spending cap for this trading bot.

Frequently asked questions

What is kalshi-trading-bot?

An educational multi-agent AI trading bot that debates and places automated bets on Kalshi's regulated prediction markets.

What language is kalshi-trading-bot written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, OpenRouter.

How hard is kalshi-trading-bot to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is kalshi-trading-bot for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.