bobashopcashier/kalshi-cli
A Go CLI that lets AI agents safely read and trade on Kalshi's prediction markets without getting fooled by silent API changes
kalshi-cli wraps Kalshi's Predictions Trade API v2 so AI agents and scripts can browse and trade prediction markets through stable, bounded JSON output. If Kalshi changes a response's required fields or format, the CLI fails immediately with an UPSTREAM_SCHEMA_MISMATCH error naming the exact broken field, instead of silently passing along bad data. In a 48-case regression test, the CLI detected all 32 injected breaking API changes, while a plain JSON decoder with no validation caught none of them.
What it does
- Wraps Kalshi Trade API v2 to expose positions, realized profit/loss, fills, and candlestick (price chart) data as fixed-point numbers in versioned JSON contracts
- Fails atomically with an UPSTREAM_SCHEMA_MISMATCH error and names the exact JSON path when Kalshi changes a required field, type, or format
- Trading (write) commands are denied by default and require an explicit confirmation flow, a 'governed' write policy
- Applies bounded pagination and output limits so responses can't grow unbounded
- Its search command does simple case-insensitive substring matching over scanned market pages rather than true full-text search, since Kalshi doesn't offer one, and preserves upstream order instead of ranking by relevance
Why it matters
For anyone building AI agents or automated pipelines that touch live financial data, this guards against a real risk: an API silently changing shape and the agent acting on bad information. It also cuts response size by nearly 80% via field selection, reducing the context cost of feeding data to language models.
Terms in this repo
- schema validation · checking that received data's structure and format matches what was promised
- fixed-point number · a numeric format with a fixed decimal position, avoiding rounding errors
- pagination · splitting large data into pages fetched one at a time
- candlestick · price chart data showing open, high, low, and close values over a time period
- deny-by-default · a security principle where requests are rejected unless explicitly allowed
Repository description (English)
Go command-line client for Kalshi Trade API v2 with versioned, schema-validated JSON output.
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install