OctagonAI/kalshi-trading-bot-cli

AI-native CLI for trading Kalshi prediction markets. Runs deep fundamental research, generates independent probability estimates, computes edge vs. live order books, and executes trades with Kelly sizing and a 5-gate risk engine.

Kalshi Trading Bot CLI – 무엇인가요

Kalshi Trading Bot CLI 는 Kalshi 예측 시장 플랫폼에서 거래할 수 있도록 도와주는 명령줄 애플리케이션입니다. Octagon Research를 통해 생성된 AI 기반 확률 추정치를 사용하여 모델 가격과 실시간 주문서 간의 에지(이점)를 탐지하고, 반-켈리(半 Kelly) 방식으로 포지션 크기를 결정하며 내장된 5게이트 리스크 엔진을 활용합니다.

핵심 기능

영역	봇이 수행하는 작업
시장 탐색	`search`, `similar`, `clusters`, `peers` – API 키 제공 시 Octagon 임베딩 기반의 의미적 및 키워드 검색을 통해 모든 Kalshi 시장에서 탐색 가능.
에지 탐지	`analyze` (또는 `search edge`)는 Octagon의 모델 확률을 가져와 시장 가격과 비교하고 신뢰도 수준과 함께 에지를 보고합니다.
포지션 규모 설정	반-켈리 방식(`kelly` 플래그)을 사용하며 설정 가능한 리스크 한도(유동성, 집중도, 드로우다운 등)를 준수합니다.
바스켓 구축	`basket build`는 클러스터 제한과 상관관계 제한을 사용해 다각화된 다중 레그 바스켓을 생성하고, `basket backtest`는 과거 수익률, 샤프 비율, 최대 드로우다운, 승률을 평가합니다.
리스크 및 준수	5게이트 엔진(Kelly, 유동성, 상관관계, 집중도, 드로우다운)이 한도를 초과하는 주문을 차단하며, `mandate/kill/resume`를 통해 일일 손실 한도를 설정할 수 있습니다.
학습 루프	`reflect`는 정산된 거래를 짧은 교훈으로 변환하고, `hypothesis`는 검증 가능한 주장(가설)을 추적하며, `calibration`은 브라이어 스코어와 카테고리별 기술 수준을 보고합니다.
자동화 친화적	`--json` 플래그로 기계가 읽을 수 있는 출력 제공, `--dry-run`으로 스캔만 가능, 글로벌 바이너리(`kalshi`)로 스크립팅 또는 병렬 호출 가능.
페이퍼 트레이딩	`paper buy/sell`로 실제 시세를 사용해 전략을 테스트하지만 실제 자금은 위험에 노출되지 않습니다.
보고서	`report`, `trust`, `themes report`, `events`는 마크다운 요약, 무결성 점수, 캘린더 보기 등을 제공합니다.

시작하기

Bun(≥ 1.1) 설치 – 봇은 Bun의 네이티브 TypeScript 런타임에서 실행되며 bun:sqlite를 사용합니다.
제로 설치 명령어 실행:
```
bunx kalshi-trading-bot-cli@latest
```
첫 실행 시 다음 설정을 묻는 워즈드가 시작됩니다:
- Kalshi API 키 + RSA 개인키
- LLM 제공업체 키 (OpenAI, Anthropic 등)
- 선택 사항: Octagon API 키 (AI 에지 분석용), Tavily 키 (웹 조사용)
설정 파일은 ~/.kalshi-bot/에 저장되며, 키가 포함된 .env 파일도 포함됩니다.
설정 후 REPL 내에서 help를 입력하거나, 다음 명령어를 직접 사용할 수 있습니다:
```
kalshi search crypto
kalshi analyze KXBTC-26APR-B95000
kalshi buy KXBTC-26APR-B95000 3 58
```

일반적인 워크플로우

탐색 – search 또는 clusters로 관심 있는 시장을 찾습니다.
분석 – analyze <ticker>는 모델 확률, 시장 가격, 에지, 주요 요인, 켈리 기반 주문 크기를 표시합니다.
검증 – basket validate 또는 backtest로 제안된 거래가 리스크 한도를 충족하고 과거 성과가 우수한지 확인합니다.
실행 – buy / sell (또는 paper buy로 시뮬레이션). 봇은 Kalshi에 주문을 전송하기 전에 5게이트 리스크 엔진을 확인합니다.
모니터링 – portfolio는 실시간 P&L을 표시하고, watch는 실시간 가격과 주문서를 스트리밍합니다.
학습 – 정산 후 calibration을 실행해 기술 수준을 확인하고, reflect로 교훈을 기록하며, hypothesis로 주장 추적을 관리합니다.

확장성 및 스크립팅

JSON 출력(--json)은 봇이나 자동화 파이프라인에 쉽게 통합할 수 있게 합니다.
글로벌 바이너리(kalshi)는 병렬 실행 및 다른 에이전트와의 통합을 가능하게 합니다.
사용자 정의 테마 – 자신만의 연구 아이디어에 따라 themes를 생성, 가져오기, 편집할 수 있습니다.
데몬 모드(daemon)는 캐시를 유지하고 결제를 동기화하며 인터랙티브 사용을 방해하지 않고 백그라운드에서 리플렉션을 실행합니다.

누구에게 적합한가요

예측 시장에서 AI 강화된 에지 탐지를 원하는 양적 트레이더.
LLM 기반 확률 예측을 실험하는 연구자.
내장된 리스크 제어 기능이 있는 스크립터블, 터미널 기반 Kalshi 인터페이스를 찾는 아마추어.

결론: Kalshi Trading Bot CLI는 시장 탐색, 에지 분석, 리스크 인식적 포지션 크기 결정, 바스켓 구성, 백테스트, 지속적인 개선을 위한 피드백 루프를 갖춘 완전 기능의 AI 강화 명령줄 거래 보조 도구입니다. Bun을 설치한 후 단일 bunx 명령어로 실행 가능합니다.