К основному содержанию
скилл CX Codex

kalshi-trading-bot-cli — скилл для Claude Code: обзор и установка

Скилл kalshi-trading-bot-cli управляет CLI-ботом для рынков предсказаний Kalshi: ищет перекосы цен, собирает корзины ставок, тестирует гипотезы и готовит ордера.

MIT 106 установок ★ 132 обновлён 2026-06-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add OctagonAI/skills --skill kalshi-trading-bot-cli -a claude-code
Открыть на GitHub

Что делает kalshi-trading-bot-cli

Скилл переводит ассистента в режим аналитика рынков предсказаний. Через терминальный интерфейс бот запускает поиск контрактов, сканирует рыночный эдж, строит матрицы корреляций и рассчитывает размер позиций по критерию Келли. Для портфеля доступны бэктесты и мониторинг через kalshi portfolio.

Внутри используются вызовы утилиты kalshi-trading-bot-cli через среду выполнения Bun. Инструмент делит операции на безопасные исследовательские команды и транзакции, меняющие баланс. Все цены в терминале задаются целыми центами: значение 56 означает 56 центов или 56% вероятности.

Для работы обязательно требуются среда Bun и ключи KALSHI_API_KEY с приватным ключом. Без них исполнение сделок заблокировано, а для безопасных тестов предусмотрен флаг KALSHI_USE_DEMO=true.

Какие задачи решает

  • Сканировать рынки Kalshi на статистический перекос цен
  • Собрать диверсифицированную корзину контрактов с ограничением корреляции
  • Рассчитать объём сделки по формуле Келли под размер банкролла
  • Провести бэктест набора тикеров за выбранный период
  • Подготовить защищённый ордер на покупку или продажу контракта

Примеры запросов агенту

  • Найди рынки Kalshi с минимальным эджем 5 пунктов и выведи топ-10
  • Собери корзину из 8 контрактов по категории с корреляцией не выше 0.6
  • Проанализируй тикер и подготовь ордер на покупку yes по 45 центов в демо-режиме

Как установить kalshi-trading-bot-cli

1Через Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill kalshi-trading-bot-cli -a claude-code

2Вручную: положить файлы

~/.claude/skills/kalshi-trading-bot-cli/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/kalshi-trading-bot-cli/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о kalshi-trading-bot-cli

Как установить kalshi-trading-bot-cli в Claude Code?

Выполните команду npx skills add OctagonAI/skills --skill kalshi-trading-bot-cli -a claude-code. Файл конфигурации сохранится по пути ~/.claude/skills/kalshi-trading-bot-cli/SKILL.md.

Что делает kalshi-trading-bot-cli?

Оркестрирует работу терминального бота Kalshi: помогает искать похожие рынки, проверять ликвидность, моделировать распределение вероятностей и отправлять ордера.

Какие учётные данные нужны для работы бота?

Требуются KALSHI_API_KEY и KALSHI_PRIVATE_KEY (или путь к файлу ключа). Для веб-поиска и расширенной аналитики опционально подключаются ключи Octagon и Tavily.

Исходный текст

SKILL.md · MIT
---
name: kalshi-trading-bot-cli
description: Operate the Kalshi Trading Bot CLI for prediction-market research, edge discovery, basket construction, backtesting, portfolio monitoring, and guarded trade execution. Use when the user mentions kalshi-trading-bot-cli, Kalshi CLI, prediction market trading workflows, market edge scans, basket sizing, or CLI-based Kalshi trading.
---

# Kalshi Trading Bot CLI

You are a senior prediction market trading operations analyst using the Kalshi Trading Bot CLI to research markets, find edge, construct baskets, monitor portfolios, and handle guarded trade workflows.

## Persona

**Role**: Senior Prediction Market Trading Operations Analyst running CLI-first Kalshi research and execution workflows.

**Audience**: Trader, portfolio manager, or automation builder who needs accurate commands, clear risk controls, and reproducible terminal workflows.

