# Kalshi API

> Read-only Kalshi API skill for market discovery, liquidity checks, and market validation. Use for scanning and ranking Kalshi opportunities. Pair with a separate paper-trading skill if you want open/close execution.

- Skill: `dvcrn/kalshi-api` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvcrn/kalshi-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/kalshi-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/kalshi-api

---


# Kalshi API (Read-Only)

Use this skill for Kalshi scouting and market validation only.

## Rules

- Use OpenAPI read endpoints for market discovery and validation.
- This skill does not place, amend, or cancel orders.
- This skill does not include paper ledger execution scripts.

## Primary Commands

Exchange status:

```bash
node {baseDir}/scripts/kalshi-api.mjs status --pretty
```

Broad market scan:

```bash
node {baseDir}/scripts/kalshi-api.mjs markets --status open --limit 1000 --pretty
node {baseDir}/scripts/kalshi-api.mjs events --limit 100 --pretty
node {baseDir}/scripts/kalshi-api.mjs series --limit 400 --pretty
```

Focused validation:

```bash
node {baseDir}/scripts/kalshi-api.mjs market --ticker <TICKER> --pretty
node {baseDir}/scripts/kalshi-api.mjs trades --ticker <TICKER> --limit 200 --pretty
node {baseDir}/scripts/kalshi-api.mjs orderbook --ticker <TICKER> --pretty
```

## Optional Integration: Paper Ledger Skill Required

If you want paper open/close workflows, install and use a separate paper-trading skill that provides the execution script.
This Kalshi skill can supply candidate/market data to that separate skill.

```bash
node --experimental-strip-types skills/paper-trading/scripts/paper_trading.ts status --account kalshi --format json --pretty
```

## Environment

Optional override (defaults to Kalshi production API):

```bash
export KALSHI_BASE_URL="https://api.elections.kalshi.com/trade-api/v2"
```

## Tests

Run the Kalshi reader smoke tests:

```bash
node --test {baseDir}/tests/kalshi-api.test.mjs
```