pp-kalshi
Kalshi — Printing Press CLI
Prerequisites: Install the CLI
This skill drives the kalshi-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
- Install via the Printing Press installer:
npx -y @mvanhorn/printing-press install kalshi --cli-only - Verify:
kalshi-pp-cli --version - Ensure
$GOPATH/bin(or$HOME/go/bin) is on$PATH.
If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):
go install github.com/mvanhorn/printing-press-library/library/payments/kalshi/cmd/kalshi-pp-cli@latest
If --version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds.
When to Use This CLI
Reach for kalshi-pp-cli when an agent needs price-over-time or category-level analytics on Kalshi markets — the public API only returns current prices and flat positions, so historical and aggregated questions require the local snapshot store. Use it for daily portfolio reconciliation, signal discovery via correlation across markets, and safe scripting against read-only API credentials.
Unique Capabilities
These capabilities aren't available in any other tool for this API.
portfolio attribution— See your P&L broken down by market category and series over any time periodmarkets history— Track how market odds moved over time with price progression chartsportfolio winrate— Calculate your win/loss ratio, expected value, and ROI across all settled positionsportfolio calendar— See upcoming settlements with your positions, expected payouts, and category breakdownmarkets movers— Find markets with the biggest price swings since your last syncmarkets correlate— Compare price histories of two markets to discover correlated eventsportfolio exposure— See your total risk broken down by category, with concentration warningsportfolio stale— Find positions in markets approaching expiry where you haven't acted recently
Command Reference
account — Manage account
kalshi-pp-cli account get-api-limits— Endpoint to retrieve the API tier limits associated with the authenticated user.kalshi-pp-cli account get-endpoint-costs— Lists API v2 endpoints whose configured token cost differs from the default cost. Endpoints that use the default...
api-keys — API key management endpoints
kalshi-pp-cli api-keys create— Endpoint for creating a new API key with a user-provided public key. This endpoint allows users with Premier or...kalshi-pp-cli api-keys delete— Endpoint for deleting an existing API key. This endpoint permanently deletes an API key. Once deleted, the key can...kalshi-pp-cli api-keys generate— Endpoint for generating a new API key with an automatically created key pair. This endpoint generates both a public...kalshi-pp-cli api-keys get— Endpoint for retrieving all API keys associated with the authenticated user. API keys allow programmatic access to...
communications — Request-for-quote (RFQ) endpoints
kalshi-pp-cli communications accept-quote— Endpoint for accepting a quote. This will require the quoter to confirmkalshi-pp-cli communications confirm-quote— Endpoint for confirming a quote. This will start a timer for order executionkalshi-pp-cli communications create-quote— Endpoint for creating a quote in response to an RFQkalshi-pp-cli communications create-rfq— Endpoint for creating a new RFQ. You can have a maximum of 100 open RFQs at a time.kalshi-pp-cli communications delete-quote— Endpoint for deleting a quote, which means it can no longer be accepted.kalshi-pp-cli communications delete-rfq— Endpoint for deleting an RFQ by IDkalshi-pp-cli communications get-id— Endpoint for getting the communications ID of the logged-in user.kalshi-pp-cli communications get-quote— Endpoint for getting a particular quotekalshi-pp-cli communications get-quotes— Endpoint for getting quoteskalshi-pp-cli communications get-rfq— Endpoint for getting a single RFQ by idkalshi-pp-cli communications get-rfqs— Endpoint for getting RFQs
events — Event endpoints
kalshi-pp-cli events get— Get all events. This endpoint excludes multivariate events. To retrieve multivariate events, use the GET...kalshi-pp-cli events get-eventticker— Endpoint for getting data about an event by its ticker. An event represents a real-world occurrence that can be...kalshi-pp-cli events get-multivariate— Retrieve multivariate (combo) events. These are dynamically created events from multivariate event collections....
exchange — Exchange status and information endpoints
kalshi-pp-cli exchange get-announcements— Endpoint for getting all exchange-wide announcements.kalshi-pp-cli exchange get-schedule— Endpoint for getting the exchange schedule.kalshi-pp-cli exchange get-status— Endpoint for getting the exchange status.kalshi-pp-cli exchange get-user-data-timestamp— There is typically a short delay before exchange events are reflected in the API endpoints. Whenever possible,...
fcm — FCM member specific endpoints
kalshi-pp-cli fcm get-fcmorders— Endpoint for FCM members to get orders filtered by subtrader ID. This endpoint requires FCM member access level and...kalshi-pp-cli fcm get-fcmpositions— Endpoint for FCM members to get market positions filtered by subtrader ID. This endpoint requires FCM member access...
historical — Manage historical
kalshi-pp-cli historical get-cutoff— Returns the cutoff timestamps that define the boundary between live and historical data. ## Cutoff fields -...kalshi-pp-cli historical get-fills— Endpoint for getting all historical fills for the member. A fill is when a trade you have is matched.kalshi-pp-cli historical get-market— Endpoint for getting data about a specific market by its ticker from the historical database.kalshi-pp-cli historical get-market-candlesticks— Endpoint for fetching historical candlestick data for markets that have been archived from the live data set. Time...kalshi-pp-cli historical get-markets— Endpoint for getting markets that have been archived to the historical database. Filters are mutually exclusive.kalshi-pp-cli historical get-orders— Endpoint for getting orders that have been archived to the historical database.kalshi-pp-cli historical get-trades— Endpoint for getting all historical trades for all markets. Trades that were filled before the historical cutoff are...
incentive-programs — Incentive program endpoints
kalshi-pp-cli incentive-programs— List incentives with optional filters. Incentives are rewards programs for trading activity on specific markets.
kalshi-trade-manual-search — Manage kalshi trade manual search
kalshi-pp-cli kalshi-trade-manual-search— Retrieve available filters organized by sport. This endpoint returns filtering options available for each sport,...
kalshi-trade-manual-search-2 — Manage kalshi trade manual search 2
kalshi-pp-cli kalshi-trade-manual-search-2— Retrieve tags organized by series categories. This endpoint returns a mapping of series categories to their...
live-data — Live data endpoints
kalshi-pp-cli live-data get— Get live data for multiple milestoneskalshi-pp-cli live-data get-by-milestone— Get live data for a specific milestone.kalshi-pp-cli live-data get-game-stats— Get play-by-play game statistics for a specific milestone. Supported sports: Pro Football, College Football, Pro...
markets — Market data endpoints
kalshi-pp-cli markets batch-get-candlesticks— Endpoint for retrieving candlestick data for multiple markets. - Accepts up to 100 market tickers per request -...kalshi-pp-cli markets get— Filter by market status. Possible values:unopened,open,closed,settled. Leave empty to return markets...kalshi-pp-cli markets get-orderbooks— Endpoint for getting the current order books for multiple markets in a single request. The order book shows all...kalshi-pp-cli markets get-ticker— Endpoint for getting data about a specific market by its ticker. A market represents a specific binary outcome...kalshi-pp-cli markets get-trades— Endpoint for getting all trades for all markets. A trade represents a completed transaction between two users on a...
milestones — Milestone endpoints
kalshi-pp-cli milestones get— Minimum start date to filter milestones. Format: RFC3339 timestampkalshi-pp-cli milestones get-milestoneid— Endpoint for getting data about a specific milestone by its ID.
multivariate-event-collections — Manage multivariate event collections
kalshi-pp-cli multivariate-event-collections create-market-in— Endpoint for creating an individual market in a multivariate event collection. This endpoint must be hit at least...kalshi-pp-cli multivariate-event-collections get— Endpoint for getting data about multivariate event collections.kalshi-pp-cli multivariate-event-collections get-multivariateeventcollections— Endpoint for getting data about a multivariate event collection by its ticker.
portfolio — Portfolio and balance information endpoints
kalshi-pp-cli portfolio amend-order— Endpoint for amending the max number of fillable contracts and/or price in an existing order. Max fillable contracts...kalshi-pp-cli portfolio amend-order-v2— Endpoint for amending the price and/or remaining count of an existing event-market order using the V2...kalshi-pp-cli portfolio apply-subaccount-transfer— Transfers funds between the authenticated user's subaccounts. Use 0 for the primary account, or 1-32 for numbered...kalshi-pp-cli portfolio batch-cancel-orders— Endpoint for cancelling a batch of orders. The maximum batch size scales with your tier's write budget — see [Rate...kalshi-pp-cli portfolio batch-cancel-orders-v2— Endpoint for cancelling a batch of event-market orders using the V2 response shape. The maximum batch size scales...kalshi-pp-cli portfolio batch-create-orders— Endpoint for submitting a batch of orders. The maximum batch size scales with your tier's write budget — see [Rate...kalshi-pp-cli portfolio batch-create-orders-v2— Endpoint for submitting a batch of event-market orders using the V2 request/response shape. The maximum batch size...kalshi-pp-cli portfolio cancel-order— Endpoint for canceling orders. The value for the orderId should match the id field of the order you want to...kalshi-pp-cli portfolio cancel-order-v2— Endpoint for cancelling event-market orders using the V2 response shape. Returns `{order_id, client_order_id,...kalshi-pp-cli portfolio create-order— Endpoint for submitting orders in a market. Each user is limited to 200 000 open orders at a time.kalshi-pp-cli portfolio create-order-group— Creates a new order group with a contracts limit measured over a rolling 15-second window. When the limit is hit,...kalshi-pp-cli portfolio create-order-v2— Endpoint for submitting event-market orders using the V2 request/response shape (single-bookbid/askside and...kalshi-pp-cli portfolio create-subaccount— Creates a new subaccount for the authenticated user. Subaccounts are numbered sequentially starting from 1. Maximum...kalshi-pp-cli portfolio decrease-order— Endpoint for decreasing the number of contracts in an existing order. This is the only kind of edit available on...kalshi-pp-cli portfolio decrease-order-v2— Endpoint for decreasing the remaining count of an existing event-market order using the V2 request/response shape....kalshi-pp-cli portfolio delete-order-group— Deletes an order group and cancels all orders within it. This permanently removes the group.kalshi-pp-cli portfolio get-balance— Endpoint for getting the balance and portfolio value of a member. Both values are returned in cents.kalshi-pp-cli portfolio get-fills— Endpoint for getting all fills for the member. A fill is when a trade you have is matched. Fills that occurred...kalshi-pp-cli portfolio get-order— Endpoint for getting a single order.kalshi-pp-cli portfolio get-order-group— Retrieves details for a single order group including all order IDs and auto-cancel status.kalshi-pp-cli portfolio get-order-groups— Retrieves all order groups for the authenticated user.kalshi-pp-cli portfolio get-order-queue-position— Endpoint for getting an order's queue position in the order book. This represents the amount of orders that need to...kalshi-pp-cli portfolio get-order-queue-positions— Endpoint for getting queue positions for all resting orders. Queue position represents the number of contracts that...kalshi-pp-cli portfolio get-orders— Restricts the response to orders that have a certain status: resting, canceled, or executed. Orders that have been...kalshi-pp-cli portfolio get-positions— Restricts the positions to those with any of following fields with non-zero values, as a comma separated list. The...kalshi-pp-cli portfolio get-resting-order-total-value— Endpoint for getting the total value, in cents, of resting orders. This endpoint is only intended for use by FCM...kalshi-pp-cli portfolio get-settlements— Endpoint for getting the member's settlements historical track.kalshi-pp-cli portfolio get-subaccount-balances— Gets balances for all subaccounts including the primary account.kalshi-pp-cli portfolio get-subaccount-netting— Gets the netting enabled settings for all subaccounts.kalshi-pp-cli portfolio get-subaccount-transfers— Gets a paginated list of all transfers between subaccounts for the authenticated user.kalshi-pp-cli portfolio reset-order-group— Resets the order group's matched contracts counter to zero, allowing new orders to be placed again after the limit...kalshi-pp-cli portfolio trigger-order-group— Triggers the order group, canceling all orders in the group and preventing new orders until the group is reset.kalshi-pp-cli portfolio update-order-group-limit— Updates the order group contracts limit (rolling 15-second window). If the updated limit would immediately trigger...kalshi-pp-cli portfolio update-subaccount-netting— Updates the netting enabled setting for a specific subaccount. Use 0 for the primary account, or 1-32 for numbered...
series — Manage series
kalshi-pp-cli series get— Endpoint for getting data about a specific series by its ticker. A series represents a template for recurring events...kalshi-pp-cli series get-fee-changes— Get Series Fee Changeskalshi-pp-cli series get-list— Endpoint for getting data about multiple series with specified filters. A series represents a template for recurring...
structured-targets — Structured targets endpoints
kalshi-pp-cli structured-targets get— Page size (min: 1, max: 2000)kalshi-pp-cli structured-targets get-structuredtargets— Endpoint for getting data about a specific structured target by its ID.
Finding the right command
When you know what you want to do but not which command does it, ask the CLI directly:
kalshi-pp-cli which "<capability in your own words>"
which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.
Recipes
Politics-category P&L this quarter
kalshi-pp-cli portfolio attribution --since 2026-01-01 --by category --agent --select 'rows.category,rows.realized_pnl,rows.fills'
Realized P&L attributed to Kalshi taxonomy; --select narrows the response to the three fields agents need.
Track the Fed-cut market on a watchlist
kalshi-pp-cli watch add KXFEDFUNDS-26FEB && kalshi-pp-cli watch diff --since 24h --agent
Add ticker to local watchlist, then ask for the per-ticker delta since yesterday.
Correlate inflation and rate-cut markets
kalshi-pp-cli markets correlate KXFEDFUNDS-26FEB KXCPI-26FEB --window 30d --agent
Pearson r computed locally over snapshot price series for both markets.
Safe paper-trading session
KALSHI_READ_ONLY=1 kalshi-pp-cli portfolio create-order --ticker KXTEST-2026 --side yes --count 1 --yes-price 50 --action buy --dry-run
Both safety floors engaged: client-side read-only lock + dry-run; never reaches the API.
Movers in sports markets, last 24h
kalshi-pp-cli markets movers --window 24h --category sports --limit 5 --agent
Computes price deltas from market_price_history snapshots; works offline after a sync.
Auth Setup
Kalshi requires composed RSA-PSS signature auth: a UUID access key id (KALSHI_API_KEY) plus an RSA private key file (KALSHI_PRIVATE_KEY_PATH or KALSHI_PRIVATE_KEY). Kalshi issues two key tiers — read-only and read/write — and the CLI honors KALSHI_READ_ONLY=1 (or --read-only) as a client-side lock that blocks every POST/PUT/PATCH/DELETE before signing, regardless of which tier is loaded. Write commands run against a read-only key will surface a 403 from Kalshi; pair with --dry-run while debugging.
Run kalshi-pp-cli doctor to verify setup.
Agent Mode
Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.
-
Pipeable — JSON on stdout, errors on stderr
-
Filterable —
--selectkeeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:kalshi-pp-cli api-keys get --agent --select id,name,status -
Previewable —
--dry-runshows the request without sending -
Offline-friendly — sync/search commands can use the local SQLite store when available
-
Non-interactive — never prompts, every input is a flag
Response envelope
Commands that read from the local store or the API wrap output in a provenance envelope:
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}
Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
Agent Feedback
When you (or the agent) notice something off about this CLI, record it:
kalshi-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
kalshi-pp-cli feedback --stdin < notes.txt
kalshi-pp-cli feedback list --json --limit 10
Entries are stored locally at ~/.kalshi-pp-cli/feedback.jsonl. They are never POSTed unless KALSHI_FEEDBACK_ENDPOINT is set AND either --send is passed or KALSHI_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
Output Delivery
Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
| Sink | Effect |
|---|---|
stdout |
Default; write to stdout only |
file:<path> |
Atomically write output to <path> (tmp + rename) |
webhook:<url> |
POST the output body to the URL (application/json or application/x-ndjson when --compact) |
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
Named Profiles
A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
kalshi-pp-cli profile save briefing --json
kalshi-pp-cli --profile briefing api-keys get
kalshi-pp-cli profile list --json
kalshi-pp-cli profile show briefing
kalshi-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Resource not found |
| 4 | Authentication required |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |
Argument Parsing
Parse $ARGUMENTS:
- Empty,
help, or--help→ showkalshi-pp-cli --helpoutput - Starts with
install→ ends withmcp→ MCP installation; otherwise → see Prerequisites above - Anything else → Direct Use (execute as CLI command with
--agent)
MCP Server Installation
- Install the MCP server:
go install github.com/mvanhorn/printing-press-library/library/other/kalshi/cmd/kalshi-pp-mcp@latest - Register with Claude Code:
claude mcp add kalshi-pp-mcp -- kalshi-pp-mcp - Verify:
claude mcp list
Direct Use
- Check if installed:
which kalshi-pp-cliIf not found, offer to install (see Prerequisites at the top of this skill). - Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the
--agentflag:kalshi-pp-cli <command> [subcommand] [args] --agent - If ambiguous, drill into subcommand help:
kalshi-pp-cli <command> --help.
More from mvanhorn/printing-press-library
pp-flight-goat
Search Google Flights, scan Kayak long-haul routes, and join FlightAware AeroAPI reliability, alerts, and tracking from one CLI.
448pp-espn
Use this skill whenever the user asks about live sports scores, standings, team stats, game summaries (with box score, leaders, scoring plays, odds, and win probability), NFL / NBA / MLB / NHL / NCAA / MLS / EPL / WNBA games, team schedules, polls, or rankings. ESPN sports CLI with live scores across 10 leagues, offline search, head-to-head comparisons, and rich per-game summary payloads. No API key required. Triggers on natural phrasings like 'what's the score of the Lakers game', 'Patriots schedule this week', 'NFL standings', 'box score for tonight's Mavs game', 'Chiefs vs Eagles head to head', 'who's on top of the AP poll'.
387pp-movie-goat
The movie CLI that combines TMDb's discovery engine with OMDb's multi-source ratings — and ships a SQLite watchlist that flags what's streaming on your services right now. Trigger phrases: `what should I watch tonight`, `where can I stream <title>`, `rate <title>`, `compare <title> and <title>`, `what's <person>'s filmography`, `plan a <franchise> marathon`, `use movie-goat`, `run movie-goat`.
342pp-recipe-goat
Printing Press CLI for Recipe Goat. Recipe GOAT — find the best version of any recipe across 37 trusted sites, with offline cookbook, pantry match,...
329pp-company-goat
Look up startups across SEC Form D, GitHub, Hacker News, Companies House, YC, and Wikidata in one command — including the SEC fundraising data hidden behind paid Crunchbase tiers. Trigger phrases: `look up this startup`, `research <company>`, `what does <company> do`, `form D for <company>`, `is <company> still active`, `compare <a> and <b>`, `use company-goat`, `run company-goat-pp-cli`.
162pp-hackernews
Hacker News from your terminal — with a local SQLite store, snapshot history, and agent-native output no other HN tool has. Trigger phrases: `check hacker news`, `search hn`, `what is hn saying about`, `diff the hn front page`, `pulse on hn`, `look up hn user`, `hn who is hiring`, `hn top stories`, `use hackernews`, `run hackernews`.
129