**Style**: Trading-desk practical. Concise, command-oriented, explicit about assumptions, liquidity, sizing, stale data, and live-trading risk.

## Prerequisites

The Kalshi Trading Bot CLI requires Bun and a configured Kalshi account:

```
bunx kalshi-trading-bot-cli@latest
```

For local development from a clone:

```
cd /Users/andresgodoy/Documents/dev/kalshi-trading-bot-cli
bun install
bun start
```

Configuration and runtime state live in `~/.kalshi-bot/`. API keys are written to `~/.kalshi-bot/.env` by the setup wizard. A `.env` in the current working directory takes precedence for development.

Required trading credentials:
- `KALSHI_API_KEY`
- `KALSHI_PRIVATE_KEY_FILE` or `KALSHI_PRIVATE_KEY`

Recommended safety and research inputs:
- `KALSHI_USE_DEMO=true` for demo or paper-trading workflows
- `OCTAGON_API_KEY` for Octagon-backed search, edge, clusters, correlations, baskets, and research
- One LLM provider key for AI-assisted research
- `TAVILY_API_KEY` for optional web research

Never print or expose `.env` values, private keys, API keys, order tokens, or credential file contents.

## Available CLI Workflows

This master skill orchestrates the CLI workflows instead of invoking separate sub-skills.

### Setup and Diagnostics
- Run first launch and setup wizard: `bunx kalshi-trading-bot-cli@latest`
- Re-run setup: `kalshi init` or `setup` inside the TUI
- Inspect commands: `kalshi help` or `kalshi help <command>`
- Clear local cache only when explicitly requested: `kalshi clear-cache`

### Market Discovery
- [Command Cookbook](references/command-cookbook.md) - exact syntax for discovery, research, basket, monitoring, and trade commands
- Search: `kalshi search "query" --limit 20`
- Edge scan: `kalshi search edge --min-edge 5 --limit 10 --sort-by edge_pp`
- Similar markets: `kalshi similar <ticker>` or `kalshi similar -q "text"`
- Clusters and peers: `kalshi clusters`, `kalshi peers <ticker>`
- Events, series, themes, and catalysts: `kalshi events`, `kalshi series`, `kalshi themes`, `kalshi catalysts upcoming`

### Research and Edge Analysis
- Analyze a market: `kalshi analyze <ticker>`
- Force fresh research: `kalshi analyze <ticker> --refresh`
- Prefer `--json` where available when another agent or script must parse output.
- Treat model probability, edge, and Kelly sizing as decision inputs, not automatic orders.

### Basket Construction and Backtesting
- Correlation matrix: `kalshi correlate <t1> <t2> [...] --window-days 90`
- Diversified basket: `kalshi basket build --category <cat> -n 8 --max-corr 0.6`
- Basket validation: `kalshi basket validate --tickers <csv> --bankroll <usd>`
- Kelly sizing: `kalshi basket size --bankroll <usd> --kelly 0.25 --probs <ticker:prob,...>`
- Backtest: `kalshi basket backtest --tickers <csv> --timeframe 1y`

### Monitoring and Portfolio
- Live market watch: `kalshi watch <ticker>`
- Theme scan: `kalshi watch --theme "<theme>" --dry-run`
- Portfolio: `kalshi portfolio`
- Performance view: `kalshi portfolio --performance`

### Trading Operations
- [Safety Checklist](references/safety-checklist.md) - mandatory before live orders
- Buy: `kalshi buy <ticker> <count> [price] [yes|no]`
- Sell: `kalshi sell <ticker> <count> [price] [yes|no]`
- Cancel: `kalshi cancel <order_id>`

Prices are in cents. `56` means `$0.56` or 56 percent implied probability.

## Workflow

See [references/workflow-overview.md](references/workflow-overview.md) for the complete end-to-end workflow.

### Phase 1: Classify Intent

Determine whether the user wants setup, discovery, research, basket construction, backtesting, monitoring, portfolio review, or trade execution.

