deepbook-cli

What This Skill Does

The deepbook-cli skill empowers the OpenClaw agent to interact directly with the DeepBook decentralized exchange protocol. It serves as a comprehensive interface for managing DeepBook accounts, configuring network parameters, and executing on-chain financial operations. Whether you are performing market research, executing complex spot trades, or managing sophisticated margin positions, this skill bridges the gap between natural language requests and the underlying DeepBook CLI binary. It abstracts away the complexity of configuring RPC URLs, API keys, and managing local configuration files, allowing users to focus on trading and market data analysis.

Installation

To install this skill, use the ClawHub command within your OpenClaw environment:

clawhub install openclaw/skills/skills/astinz/deepbook-cli

Before using the skill, ensure the underlying CLI binary is available on your system by running deepbook --version. If it is missing, install the dependency globally via npm: npm install -g deepbook-cli. The skill will automatically detect your ~/.deepbook/config.json file for account management and network settings.

Use Cases

• Market Research: Fetching order books, trade history, and OHLCV data for specific trading pools to inform decision-making.
• Automated Trading: Executing spot buy/sell orders, limit orders, and swap executions across both testnet and mainnet environments.
• Account Management: Configuring global defaults, switching between different network providers, and managing multiple wallet addresses via the integrated account manager.
• Margin Operations: Managing margin accounts, checking positions, and depositing or withdrawing collateral directly through the CLI interface.

Example Prompts

1. "Check the current order book for the SUI/USDC pool on mainnet and tell me the best bid and ask prices."
2. "Place a limit buy order for 100 SUI on the SUI/USDC pool at a price of 0.85 using my default manager."
3. "Switch my account context to the 'trader-alt' alias and display my current balances and active positions."

Tips & Limitations

Always verify the current network context before executing trades, especially when switching between testnet and mainnet, to avoid unintended financial consequences. The skill relies on the local ~/.deepbook configuration; ensure your API keys and private keys are stored securely using your system's keychain or secure environment variables where possible. Note that while the skill supports high-level automation, real-time streaming features (via deepbook stream) require a stable, low-latency connection to the configured stream provider to ensure data integrity.