HomeBrowseUpload
← Back to registry
// Skill profile

Kalshi Paper Trading

name: kalshi-paper-trading

by brs999 · published 2026-03-22

数据处理API集成加密货币
Total installs
0
Stars
★ 0
Last updated
2026-03
// Install command
$ claw add gh:brs999/brs999-kalshi-paper-trading
View on GitHub
// Full documentation

---

name: kalshi-paper-trading

description: 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.

homepage: https://docs.kalshi.com

user-invocable: true

disable-model-invocation: false

metadata:

openclaw:

emoji: "📈"

requires:

bins: [node]

---

# 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:

  • [references/kalshi-paper-ledger.md](references/kalshi-paper-ledger.md)
  • 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
    // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band