margin-trading

What This Skill Does

The margin-trading skill provides an interface for interacting with Binance's complex margin trading ecosystem through OpenClaw. This skill enables users to perform both cross and isolated margin trading operations programmatically. It covers the full lifecycle of a margin position, including account management, borrowing, repaying, and retrieving historical data. Whether you are managing cross margin collateral, adjusting leverage ratios, or querying interest rate histories, this tool acts as a bridge between the Binance SAPI endpoints and the agent's workflow. It returns all results in a clean JSON format, making it ideal for integration into larger automated financial analysis pipelines.

Installation

To install this skill, use the ClawHub command line interface within your project terminal. Ensure you have your OpenClaw environment initialized before running the following command:

clawhub install openclaw/skills/skills/binance-skills-hub/binance-margin-trading

Once installed, ensure you have configured your Binance API credentials within the agent's security vault. The skill requires an API key and a secret key with 'Enable Margin' permissions checked in your Binance account settings to execute trade and borrow functions.

Use Cases

• Portfolio Rebalancing: Automatically borrow assets to cover margin requirements during high-volatility events.
• Risk Management: Monitor and adjust cross-margin leverage settings dynamically based on real-time market data.
• Audit & Reporting: Extract interest payment history and capital flow logs for tax reporting and accounting purposes.
• Isolated Position Control: Enable or disable isolated margin accounts for specific trading pairs to compartmentalize risk.
• Data-Driven Strategy: Query future interest rates and margin fee data to forecast the cost of carry for long-term leveraged positions.

Example Prompts

1. "Check my cross margin account details and list all currently enabled isolated margin symbols."
2. "What is the current hourly interest rate for BNB, and can you fetch the borrow history for the last 24 hours?"
3. "Adjust my max leverage for cross margin trading to 3x and confirm the change."

Tips & Limitations

• Authentication: Most endpoints require signed requests. Ensure your API keys have the appropriate scope; otherwise, you will receive 'Unauthorized' errors.
• Rate Limiting: Binance enforces strict weight-based rate limits. Avoid high-frequency polling on /sapi endpoints to prevent temporary IP bans.
• Security: Never expose your API secret keys in public code repositories. Use local encrypted configuration files or environment variables.
• Market Risk: Margin trading involves significant financial risk. Automated agents can execute trades faster than you can manually intervene, so always include stop-loss logic in your scripts.
• Maintenance: Some endpoints are specific to either Cross or Isolated margin; ensure your input parameters (like symbol vs asset) match the endpoint requirements documented in the reference guide.