Axelrod

Execute Base-chain trading and on-chain queries using natural language through the AIxVC AI Automation.

Quick Start

First-Time Setup

1. 1. Configure credentials in OpenClaw config under skills.entries.axelrod.env:

CODEBLOCK0

1. 2. Install dependencies:

CODEBLOCK1

1. 3. Verify setup:

CODEBLOCK2

Core Usage

Simple Query

For straightforward requests that complete quickly:

CODEBLOCK3

JSON Debug Mode

For inspecting the full API response:

CODEBLOCK4

Mandatory Workflow

1. 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 INLINECODE4

Reference: 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:

CODEBLOCK5

If the key has expired, the user must submit the original request again.

Current Limitations

Common Patterns

Check Before Trading

CODEBLOCK6

Automated Strategies

CODEBLOCK7

Portfolio Review

CODEBLOCK8

Error Handling

Exit Codes

Common Issues

Prompt Examples by Category

Trading

• - INLINECODE14
• INLINECODE15
• INLINECODE16

Automated Strategies

• - INLINECODE17
• INLINECODE18
• INLINECODE19

Portfolio & Queries

• - INLINECODE20
• INLINECODE21
• INLINECODE22
• INLINECODE23
• INLINECODE24

Blockchain Assistant

• - INLINECODE25
• INLINECODE26

Best Practices

Security

1. 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. 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

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

CODEBLOCK9

API Errors

See exit codes and common issues tables above. If an error persists:

1. 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")

⚠️ 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.