kalshi-agent

What This Skill Does

The kalshi-agent skill provides a powerful command-line interface for interacting with the Kalshi prediction market platform. It enables users to browse active markets, perform granular searches across events, view detailed orderbook depth, and execute trades directly from their terminal or an AI agent environment. By integrating the Kalshi v2 API, the skill facilitates seamless portfolio management, allowing users to track balances, monitor open positions, and place or cancel orders with precision.

Installation

To integrate the skill into your OpenClaw environment, use the command: clawhub install openclaw/skills/skills/jthomasdevs/kalshi-agent. Additionally, ensure the required CLI tools are available via npm install -g kalshi-cli. Setup requires securing an API access key from Kalshi and configuring your RSA private key at ~/.kalshi/private_key.pem, along with your environment variables.

Use Cases

This skill is ideal for quantitative researchers and traders who want to automate market analysis. It is frequently used to:

1. Aggregate market trends: Quickly search for sports, political, or economic events by category to identify potential entry points.
2. Execute high-speed trades: Use the CLI to place buy or sell orders on specific contracts without navigating the web UI.
3. Portfolio monitoring: Keep a real-time pulse on your positions and active orders, allowing for rapid decision-making based on market volatility.
4. Analytical research: Drill down into specific orderbooks to see market depth, helping to inform better pricing strategies for contract acquisition.

Example Prompts

1. "Search for all active NFL-related markets, sort them by the soonest expiry, and show me the top 10 results."
2. "Check my current portfolio balance and list all open positions I have in the gold market."
3. "Buy 50 'YES' contracts for the KXWO-GOLD-26 market at a limit price of 65 cents."

Tips & Limitations

Always use the --force flag with caution when executing trades, as it bypasses confirmation prompts. When searching, leverage the interactive series list to efficiently navigate thousands of market options. Note that this skill requires direct network access to Kalshi servers and read/write access to your local configuration directory. Ensure your private key file has restricted permissions for enhanced security. For the best experience, familiarize yourself with the ticker naming conventions provided in the Kalshi documentation, as direct lookups are significantly faster than broad keyword searches.