kalshi-api

What This Skill Does

The kalshi-api skill is a powerful, read-only integration designed for the OpenClaw agent to interact with the Kalshi exchange. It serves as an essential intelligence layer for market discovery, liquidity assessment, and real-time market data validation. By providing structured access to market listings, event series, and deep order book snapshots, this tool empowers agents to identify high-probability opportunities without the risk of accidental order execution. It strictly adheres to read-only operations, acting as the research arm for your autonomous financial workflows.

Installation

To integrate this skill, use the ClawHub CLI. Ensure your environment is configured for Node.js (v18+) and that you have the necessary permissions to execute local scripts within the OpenClaw environment.

Command: clawhub install openclaw/skills/skills/brs999/kalshi-api

Once installed, you can verify the integration by running the status command: node {baseDir}/scripts/kalshi-api.mjs status --pretty

Use Cases

This skill is ideal for quantitative research, automated market scouting, and validation. Common use cases include:

1. Arbitrage Opportunity Detection: Scanning the entire open market landscape to identify pricing discrepancies across related event series.
2. Liquidity Analysis: Checking depth in the order book for specific tickers before attempting to route orders through a paper-trading skill.
3. Event-Driven Monitoring: Tracking the status of specific political or economic event series to trigger downstream logic once a market moves into a specific state.
4. Data Enrichment: Aggregating historical trade data for specific assets to perform trend analysis or probability calculations.

Example Prompts

1. "Scan all open markets for the 'Elections' category and report any tickers with a liquidity depth greater than $5,000 in the order book."
2. "Get the current trade history for ticker 'POL-2024-PRES' and provide a summary of the latest price action."
3. "List the top 10 most active event series currently open on Kalshi and explain which ones have the most significant market activity."

Tips & Limitations

• Read-Only Constraint: This skill cannot execute trades. It is designed to be paired with an execution-specific skill. Do not attempt to bypass these constraints; use it strictly for scouting.
• Rate Limiting: When scanning, be mindful of API rate limits. Use the --limit flag when requesting bulk market data to prevent timeouts.
• Environment Variables: For specific API endpoints, you can override the default URL using KALSHI_BASE_URL. Ensure your environment matches the network requirements of your target instance.
• Data Integrity: Always validate that the ticker symbols returned are currently active before passing them to secondary paper-trading execution scripts.