{"skill":{"slug":"kalshi-paper-trading","displayName":"Kalshi Paper Trading","summary":"Kalshi-native paper trading ledger and CLI for binary prediction contracts. Use for paper opens, marks, reconciliation, valuation, and review without relying...","description":"---\nname: kalshi-paper-trading\ndescription: Kalshi-native paper trading ledger and CLI for binary prediction contracts. Use for paper opens, marks, reconciliation, valuation, and review without relying on the generic spot-style paper trader.\nhomepage: https://docs.kalshi.com\nuser-invocable: true\ndisable-model-invocation: false\nmetadata:\n  openclaw:\n    emoji: \"📈\"\n    requires:\n      bins: [node]\n---\n\n# Kalshi Paper Trading\n\nUse this skill for Kalshi paper execution and ledger management.\n\nKalshi-native paper trading should use a dedicated ledger and CLI rather than the generic `paper-trading` skill.\n\n## When to Use\n\nUse this skill when the user wants to:\n\n- design or build a Kalshi-specific paper trader\n- inspect or reconcile Kalshi paper positions\n- store Kalshi prices correctly in cents without mixing units\n- compute Kalshi realized and unrealized PnL\n- add Kalshi-native exposure or risk rules\n\n## Key Rule\n\nDo not route Kalshi paper executions through the generic `skills/paper-trading` ledger unless the user explicitly asks to keep that compatibility.\n\nDefault assumptions for this skill:\n\n- Kalshi execution prices are stored as integer cents in `[0, 100]`\n- settlement is `100` or `0` cents\n- positions are keyed by `market_ticker + contract_side`\n- risk controls are based on premium and event exposure, not stop-distance percent risk\n- live market sync supports both legacy cent fields and modern Kalshi `*_dollars` quote fields\n\n## Primary Commands\n\nInitialize the paper account:\n\n```bash\nnode --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts init --account kalshi --starting-balance-usd 1000\n```\n\nCheck status:\n\n```bash\nnode --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts status --account kalshi --format json --pretty\n```\n\nSync a live market quote into the ledger:\n\n```bash\nnode --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts sync-market --market <TICKER> --format json --pretty\n```\n\nOpen a paper trade from the live Kalshi ask:\n\n```bash\nnode --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts buy-from-market --account kalshi --market <TICKER> --side YES --contracts 1 --format json --pretty\n```\n\nReconcile a finalized market:\n\n```bash\nnode --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts reconcile --account kalshi --market <TICKER> --winning-side YES\n```\n\nReview account performance:\n\n```bash\nnode --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts review --account kalshi --format json --pretty\n```\n\n## Integration\n\nPair this skill with a separate Kalshi API read skill for:\n\n- market discovery\n- liquidity validation\n- trades and orderbook checks\n- pre-trade candidate ranking\n\nThis skill owns the paper ledger and execution side only.\n\n## Design Reference\n\nRead the proposal before making structural changes:\n\n- [references/kalshi-paper-ledger.md](references/kalshi-paper-ledger.md)\n\nUse that document for:\n\n- schema design\n- command surface\n- valuation rules\n- settlement logic\n- migration plan away from the generic paper trader\n\n## Tests\n\nRun the Kalshi paper-trader test file:\n\n```bash\nnode --test {baseDir}/tests/kalshi_paper.test.mjs\n```\n","topics":["Trading"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":687,"installsAllTime":26,"installsCurrent":0,"stars":1,"versions":1},"createdAt":1773341357538,"updatedAt":1778491865024},"latestVersion":{"version":"1.0.0","createdAt":1773341357538,"changelog":"- Initial release of Kalshi-native paper trading ledger and CLI.\n- Enables paper opens, closing, reconciliation, valuation, and review for Kalshi binary prediction contracts.\n- Uses integer cents for price and settlement to match Kalshi conventions.\n- Positions are tracked by `market_ticker + contract_side`; supports Kalshi-native risk/exposure rules.\n- Integrates with a separate Kalshi API read skill for quotes and market discovery.\n- Includes sample CLI commands for initializing accounts, trading, syncing quotes, reconciling, and reviewing performance.","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"brs999","userId":"s178txbzyphw8mm8dpnnh6eyx183m9m4","displayName":"Ben","image":"https://avatars.githubusercontent.com/u/6516437?v=4"},"moderation":null}