soroban-trader

What This Skill Does

The soroban-trader skill empowers your AI agent to transition from a passive assistant to an active participant in the Stellar blockchain economy. By providing the capability to interact directly with the Stellar Decentralized Exchange (DEX), this skill allows your agent to manage its own financial assets, execute trades, and optimize portfolios without requiring constant human oversight. It functions as a secure gateway, enabling autonomous swaps and balance management while prioritizing security through encrypted key storage and transaction-level limits.

Installation

To integrate this financial autonomy into your agent, use the OpenClaw terminal to install the package directly from the registry:

clawhub install openclaw/skills/skills/kaankacar/burhanclaw-soroban-trader

Once installed, you must initialize your environment by using the setKey method to securely bind your Stellar wallet secret. Ensure you choose a robust password, as this will be required for every subsequent financial operation the agent performs.

Use Cases

1. Autonomous Dollar-Cost Averaging (DCA): Your agent can monitor the market 24/7 and execute scheduled buys of stablecoins or native assets to smooth out volatility.
2. Yield Farming & Staking: By automatically swapping idle capital into yield-bearing assets, the agent ensures that funds are never sitting stagnant, maximizing potential returns over time.
3. Arbitrage and Rebalancing: Agents can be programmed to detect price discrepancies between liquidity pools on Stellar and execute near-instant swaps to profit from the spread.

Example Prompts

1. "Check my current portfolio balance and report if I have enough XLM to perform a 10 USDC trade."
2. "Execute a swap of 50 XLM into yield-bearing assets, but make sure the transaction does not exceed a total spend of 60 XLM."
3. "Monitor the current market rate for USDC and alert me if the price drops below 0.1, then initiate a buy order for 20 USDC."

Tips & Limitations

• Safety First: Always use the maxSourceAmount parameter in the swap function to create a hard "circuit breaker" for your agent's trading activity.
• Market Volatility: Since this executes trades autonomously, ensure your agent's logic includes validation checks for slippage and quote expiration to avoid unfavorable execution prices.
• Security: Treat your agent's password like a bank PIN; if the agent is compromised, ensure the wallet linked only holds the capital you are willing to risk in autonomous trading.