OpenSkillIndex← back to search
claude-code

Skills kalshi-paper-trading

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.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/brs999/kalshi-paper-trading" ~/.claude/skills/clawdbot-skills-kalshi-paper-trading && rm -rf "$T"
manifest: skills/brs999/kalshi-paper-trading/SKILL.md
source content

Kalshi Paper Trading

Use this skill for Kalshi paper execution and ledger management.

Kalshi-native paper trading should use a dedicated ledger and CLI rather than the generic 

paper-trading
skill.

When to Use

Use this skill when the user wants to:

  • design or build a Kalshi-specific paper trader
  • inspect or reconcile Kalshi paper positions
  • store Kalshi prices correctly in cents without mixing units
  • compute Kalshi realized and unrealized PnL
  • add Kalshi-native exposure or risk rules

Key Rule

Do not route Kalshi paper executions through the generic 

skills/paper-trading
ledger unless the user explicitly asks to keep that compatibility.

Default assumptions for this skill:

  • Kalshi execution prices are stored as integer cents in 
    [0, 100]
  • settlement is 
    100
    or 
    0
    cents
  • positions are keyed by 
    market_ticker + contract_side
  • risk controls are based on premium and event exposure, not stop-distance percent risk
  • live market sync supports both legacy cent fields and modern Kalshi 
    *_dollars
    quote fields

Primary Commands

Initialize the paper account:

node --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts init --account kalshi --starting-balance-usd 1000

Check status:

node --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts status --account kalshi --format json --pretty

Sync a live market quote into the ledger:

node --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts sync-market --market <TICKER> --format json --pretty

Open a paper trade from the live Kalshi ask:

node --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts buy-from-market --account kalshi --market <TICKER> --side YES --contracts 1 --format json --pretty

Reconcile a finalized market:

node --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts reconcile --account kalshi --market <TICKER> --winning-side YES

Review account performance:

node --experimental-strip-types {baseDir}/scripts/kalshi_paper.ts review --account kalshi --format json --pretty

Integration

Pair this skill with a separate Kalshi API read skill for:

  • market discovery
  • liquidity validation
  • trades and orderbook checks
  • pre-trade candidate ranking

This skill owns the paper ledger and execution side only.

Design Reference

Read the proposal before making structural changes:

Use that document for:

  • schema design
  • command surface
  • valuation rules
  • settlement logic
  • migration plan away from the generic paper trader

Tests

Run the Kalshi paper-trader test file:

node --test {baseDir}/tests/kalshi_paper.test.mjs