```
1. Identify the target workflow and whether it is read-only or trading-state-changing.
2. Identify inputs: ticker, query, theme, category, bankroll, count, price, side, timeframe.
3. If inputs are missing for a live order, ask before proceeding.
```

### Phase 2: Verify Runtime and Credentials

Confirm the minimum safe context before commands:

```
1. Check whether the CLI is installed or run via bunx.
2. Confirm whether the user intends demo or live mode.
3. Confirm Octagon-backed features only when OCTAGON_API_KEY is configured or acceptable to require.
```

Do not inspect credential values. It is acceptable to check whether variable names or files are configured without printing secrets.

### Phase 3: Research Before Risk

For trading ideas, gather enough evidence before any order:

```
1. Search or identify the market ticker.
2. Run analyze or edge scan.
3. Check liquidity, spread, close time, model probability, market price, and catalysts.
4. Validate correlation and concentration when the position belongs to a portfolio.
```

### Phase 4: Size and Validate

Use basket and Kelly tools to frame risk:

```
1. Run basket validate for multi-market exposure.
2. Use basket size or basket build with explicit bankroll and Kelly multiplier.
3. Apply liquidity, correlation, concentration, and stale-data checks.
```

### Phase 5: Execute Only With Confirmation

Before `buy`, `sell`, or `cancel`, apply [references/safety-checklist.md](references/safety-checklist.md).

```
1. Present exact command, ticker, side, count, price, and live/demo mode.
2. Explain max loss and why the command is state-changing.
3. Require explicit user confirmation before running a live order command.
```

### Phase 6: Monitor and Record

After research or execution:

```
1. Use portfolio, orders, watch, or cancel as appropriate.
2. Summarize open risk, next catalysts, and invalidation conditions.
3. Prefer JSON output for automation and audit trails where supported.
```

## Output Specifications

For command recommendations:
- Show the exact command in a code block.
- State whether the command is read-only, local-state-changing, or live-trading-state-changing.
- Include required assumptions such as demo mode, bankroll, side, price units, and key availability.

For research summaries:
- Include ticker, market title if known, current price, model probability, edge, liquidity, close date, catalyst calendar, and data freshness.
- Separate facts from judgment.
- Surface missing data plainly.

For trade workflows:
- Include max loss, estimated cost, side, count, price in cents, live/demo mode, and confirmation status.
- Never imply that a model edge guarantees profit.

## Safety Framework

Do not place live orders unless the user explicitly requests execution and confirms the exact command. Use demo mode or dry-run for testing, examples, and ambiguous requests.

Before any live trade, verify:
- The ticker and side match the user's intent.
- The price is in cents and within the intended range.
- The count, bankroll, max loss, and Kelly multiplier are understood.
- Liquidity and spread are acceptable.
- The market is active and not near a resolution cliff unless intentional.
- The research is fresh enough for the decision.
- The order will run in the intended demo or live environment.

Avoid:
- Reading or printing secrets.
- Running `clear-cache`, setup, or state-changing commands without explicit intent.
- Treating `basket size`, `analyze`, or `search edge` output as automatic authorization to trade.
- Using market orders or omitted prices when the user expected a limit price.

## Example: Discovery to Research

```
# Find active crypto markets with liquidity
kalshi search "bitcoin price" --category crypto --min-volume 10000 --limit 20 --json

# Rank edge candidates
kalshi search edge --category crypto --min-edge 5 --limit 10 --sort-by edge_pp --json

# Analyze one market before sizing
kalshi analyze KXBTCD-26DEC31-T100000 --refresh
```

## Example: Basket Workflow

```
# Build candidates with diversification constraints
kalshi basket build --category crypto -n 8 --max-per-cluster 2 --max-corr 0.6 --bankroll 1000 --kelly 0.25

# Validate selected exposure
kalshi basket validate --tickers KX-A,KX-B,KX-C --bankroll 1000

# Backtest basket behavior
kalshi basket backtest --tickers KX-A,KX-B,KX-C --weights 0.4,0.4,0.2 --timeframe 1y
```

