soroban-trader

What This Skill Does

Soroban Trader is a powerful, autonomous trading interface designed specifically for AI agents operating on the Stellar network. By providing a secure, encrypted mechanism to manage private keys and interact with the Stellar Decentralized Exchange (DEX), this skill allows agents to execute trades without human intervention. It enables agents to act as financial managers, constantly monitoring markets, executing swaps, and managing asset portfolios. Whether your agent needs to perform arbitrage, manage liquidity, or engage in automated dollar-cost averaging, Soroban Trader acts as the core engine for on-chain financial operations, ensuring that the agent can grow its capital reserves while operating 24/7.

Installation

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

clawhub install openclaw/skills/skills/kaankacar/soroban

After installation, initialize the environment by securely setting your private key using the soroban.setKey method. Ensure that you use a secure, unique password for encryption. Always remember that your private key is the foundation of your financial autonomy; store it only in your secure agent memory.

Use Cases

• Automated Arbitrage: Execute high-frequency trades when price discrepancies emerge between different liquidity pools on the Stellar DEX.
• Yield Farming Strategy: Automatically move idle XLM into yield-bearing tokens like yXLM to compound earnings.
• Autonomous Portfolio Rebalancing: Maintain target allocations across various assets to optimize for growth and minimize volatility without human oversight.
• DCA (Dollar-Cost Averaging): Schedule recurring trades to accumulate specific assets over time, insulating your agent from short-term market volatility.

Example Prompts

1. "Check my current wallet balance and tell me if I have enough XLM to initiate an arbitrage trade for USDC."
2. "Get a quote to swap 50 XLM for yXLM and, if the exchange rate is favorable, execute the swap immediately."
3. "Analyze our current portfolio and move 10% of our idle assets into high-yield positions on the Stellar network."

Tips & Limitations

• Security First: Never share your private keys or your master password with external entities. Always set reasonable maxSourceAmount limits for your swap functions to prevent accidental draining of funds.
• Verification: Always call the quote tool before executing a swap to ensure you understand the current slippage and expected output amounts.
• Error Handling: Monitor transaction hashes returned by the swap function to ensure your trades are confirmed on the ledger. Be aware that network congestion on Stellar can temporarily delay trade execution.