kalshi

What This Skill Does

The Kalshi skill enables OpenClaw AI agents to interact directly with the Kalshi prediction market exchange. It provides a robust interface to search for event-based contracts, analyze market sentiment via orderbooks, and execute trades on a CFTC-regulated platform. The skill wraps the Kalshi API into a set of accessible CLI commands, allowing users to query portfolio balances, track trending events, and manage the full lifecycle of an order (placing, monitoring, and canceling). It is designed for users interested in speculative markets covering politics, macroeconomics, technology, and weather events.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/ghsmc/kalshi-trading

Ensure that your environment is configured with the necessary API authentication keys required by the Kalshi CLI before attempting to place trades.

Use Cases

This skill is ideal for:

• Automated Portfolio Tracking: Quickly retrieve current cash balances and active position values across all prediction markets.
• Market Research: Search for niche events, such as the probability of specific interest rate hikes or election outcomes, using the search and trending commands.
• Algorithmic Trading: Integrate price analysis and market data to inform and execute manual or automated buy/sell orders.
• Order Lifecycle Management: Maintain control over resting orders by programmatically checking status, monitoring fills, and canceling positions that no longer meet your criteria.

Example Prompts

1. "Check the current trending markets on Kalshi and tell me what the volume looks like for the top 3."
2. "Search for the latest Bitcoin price prediction markets and show me the orderbook for the most liquid ticker."
3. "If the YES contract for the upcoming election event is trading below 45 cents, place a buy order for 10 contracts at that price."

Tips & Limitations

• Safety First: The skill is strictly configured to require user confirmation for every buy or sell order. Do not bypass this check.
• Price Precision: Remember that prices are quoted in cents (1-99). A price of 60 equals $0.60 per contract. Always calculate the total cost (count * price) before confirming a trade.
• API Dependency: The skill relies on the availability of the Kalshi API. If the service is under maintenance, CLI commands may return errors. Always parse the JSON output provided by the CLI to handle potential API errors gracefully.