axelrod

# Axelrod Execute Base-chain trading and on-chain queries using natural language through the AIxVC AI Automation. ## Quick Start ### First-Time Setup 1. **Configure credentials** in OpenClaw config under `skills.entries.axelrod.env`: ```json { "skills": { "entries": { "axelrod": { "enabled": true, "env": { "AIXVC_ACCESS_KEY": "your_access_key", "AIXVC_SECRET_KEY": "your_secret_key" } } } } } ``` 2. **Install dependencies**: ```bash pip install -r skills/axelrod/requirements.txt ``` 3. **Verify setup**: ```bash python skills/axelrod/scripts/axelrod_chat.py --message "check my balance" ``` ## Core Usage ### Simple Query For straightforward requests that complete quickly: ```bash python skills/axelrod/scripts/axelrod_chat.py --message "check my ETH balance" python skills/axelrod/scripts/axelrod_chat.py --message "what is ETH price now" ``` ### JSON Debug Mode For inspecting the full API response: ```bash python skills/axelrod/scripts/axelrod_chat.py --message "check my balance" --json ``` ## Mandatory Workflow 1. **Check AK/SK** — If `AIXVC_ACCESS_KEY` or `AIXVC_SECRET_KEY` is missing, ask the user to configure them. Do not guess or fabricate credentials. 2. **Run the script** — Whenever the request needs real-time on-chain data or execution, always run the CLI. Do not answer from model memory alone. 3. **Return stdout** — Capture the script's stdout and return it to the user. Light formatting is fine, but do not omit key results (amounts, tx hashes, confirm keys, error messages). 4. **Handle confirmation** — If the response includes `confirmKey`, guide the user to confirm or cancel (see Confirmation Flow below). ## Capabilities Overview ### Trading Operations - **Spot Buy/Sell/Swap**: Exchange tokens on Base chain - **DCA**: Dollar-cost averaging automation (e.g. "DCA 20u into ETH every day") - **Limit/Trigger Orders**: Execute at target prices or PnL rates - **RSI Strategy**: Conditional trading based on RSI indicators (e.g. "if 1h RSI < 30, buy 100u BTC") - **Take-Profit / Stop-Loss**: Automated risk management via `QUERY_ALGO` **Reference**: [references/api.md](references/api.md) ### Query Operations - **Balance Query**: Single token or all-asset portfolio - **Token Info & Analysis**: Contract details, decimals, analytics - **Price Query**: Real-time prices with 24h change - **Order Query**: Active order list and details - **TP/SL Order Query**: Take-profit/stop-loss order status ### Blockchain Assistant - Crypto/DeFi domain Q&A and execution guidance - Trading plan suggestions on Base chain ## Confirmation Flow Orders usually require risk-control confirmation; small orders (approximately ≤ $10) may skip confirmation. `confirmKey` is valid for about **10 minutes**. When the response includes `confirmKey`, ask the user to send one of: ```text yes, please execute <confirmKey> no, please cancel <confirmKey> ``` If the key has expired, the user must submit the original request again. ## Current Limitations | Limitation | Details | | ---------- | ------- | | Chain | Base only | | Multiple trades | One trade per message; ask user to split if needed | | Not supported | Leverage/futures/options, lending, cross-chain, NFT, fiat on/off-ramp | ## Common Patterns ### Check Before Trading ```bash # Check balance python skills/axelrod/scripts/axelrod_chat.py --message "check my ETH balance" # Check price python skills/axelrod/scripts/axelrod_chat.py --message "what is ETH price now" # Then trade python skills/axelrod/scripts/axelrod_chat.py --message "buy 50u of ETH" ``` ### Automated Strategies ```bash # DCA strategy python skills/axelrod/scripts/axelrod_chat.py --message "DCA 20u into ETH every day" # RSI conditional strategy python skills/axelrod/scripts/axelrod_chat.py --message "if 1h RSI < 30, buy 100u BTC" # Limit order python skills/axelrod/scripts/axelrod_chat.py --message "buy ETH when price drops to 2500" ``` ### Portfolio Review ```bash # Full portfolio python skills/axelrod/scripts/axelrod_chat.py --message "check my balance" # Token analysis python skills/axelrod/scripts/axelrod_chat.py --message "analyze AXR token for me" # Order status python skills/axelrod/scripts/axelrod_chat.py --message "show my recent orders" ``` ## Error Handling ### Exit Codes | Code | Meaning | Resolution | | ---- | ------- | ---------- | | `0` | Success | — | | `2` | Missing AK/SK | Ask user to configure `AIXVC_ACCESS_KEY` and `AIXVC_SECRET_KEY` | | `3` | HTTP failure or invalid/non-JSON response | Check network, verify endpoint is reachable | | `4` | API business error (`code` not in success set) | Read the error message, guide user to fix | ### Common Issues | Issue | Resolution | | ----- | ---------- | | "Please login first" | AK/SK is incorrect — reconfigure credentials | | Authentication error | Verify AK/SK are correct and not expired | | Insufficient balance | Reduce trade amount or add funds | | Token not found | Check token symbol or contract address | | confirmKey expired | Re-submit the original trade request | | Multiple trades in one message | Split into separate requests | ## Prompt Examples by Category ### Trading - `"buy 50u of AXR"` - `"sell 50% of my ETH"` - `"swap 10 SOL to ETH"` ### Automated Strategies - `"DCA 20u into ETH every day"` - `"if 1h RSI < 30, buy 100u BTC"` - `"buy ETH when price drops to 2500"` ### Portfolio & Queries - `"check my balance"` - `"show AXR token info"` - `"what is ETH price now"` - `"show my recent orders"` - `"show my TP/SL orders"` ### Blockchain Assistant - `"analyze AXR token for me"` - `"help me make a Base trading plan"` ## Best Practices ### Security 1. Never share your AK/SK credentials 2. Start with small test amounts 3. Verify token addresses before large trades 4. Review confirmation details carefully before executing ### Trading 1. Check balance before trades 2. Specify amounts clearly (`50u`, `50%`, `0.1 ETH`) 3. Start small, scale up after validation 4. Use limit orders for better entry prices 5. Set TP/SL for risk management ## API Reference For the full API contract, SigV4 signing protocol, request/response format, and response field details, see: **Reference**: [references/api.md](references/api.md) ## Implementation Notes - The script uses AK/SK with SigV4-style signing to call the AIxVC. - Current endpoint: `https://api.aixvc.io/gw/openapi/v2/public/twa/agent/chat` (`chain-id=base`). - If documentation conflicts with code behavior, follow the script implementation. ## File Structure - **SKILL.md** — Agent instructions (this file). The agent reads this to understand how to use the skill. - **README.md** — Human-facing setup and usage guide. - **scripts/axelrod_chat.py** — CLI client. Always invoke with `python skills/axelrod/scripts/axelrod_chat.py --message "<instruction>"`. - **references/api.md** — Full API contract and signing reference. - **requirements.txt** — Python dependencies (`requests`). ## Troubleshooting ### Script Not Working ```bash # Ensure Python 3 is available python --version # Install dependencies pip install -r skills/axelrod/requirements.txt # Test connectivity curl -I https://api.aixvc.io ``` ### API Errors See exit codes and common issues tables above. If an error persists: 1. Check the error message from stderr 2. Use `--json` mode to inspect the full API response 3. Verify AK/SK configuration 4. Test with a simple query first (`"check my balance"`) --- **💡 Pro Tip**: The most common issue is missing or incorrect AK/SK. Always verify credentials first when encountering errors. **⚠️ Security**: Keep your AK/SK private. Never commit credentials to version control. Only trade amounts you can afford to lose. **🚀 Quick Win**: Start by checking your balance to verify setup, then try a small trade like `"buy 1u of ETH"` to get familiar with the flow.