crypto-agent-trading

An agent skill for trading cryptocurrency via the Crypto.com API. Works with any SKILL.md-compatible agent platform (OpenClaw, Cursor, Claude Code, and others).

Features

• Trade: Market buy, sell, swap, and exchange across 200+ tokens (BTC, ETH, CRO, and more)
• Balances: Query fiat and crypto portfolio holdings
• Prices: Discover coins and check market prices
• History: View recent transaction history
• Trading Limits: Check weekly trading budget usage
• Kill Switch: Emergency API key revocation

Quickstart

1. Set environment variables

First, generate an API key following the API Key Management guide. Then export the key and secret in your terminal:

export CDC_API_KEY="your-api-key"
export CDC_API_SECRET="your-api-secret"

2. Install the skill

npx skills add crypto-com/crypto-agent-trading -g -y

Or manually copy the skill folder to your agent platform's skill directory:

Platform	Install location	Activation
OpenClaw	~/.openclaw/skills/crypto-agent-trading/	Say "Initialize the crypto-agent-trading skill"
Cursor	~/.cursor/skills/crypto-agent-trading/	Add as an agent skill in settings
Claude Code	~/.claude/skills/crypto-agent-trading/	Point Claude at the SKILL.md path
Other agents	Any local directory	Point your agent at SKILL.md

The skill uses relative script paths (./scripts/... from the skill root), so it works from any install location without path modifications.

Example Conversation

User: "Buy CRO with 100 USD"
Agent: (runs quote) "Confirm: buy 1,250 CRO for 100 USD? This quote expires in 15 seconds."
User: "Yes"
Agent: (runs confirm) "Done! Purchased 1,250 CRO for 100 USD."

User: "What's my balance?"
Agent: (runs balance check) "You hold 1,250 CRO ($105.00) and 400.00 USD."

User: "Swap 500 CRO to BTC"
Agent: (runs quote) "Confirm: swap 500 CRO for 0.00045 BTC? Expires in 15 seconds."
User: "No, make it 200 CRO instead"
Agent: (runs new quote) "Confirm: swap 200 CRO for 0.00018 BTC? Expires in 15 seconds."
User: "Confirm"
Agent: (runs confirm) "Done! Swapped 200 CRO for 0.00018 BTC."

File Structure

crypto-agent-trading/
├── _meta.json          # OpenClaw package metadata
├── SKILL.md            # Core skill: configs, commands, business logic
├── README.md           # This file
├── CHANGELOG.md        # Version history
├── references/
│   └── errors.md       # Detailed error scenarios + recovery
└── scripts/
    ├── lib/
    │   ├── api.ts      # HTTP client, HMAC signing
    │   └── output.ts   # Structured output + error codes
    ├── account.ts      # Balances, trading limit, kill switch
    ├── trade.ts        # Quotations, orders, history
    └── coins.ts        # Coin discovery

Prerequisites

• Node.js 18+ (for npx tsx and built-in fetch)
• A Crypto.com account with API key and secret

Security

• No withdrawal permissions -- the API key can only trade; it cannot withdraw funds from your account
• Weekly trading limit -- a configurable cap on total trading volume acts as a financial guardrail against runaway spending
• HMAC-SHA256 signing -- all requests are signed to prevent tampering and replay attacks
• Environment-only credentials -- API keys are read from environment variables only and never stored in files
• Kill switch -- instantly revoke API access in emergencies to stop all further trading

FAQ & Resources

• OpenClaw Integration with Agent Key
• OpenClaw Trading Overview
• Getting Started
• API Key Management
• Trading with OpenClaw
• Weekly Trading Limit
• Safety and Security
• Notifications

License

Apache License 2.0