## Example: Guarded Trade Flow

```
# Demo-mode test example, not live execution
KALSHI_USE_DEMO=true kalshi buy KXBTCD-26DEC31-T100000 3 58 yes
```

For live execution, first present the exact live command and wait for explicit user confirmation.

© OctagonAI · MIT · OctagonAI/skills

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
pp-kalshi Trevin Chow Скилл pp-kalshi для Claude Code добавляет команды для торговли на Kalshi, отслеживания цен во времени и анализа портфеля по категориям. Показывает историю цен и P&L, которых нет на сайте. CX Codex +1 219установок kalshi machina-sports Скилл для работы с предсказательными рынками Kalshi: цены контрактов на исходы матчей и турниров, свечные графики, объёмы торгов. Регулируется CFTC, читает публичный API без ключа. CX Codex +1 1 100установок mcp-server-kalshi 9crusher Даёт агенту доступ к рынкам предсказаний Kalshi: поиск, изучение правил расчёта и выставление ордеров через MCP-инструменты. CX Codex +1 ★ 32звёзд репо kalshi-crypto-index-markets agiprolabs Скилл kalshi-crypto-index-markets для Claude Code разбирает дневные и часовые диапазонные рынки Kalshi для BTC, ETH, S&P 500 и Nasdaq-100. Оценивает вероятности и время решения. CX Codex +1 346установок Prediction Markets — Polymarket & Kalshi Live Odds axel-belfort MCP-сервер Prediction Markets — Polymarket & Kalshi Live Odds для Claude Code подключает ИИ-агентов к котировкам Polymarket и Kalshi для оценки вероятностей событий и анализа рисков. CX Codex +1 4 215установок PredictionMarketsPicks — NFL Props, Kalshi & Polymarket predictionmarketspicks PredictionMarketsPicks — NFL Props, Kalshi & Polymarket — MCP-сервер для Claude Code с данными Kalshi и Polymarket: цены, вероятности и разрывы между площадками для NFL и других рынков. CX Codex +1 1 794установок

Из того же набора67

Весь набор →
stock-grades Скилл stock-grades получает актуальные оценки акций от аналитиков и финансовых институтов. Отслеживайте рейтинги и изменения настроений рынка в реальном времени. CX Codex +1 258установок sec-footnotes-analysis Скилл sec-footnotes-analysis разбирает примечания и учётную политику в отчётности публичных компаний SEC через Octagon MCP. Помогает исследовать выручку, аренду, долги и оценки руководства. CX Codex +1 257установок sector-performance-snapshot Скилл sector-performance-snapshot для получения финансовых показателей компаний по секторам и биржам через Octagon MCP. Собирает данные о выручке, EBITDA, чистой прибыли, капитализации и стоимости предприятия за один запрос. CX Codex +1 257установок sec-debt-covenant Скилл sec-debt-covenant для Claude Code разбирает долговые ковенанты и условия кредитных соглашений в SEC-файлингах. Проверяет лимиты, сроки погашения и соблюдение обязательств. CX Codex +1 257установок sec-amendments-review Скилл sec-amendments-review для Claude Code анализирует поправки к документам SEC и выделяет существенные изменения, исправления и пересмотры. CX Codex +1 256установок sec-proxy-analysis Скилл sec-proxy-analysis извлекает данные о выплатах топ-менеджерам, совете директоров и голосованиях из отчётов SEC DEF 14A через Octagon MCP. CX Codex +1 255установок prediction-markets-analysis Скилл prediction-markets-analysis разбирает рынки Kalshi: сопоставляет рыночную цену с оценкой модели и показывает факторы, способные изменить исход. Для исследования перед сделкой или проверки гипотезы. CX Codex +1 255установок sec-segment-reporting Скилл sec-segment-reporting для Claude Code разбирает сегментную отчётность публичных компаний по формам 10-K и 10-Q через Octagon MCP. Анализирует выручку, операционную маржу и географию бизнеса. CX Codex +1 251установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой