crypto-com-exchange — скилл для Claude Code: функции и запуск
Скилл для торговли на Crypto.com Exchange через утилиту cdcx. Управляет ордерами, запрашивает рыночные данные и баланс без ручного ввода API-ключей.
MIT 224 установок ★ 21 обновлён 2026-08-29
npx skills add crypto-com/crypto-agent-trading --skill crypto-com-exchange -a claude-codeЧто делает crypto-com-exchange
Скилл связывает ассистента с биржей Crypto.com через интерфейс командной строки cdcx. Рыночные котировки и биржевой стакан читаются без авторизации, включая поток NDJSON. Для остальных операций инструмент запускает авторизацию через браузер командой cdcx auth login --oauth, избавляя от ручного копирования ключей.
Через встроенные группы команд агент выставляет лимитные или рыночные ордера, собирает пакетные заявки до 10 штук и настраивает сложные связки вроде OTOCO с фиксацией прибыли и стоп-лоссом. Поддерживается и режим симуляции cdcx paper со сделками на реальных котировках. При изменении активного ордера флаги --new-price и --new-quantity обязательны оба: значение неизменяемого параметра придётся отправлять повторно.
Безопасность разделена на четыре уровня. Для мутирующих команд вроде отправки ордера нужен флаг подтверждения --yes, а для отмены всех заявок или вывода средств требуется уровень --allow-dangerous. Перед выполнением реальной сделки проверку структуры запроса проводят флагом --dry-run.
Какие задачи решает
- Запрашивать биржевые цены, стаканы и свечи без ввода API-ключей
- Выставлять лимитные и рыночные ордера через консольные команды
- Собирать связанные OTO- и OTOCO-заявки со стоп-лоссом и тейк-профитом
- Тестировать торговые алгоритмы в режиме симуляции paper trading
- Контролировать балансы аккаунта и открытые деривативные позиции
Примеры запросов агенту
- Покажи текущий стакан для пары BTC_USDT на глубину 10
- Проверь баланс аккаунта через cdcx account summary
- Создай тестовый лимитный ордер на покупку 0.01 BTC_USDT по цене 50000 с флагом --dry-run
Как установить crypto-com-exchange
1Через Skills CLI (Vercel)
npx skills add crypto-com/crypto-agent-trading --skill crypto-com-exchange -a claude-code2Вручную: положить файлы
~/.claude/skills/crypto-com-exchange/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/crypto-com-exchange/
1Через Skills CLI (Vercel)
npx skills add crypto-com/crypto-agent-trading --skill crypto-com-exchange -a codex2Вручную: положить файлы
.agents/skills/crypto-com-exchange/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add crypto-com/crypto-agent-trading --skill crypto-com-exchange -a cursor2Вручную: положить файлы
.cursor/skills/crypto-com-exchange/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install crypto-com/crypto-agent-trading crypto-com-exchange2Вручную: положить файлы
.github/skills/crypto-com-exchange/SKILL.md1Через Skills CLI (Vercel)
npx skills add crypto-com/crypto-agent-trading --skill crypto-com-exchange -a gemini-cli2Командой платформы
gemini skills install https://github.com/crypto-com/crypto-agent-trading --path crypto-com-exchangeВручную: положить файлы
.devin/skills/crypto-com-exchange/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add crypto-com/crypto-agent-trading --skill crypto-com-exchange -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о crypto-com-exchange
Как установить crypto-com-exchange в Claude Code?
Выполните команду npx skills add crypto-com/crypto-agent-trading --skill crypto-com-exchange -a claude-code. Для работы CLI-команд также требуется пакет npx @cryptocom/cdcx-cli@latest.
Что делает crypto-com-exchange?
Скилл даёт ассистенту набор команд интерфейса cdcx для запроса котировок, проверки балансов, совершения сделок на спотовом и деривативном рынках, а также тестирования стратегий в симуляторе.
Как пройти авторизацию на бирже?
Выполните команду cdcx auth login --oauth. Она откроет браузер для OAuth-подтверждения с тайм-аутом ожидания около 120 секунд, избавляя от ручного ввода секретных ключей.
Исходный текст
SKILL.md · MIT
---
name: crypto-com-exchange
description: Trade on Crypto.com Exchange — market data, spot/derivatives orders, portfolio management, wallet operations. Uses cdcx CLI for execution with built-in auth, safety tiers, and dry-run.
metadata:
version: 2.0.0
author: Crypto.com
openclaw:
requires:
bins: [cdcx]
install:
- kind: node
package: '@cryptocom/cdcx-cli'
bins: [cdcx]
label: Install cdcx CLI (npm)
license: MIT
---
# Crypto.com Exchange Skill
Trade on Crypto.com Exchange using the `cdcx` CLI. Covers spot, derivatives, advanced orders, portfolio, and wallet operations.
## Prerequisites
1. Install: `npx @cryptocom/cdcx-cli@latest` or see [references/install.md](./references/install.md)
2. Authenticate: run `cdcx auth login --oauth` — opens browser for OAuth, no manual key entry needed
3. Verify: `cdcx account summary -o json`
If `cdcx account summary` fails with "No credentials found", immediately execute `cdcx auth login --oauth` via Bash (with ~120s timeout for browser callback).
## Capabilities
| Domain | CLI Group | What It Does |
|--------|-----------|--------------|
| Market Data | `cdcx market` | Prices, orderbook, candles, trades, instruments — no auth needed |
| Order Execution | `cdcx trade` | Place/amend/cancel LIMIT and MARKET orders |
| Advanced Orders | `cdcx advanced` | OCO, OTO, OTOCO bracket orders with trigger logic |
| Portfolio | `cdcx account` | Balances, positions, sub-accounts, P&L |
| History | `cdcx history` | Order history, fills, transactions |
| Wallet | `cdcx wallet` | Deposits, withdrawals, network info |
| Margin | `cdcx margin` | Isolated margin transfers, leverage |
| Staking | `cdcx staking` | Stake/unstake, conversion, reward history |
| Fiat | `cdcx fiat` | Fiat deposit/withdrawal, bank accounts |
| Paper Trading | `cdcx paper` | Local simulation with live prices, no auth |
| Streaming | `cdcx stream` | Real-time WebSocket data (NDJSON) |
## Safety Model
Every command has a safety tier. The CLI enforces these automatically:
| Tier | Behavior | Examples |
|------|----------|----------|
| `read` | Runs freely | `cdcx market ticker`, `cdcx market book` |
| `sensitive_read` | Runs freely (auth required) | `cdcx account summary`, `cdcx trade open-orders` |
| `mutate` | Requires `--yes` or MCP `acknowledged=true` | `cdcx trade order`, `cdcx trade amend` |
| `dangerous` | Requires `--allow-dangerous` on MCP server | `cdcx trade cancel-all`, `cdcx wallet withdraw` |
Always use `--dry-run` before live orders to preview the request.
## Quick Start
### Check Balance
```
cdcx account summary -o json
```
### Get Market Price
```
cdcx market ticker BTC_USDT -o json
```
### Place a Limit Order
```
# Preview first
cdcx trade order BUY BTC_USDT 0.01 --type LIMIT --price 50000 --dry-run -o json
# Execute
cdcx trade order BUY BTC_USDT 0.01 --type LIMIT --price 50000 --client-oid my-buy-001 -o json
```
### Place a Market Order
```
cdcx trade order BUY BTC_USDT 0.01 --type MARKET -o json
```
### Cancel an Order
```
cdcx trade cancel --order-id 123456789 -o json
cdcx trade cancel --client-oid my-buy-001 -o json
```
### Amend an Order
```
cdcx trade amend --order-id 123456789 --new-price 51000 --new-quantity 0.01 -o json
```
Both `--new-price` and `--new-quantity` are required — re-submit the original value for the field you don't want to change.
## Market Data (No Auth)
```
cdcx market ticker BTC_USDT -o json # Current price
cdcx market ticker -o json # All instruments
cdcx market book BTC_USDT --depth 10 -o json # Orderbook
cdcx market candlestick BTC_USDT --timeframe 1h --count 24 -o json # OHLCV
cdcx market trades BTC_USDT -o json # Recent prints
cdcx market instruments -o json # All tradable pairs + tick sizes
```
Supported timeframes: `1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1D, 7D, 14D, 1M`
### Streaming (real-time)
```
cdcx stream ticker BTC_USDT ETH_USDT # NDJSON to stdout
cdcx stream book BTC_USDT
cdcx stream trades BTC_USDT
```
## Order Execution
Positional args: `<side> <instrument> <quantity>`. Side is `BUY` or `SELL`.
```
# Limit order
cdcx trade order BUY BTC_USDT 0.01 --type LIMIT --price 50000 -o json
# Market order (buy by notional)
cdcx trade order BUY BTC_USDT --type MARKET --notional 500 -o json
# Batch (up to 10)
cdcx trade order-list --order-list '[
{"instrument_name":"BTC_USDT","side":"BUY","type":"LIMIT","price":"49000","quantity":"0.01"},
{"instrument_name":"BTC_USDT","side":"BUY","type":"LIMIT","price":"48000","quantity":"0.01"}
]' -o json
# List open orders
cdcx trade open-orders BTC_USDT -o json
# Close a position
cdcx trade close-position BTCUSD-PERP --type MARKET -o json
```
### Order Options
| Flag | Purpose |
|------|---------|
| `--type` | `LIMIT` or `MARKET` |
| `--price` | Limit price (string) |
| `--notional` | Spend amount in quote currency (MARKET BUY) |
| `--client-oid` | Your correlation ID (max 36 chars) |
| `--time-in-force` | `GOOD_TILL_CANCEL`, `FILL_OR_KILL`, `IMMEDIATE_OR_CANCEL` |
| `--exec-inst` | `POST_ONLY`, `SMART_POST_ONLY`, `REDUCE_ONLY`, `ISOLATED_MARGIN` |
| `--dry-run` | Preview without executing |
## Advanced Orders (OCO / OTO / OTOCO)
### OTOCO Bracket (entry + stop-loss + take-profit)
```
cdcx advanced create-otoco '[
{"instrument_name":"BTC_USDT","side":"BUY","type":"LIMIT","price":"50000","quantity":"0.01"},
{"instrument_name":"BTC_USDT","side":"SELL","type":"STOP_LOSS","trigger_price":"48000","quantity":"0.01","ref_price_type":"MARK_PRICE"},
{"instrument_name":"BTC_USDT","side":"SELL","type":"TAKE_PROFIT","trigger_price":"55000","quantity":"0.01","ref_price_type":"MARK_PRICE"}
]' --dry-run -o json
```
### OTO (entry + protection)
```
cdcx advanced create-oto '[
{"instrument_name":"BTC_USDT","side":"BUY","type":"LIMIT","price":"50000","quantity":"0.01"},
{"instrument_name":"BTC_USDT","side":"SELL","type":"STOP_LOSS","trigger_price":"48000","quantity":"0.01","ref_price_type":"MARK_PRICE"}
]' -o json
```
### OCO (two-sided exit for existing position)
```
cdcx advanced oco '[
{"instrument_name":"BTC_USDT","side":"SELL","type":"LIMIT","price":"55000","quantity":"0.01"},
{"instrument_name":"BTC_USDT","side":"SELL","type":"STOP_LOSS","trigger_price":"48000","quantity":"0.01","ref_price_type":"MARK_PRICE"}
]' -o json
```
### Single Trigger Order
```
cdcx advanced order BTCUSD-PERP --side SELL --type STOP_LOSS --quantity 0.01 --trigger-price 48000 --ref-price-type MARK_PRICE -o json
```
### Manage Advanced Orders
```
cdcx advanced open-orders BTC_USDT -o json
cdcx advanced order-detail --order-id <id> -o json
cdcx advanced cancel-otoco --list-id <list_id> -o json
cdcx advanced cancel-oco --list-id <list_id> -o json
cdcx advanced cancel-oto --list-id <list_id> -o json
```
## Portfolio & Account
```
cdcx account summary -o json # Cash balances
cdcx account positions -o json # Open positions + unrealized P&L
cdcx account info -o json # Master + sub-accounts
cdcx account subaccount-balances -o json # Per-sub-account
cdcx account balance-history --timeframe D1 -o json # Equity curve
# Fee rates
cdcx trade fee-rate -o json
cdcx trade instrument-fee-rate --instrument-name BTC_USDT -o json
# History
cdcx history orders BTC_USDT --limit 50 -o json
cdcx history trades BTC_USDT --limit 50 -o json
cdcx history transactions --limit 100 -o json
```
## Wallet Operations
```
# Deposit
cdcx wallet networks -o json # Supported networks
cdcx wallet deposit-address BTC -o json # Get address
cdcx wallet deposit-history -o json # Track arrivals
# Withdraw (dangerous tier)
cdcx wallet withdraw BTC 0.1 <ADDRESS> --network-id BITCOIN --dry-run -o json
cdcx wallet withdraw BTC 0.1 <ADDRESS> --network-id BITCOIN --client-wid my-wd-001 -o json
cdcx wallet withdrawal-history -o json
```
Withdrawals require whitelisted addresses (configured in Exchange web GUI).
## Isolated Margin
For instruments that require isolated margin (e.g. `SPYUSD-PERP`, `NVDAUSD-PERP`):
```
cdcx trade order BUY SPYUSD-PERP 0.001 --type LIMIT --price 710.25 --exec-inst ISOLATED_MARGIN -o json
# Fund/withdraw margin
cdcx margin transfer --direction IN --amount 100 <ISOLATION_ID>
cdcx margin transfer --direction OUT --amount 50 <ISOLATION_ID>
# Adjust leverage
cdcx margin leverage --leverage 5 <ISOLATION_ID>
```
Get `isolation_id` from `cdcx account positions -o json`.
## Paper Trading (No Auth)
```
cdcx paper init --balance 50000
cdcx paper buy BTC_USDT --quantity 0.01 -o json
cdcx paper sell BTC_USDT --quantity 0.01 -o json
cdcx paper positions -o json
cdcx paper balance -o json
cdcx paper history -o json
cdcx paper reset --balance 100000
```
## Recipes
### Morning Brief
```
cdcx market ticker -o json # Market snapshot
cdcx account summary -o json # Cash
cdcx account positions -o json # Open positions
cdcx trade open-orders -o json # Pending orders
cdcx advanced open-orders -o json # Advanced orders
cdcx history trades --start-time $(date -v-1d +%s)000 -o json # Yesterday's fills
```
### Emergency Flatten
**Requires explicit user CONFIRM before execution — this cancels all orders and closes all positions at market.**
```
cdcx trade cancel-all --yes -o json # Cancel all orders
cdcx advanced cancel-all --yes -o json # Cancel all advanced
cdcx account positions -o json | \
jq -r '.data[].instrument_name' | \
while read i; do cdcx trade close-position "$i" --type MARKET --yes; done
cdcx account positions -o json # Verify flat
```
## Important Notes
- Instrument names are case-sensitive: `BTC_USDT` not `btc_usd`. Spot uses `_` (e.g. `BTC_USDT`), perps use `-PERP` (e.g. `BTC-PERP`)
- Prices in the API are strings — cast to float/decimal before arithmetic
- `c` in ticker response is a ratio, not percentage: `0.0257` means +2.57%
- Always supply `--client-oid` for order correlation
- `close-position` is async — verify with `cdcx account positions` afterwards
- Advanced orders live in their own namespace — not visible in `cdcx trade open-orders`
- Batch max is 10 orders per call
- OTOCO structure: Leg 1 = entry LIMIT, Leg 2 = stop-loss trigger, Leg 3 = take-profit trigger
- OTO second leg must be a trigger type (STOP_LOSS, STOP_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT)
- `get-open-orders` has no pagination — returns ALL open orders
- Withdrawal amount is gross (fee deducted from it)
- For memo coins (XRP, XLM, EOS), always include `--address-tag`
## Agent Behavior
1. Always `--dry-run` before live orders on new strategies
2. Confirm with user before any `mutate` tier action in production — ask for "CONFIRM"
3. Never display full API secrets — mask credentials (first 5 + last 4 for key, last 5 only for secret)
4. Default to `--output json` for programmatic consumption
5. Use `cdcx market instruments` to verify tick sizes before placing orders
6. Check `cdcx account summary` for available balance before order placement
7. For streaming data, prefer `cdcx stream` over polling
© Crypto.com · MIT · crypto-com/crypto-agent-trading