openbroker

What This Skill Does

The openbroker skill is a powerful command-line interface (CLI) for the Hyperliquid decentralized exchange (DEX). It allows AI agents to interact directly with the Hyperliquid API, providing a seamless gateway for algorithmic trading, portfolio management, and market data retrieval. Whether you need to execute complex limit orders, monitor funding rates for delta-neutral strategies, or manage spot and perpetual positions, this tool bridges the gap between raw programmatic access and autonomous agent execution. It simplifies complex wallet management and builder fee approvals, making it an essential utility for any agent focused on DeFi or quantitative trading.

Installation

To integrate this skill into your OpenClaw environment, use the following command:

clawhub install openclaw/skills/skills/ya7ya/openbroker

Ensure you have Node.js installed on your system. Once installed, initialize the broker by running openbroker setup. This handles the generation of your local trading wallet, configuration of the .env file, and automatic approval of the required builder fees, ensuring you are ready to trade immediately.

Use Cases

1. Automated Trading Strategies: Deploy agents that monitor market signals (like funding rate spikes) and automatically execute market or limit orders to capitalize on price inefficiencies.
2. Portfolio Risk Management: Regularly fetch account equity, margin health, and position PnL to trigger rebalancing or emergency liquidation protection via TP/SL updates.
3. Market Intelligence: Query real-time data across various asset classes, including HYPE, BTC, ETH, and HIP-3 tokens, to inform high-level trading decisions or perform backtesting simulations.

Example Prompts

1. "OpenBroker, check the top 10 assets by funding rate and tell me if there are any opportunities to short tokens with a high negative funding rate."
2. "I need to hedge my position. Place a limit order to sell 5 SOL at a price of 200 USDC using the ALO (Add Liquidity Only) time-in-force instruction."
3. "Please update my current ETH position: set a take profit at +5% from my current entry price and a stop loss at breakeven."

Tips & Limitations

• Safety First: Always maintain sufficient margin in your Hyperliquid account to avoid unexpected liquidations.
• Configuration: The ~/.openbroker/.env file stores sensitive keys. Ensure your environment is secure and restricted.
• Slippage: Always specify custom slippage for large market orders to prevent slippage-induced losses, especially on low-liquidity pairs.
• Builder Fee: The tool automatically handles the builder fee approval; however, if you encounter errors, run openbroker approve-builder --check to verify your approval status.