{"id":46843947,"url":"https://github.com/crypto-com/crypto-agent-trading","last_synced_at":"2026-03-10T14:13:18.405Z","repository":{"id":341510887,"uuid":"1168167519","full_name":"crypto-com/crypto-agent-trading","owner":"crypto-com","description":"Agent skill for trading crypto via the Crypto.com API. Buy, sell, swap, and query balances","archived":false,"fork":false,"pushed_at":"2026-03-02T06:27:15.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-02T09:20:22.828Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crypto-com.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-27T04:44:00.000Z","updated_at":"2026-03-02T06:27:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/crypto-com/crypto-agent-trading","commit_stats":null,"previous_names":["crypto-com/crypto-agent-trading"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/crypto-com/crypto-agent-trading","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crypto-com%2Fcrypto-agent-trading","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crypto-com%2Fcrypto-agent-trading/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crypto-com%2Fcrypto-agent-trading/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crypto-com%2Fcrypto-agent-trading/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crypto-com","download_url":"https://codeload.github.com/crypto-com/crypto-agent-trading/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crypto-com%2Fcrypto-agent-trading/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30336305,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T12:41:07.687Z","status":"ssl_error","status_checked_at":"2026-03-10T12:41:06.728Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-10T14:13:17.796Z","updated_at":"2026-03-10T14:13:18.394Z","avatar_url":"https://github.com/crypto-com.png","language":"TypeScript","funding_links":[],"categories":["Trading \u0026 DeFi"],"sub_categories":[],"readme":"# crypto-agent-trading\n\nAn agent skill for trading cryptocurrency via the Crypto.com API. Works with any SKILL.md-compatible agent platform (OpenClaw, Cursor, Claude Code, and others).\n\n## Features\n\n- **Trade**: Market buy, sell, swap, and exchange across 200+ tokens (BTC, ETH, CRO, and more)\n- **Balances**: Query fiat and crypto portfolio holdings\n- **Prices**: Discover coins and check market prices\n- **History**: View recent transaction history\n- **Trading Limits**: Check weekly trading budget usage\n- **Kill Switch**: Emergency API key revocation\n\n## Quickstart\n\n### 1. Set environment variables\n\nFirst, generate an API key following the [API Key Management](https://help.crypto.com/en/articles/13843786-api-key-management) guide. Then export the key and secret in your terminal:\n\n```bash\nexport CDC_API_KEY=\"your-api-key\"\nexport CDC_API_SECRET=\"your-api-secret\"\n```\n\n### 2. Install the skill\n\n```bash\nnpx skills add crypto-com/crypto-agent-trading -g -y\n```\n\nOr manually copy the skill folder to your agent platform's skill directory:\n\n| Platform | Install location | Activation |\n|----------|-----------------|------------|\n| **OpenClaw** | `~/.openclaw/skills/crypto-agent-trading/` | Say \"Initialize the crypto-agent-trading skill\" |\n| **Cursor** | `~/.cursor/skills/crypto-agent-trading/` | Add as an agent skill in settings |\n| **Claude Code** | `~/.claude/skills/crypto-agent-trading/` | Point Claude at the `SKILL.md` path |\n| **Other agents** | Any local directory | Point your agent at `SKILL.md` |\n\nThe skill uses **relative script paths** (`./scripts/...` from the skill root), so it works from any install location without path modifications.\n\n## Example Conversation\n\n```\nUser: \"Buy CRO with 100 USD\"\nAgent: (runs quote) \"Confirm: buy 1,250 CRO for 100 USD? This quote expires in 15 seconds.\"\nUser: \"Yes\"\nAgent: (runs confirm) \"Done! Purchased 1,250 CRO for 100 USD.\"\n```\n\n```\nUser: \"What's my balance?\"\nAgent: (runs balance check) \"You hold 1,250 CRO ($105.00) and 400.00 USD.\"\n```\n\n```\nUser: \"Swap 500 CRO to BTC\"\nAgent: (runs quote) \"Confirm: swap 500 CRO for 0.00045 BTC? Expires in 15 seconds.\"\nUser: \"No, make it 200 CRO instead\"\nAgent: (runs new quote) \"Confirm: swap 200 CRO for 0.00018 BTC? Expires in 15 seconds.\"\nUser: \"Confirm\"\nAgent: (runs confirm) \"Done! Swapped 200 CRO for 0.00018 BTC.\"\n```\n\n## File Structure\n\n```\ncrypto-agent-trading/\n├── _meta.json          # OpenClaw package metadata\n├── SKILL.md            # Core skill: configs, commands, business logic\n├── README.md           # This file\n├── CHANGELOG.md        # Version history\n├── references/\n│   └── errors.md       # Detailed error scenarios + recovery\n└── scripts/\n    ├── lib/\n    │   ├── api.ts      # HTTP client, HMAC signing\n    │   └── output.ts   # Structured output + error codes\n    ├── account.ts      # Balances, trading limit, kill switch\n    ├── trade.ts        # Quotations, orders, history\n    └── coins.ts        # Coin discovery\n```\n\n## Prerequisites\n\n- Node.js 18+ (for `npx tsx` and built-in `fetch`)\n- A Crypto.com account with API key and secret\n\n## Security\n\n- **No withdrawal permissions** -- the API key can only trade; it cannot withdraw funds from your account\n- **Weekly trading limit** -- a configurable cap on total trading volume acts as a financial guardrail against runaway spending\n- **HMAC-SHA256 signing** -- all requests are signed to prevent tampering and replay attacks\n- **Environment-only credentials** -- API keys are read from environment variables only and never stored in files\n- **Kill switch** -- instantly revoke API access in emergencies to stop all further trading\n\n## FAQ \u0026 Resources\n\n- [OpenClaw Integration with Agent Key](https://help.crypto.com/en/collections/18662855-openclaw-integration-with-agent-key)\n- [OpenClaw Trading Overview](https://help.crypto.com/en/articles/13843765-openclaw-trading-overview)\n- [Getting Started](https://help.crypto.com/en/articles/13843782-getting-started)\n- [API Key Management](https://help.crypto.com/en/articles/13843786-api-key-management)\n- [Trading with OpenClaw](https://help.crypto.com/en/articles/13843788-trading-with-openclaw)\n- [Weekly Trading Limit](https://help.crypto.com/en/articles/13843797-weekly-trading-limit)\n- [Safety and Security](https://help.crypto.com/en/articles/13843804-safety-and-security)\n- [Notifications](https://help.crypto.com/en/articles/13843811-notifications)\n\n## License\n\nApache License 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrypto-com%2Fcrypto-agent-trading","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrypto-com%2Fcrypto-agent-trading","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrypto-com%2Fcrypto-agent-trading/lists"}