kalshi-paper-trading

What This Skill Does

The kalshi-paper-trading skill provides a specialized, high-fidelity ledger and CLI tool for managing paper-traded binary prediction contracts on the Kalshi platform. Unlike generic paper trading tools that treat assets like traditional stocks or spot commodities, this skill is purpose-built to handle the unique mechanics of binary options, specifically pricing in integer cents (0-100), market ticker and contract side keying, and event-based settlement logic. It acts as a dedicated back-testing and performance-tracking engine that allows developers to simulate and audit Kalshi-specific strategies without touching real capital.

Installation

To install this skill, run the following command in your terminal within the OpenClaw environment: clawhub install openclaw/skills/skills/brs999/kalshi-paper-trading Ensure your local environment has Node.js with experimental strip-types support enabled to execute the underlying TypeScript scripts provided by the author, brs999.

Use Cases

• Strategy Backtesting: Simulate complex market-making or directional strategies on Kalshi contracts using native, non-diluted price units.
• Portfolio Reconciliation: Automatically compare ledger state against actual final settlement prices when events close.
• Risk Management Design: Build exposure rules based on premium and binary event outcomes rather than traditional volatility metrics.
• Performance Auditing: Maintain a persistent ledger for paper-trading history to analyze realized vs. unrealized PnL using the review command.

Example Prompts

1. "Initialize a new Kalshi paper trading account with a starting balance of 2000 USD to test my new volatility hedging strategy."
2. "Sync the current ask price for the market TICKER-123 and buy 5 contracts on the YES side using my Kalshi paper account."
3. "Reconcile the position for TICKER-123 assuming a win on the YES side and generate a JSON report of my current performance."

Tips & Limitations

• Always Use the Native Ledger: Do not route Kalshi executions through the generic paper-trading skill, as it will likely result in data corruption due to mismatched settlement logic and unit structures (cents vs dollars).
• Data Integrity: The skill assumes integer pricing in cents. Ensure your external data sources feeding this skill follow this convention to avoid valuation errors.
• Read the Design Doc: For advanced structural changes or custom risk integrations, reference references/kalshi-paper-ledger.md to ensure compliance with the intended schema architecture.
• API Integration: This skill handles the execution and ledger only. Pair it with a separate Kalshi API reader for real-time market discovery and orderbook monitoring.