Axelrod

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

• 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

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:

yes, please execute <confirmKey>
no, please cancel <confirmKey>

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

Current Limitations

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

Common Issues

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

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

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