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:

{
  "skills": {
    "entries": {
      "axelrod": {
        "enabled": true,
        "env": {
          "AIXVC_ACCESS_KEY": "your_access_key",
          "AIXVC_SECRET_KEY": "your_secret_key"
        }
      }
    }
  }
}

2. Install dependencies:

pip install -r skills/axelrod/requirements.txt

3. Verify setup:

python skills/axelrod/scripts/axelrod_chat.py --message "check my balance"

Core Usage

Simple Query

For straightforward requests that complete quickly:

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:

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

Reference: references/api.md

Query Operations

Blockchain Assistant

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:

yes, please execute 
no, please cancel 

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

# 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

# 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

# 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

Automated Strategies

Portfolio & Queries

Blockchain Assistant

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

Implementation Notes

File Structure

Troubleshooting

Script Not Working

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

First-Time Setup

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

{
  "skills": {
    "entries": {
      "axelrod": {
        "enabled": true,
        "env": {
          "AIXVC_ACCESS_KEY": "your_access_key",
          "AIXVC_SECRET_KEY": "your_secret_key"
        }
      }
    }
  }
}

2. Install dependencies:

pip install -r skills/axelrod/requirements.txt

3. Verify setup:

python skills/axelrod/scripts/axelrod_chat.py --message "check my balance"

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