crypto-com-exchange

Crypto.com Exchange スキル

cdcx CLI を使用して Crypto.com Exchange で取引します。現物、デリバティブ、高度な注文、ポートフォリオ、ウォレットの操作に対応しています。

前提条件

1. インストール：npx @cryptocom/cdcx-cli@latest または references/install.md を参照してください
2. 認証：cdcx auth login --oauth を実行します — OAuth のためブラウザーが開き、手動でキーを入力する必要はありません
3. 確認：cdcx account summary -o json

cdcx account summary が "No credentials found" で失敗した場合は、直ちに Bash から cdcx auth login --oauth を実行してください（ブラウザーのコールバックを待つため、タイムアウトは約120秒に設定します）。

機能

分野	CLI グループ	機能
マーケットデータ	cdcx market	価格、オーダーブック、ローソク足、取引、金融商品 — 認証不要
注文執行	cdcx trade	LIMIT および MARKET 注文の発注・変更・キャンセル
高度な注文	cdcx advanced	トリガーロジック付きの OCO、OTO、OTOCO ブラケット注文
ポートフォリオ	cdcx account	残高、ポジション、サブアカウント、損益
履歴	cdcx history	注文履歴、約定、取引
ウォレット	cdcx wallet	入金、出金、ネットワーク情報
マージン	cdcx margin	分離マージンの移動、レバレッジ
ステーキング	cdcx staking	ステーキング・解除、交換、報酬履歴
法定通貨	cdcx fiat	法定通貨の入金・出金、銀行口座
ペーパートレーディング	cdcx paper	ライブ価格を使用したローカルシミュレーション、認証不要
ストリーミング	cdcx stream	リアルタイムの WebSocket データ（NDJSON）

安全モデル

すべてのコマンドには安全性の段階があり、CLI が自動的に適用します。

段階	動作	例
read	そのまま実行	cdcx market ticker、cdcx market book
sensitive_read	そのまま実行（認証が必要）	cdcx account summary、cdcx trade open-orders
mutate	--yes または MCP の acknowledged=true が必要	cdcx trade order、cdcx trade amend
dangerous	MCP サーバーで --allow-dangerous が必要	cdcx trade cancel-all、cdcx wallet withdraw

実際の注文を出す前に、必ず --dry-run を使用してリクエストを確認してください。

クイックスタート

残高を確認する

cdcx account summary -o json

マーケット価格を取得する

cdcx market ticker BTC_USDT -o json

指値注文を出す

# 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

成行注文を出す

cdcx trade order BUY BTC_USDT 0.01 --type MARKET -o json

注文をキャンセルする

cdcx trade cancel --order-id 123456789 -o json
cdcx trade cancel --client-oid my-buy-001 -o json

注文を変更する

cdcx trade amend --order-id 123456789 --new-price 51000 --new-quantity 0.01 -o json

--new-price と --new-quantity の両方が必要です。変更しないフィールドには、元の値を再指定してください。

マーケットデータ（認証不要）

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

対応する時間足：1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1D, 7D, 14D, 1M

ストリーミング（リアルタイム）

cdcx stream ticker BTC_USDT ETH_USDT   # NDJSON to stdout
cdcx stream book BTC_USDT
cdcx stream trades BTC_USDT

注文執行

位置引数：<side> <instrument> <quantity>。Side は BUY または 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

注文オプション

フラグ	用途
--type	LIMIT または MARKET
--price	指値価格（文字列）
--notional	クオート通貨での支出額（MARKET BUY）
--client-oid	相関 ID（最大36文字）
--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	実行せずにプレビュー

高度な注文（OCO／OTO／OTOCO）

OTOCO ブラケット（エントリー＋ストップロス＋テイクプロフィット）

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（エントリー＋保護）

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（既存ポジションの両側決済）

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

単一トリガー注文

cdcx advanced order BTCUSD-PERP --side SELL --type STOP_LOSS --quantity 0.01 --trigger-price 48000 --ref-price-type MARK_PRICE -o json

高度な注文を管理する

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

ポートフォリオとアカウント

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

ウォレット操作

# 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

出金には、ホワイトリストに登録されたアドレスが必要です（Exchange の Web GUI で設定します）。

分離マージン

分離マージンが必要な金融商品（例：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>

cdcx account positions -o json から isolation_id を取得します。

ペーパートレーディング（認証不要）

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

レシピ

朝の概要

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

緊急ポジション解消

実行前に、ユーザーによる明示的な CONFIRM が必要です。すべての注文をキャンセルし、すべてのポジションを成行で決済します。

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

重要な注意事項

• 銘柄名は大文字と小文字を区別します。BTC_USDT を使用し、btc_usd は使用しないでください。現物には _（例：BTC_USDT）、無期限先物には -PERP（例：BTC-PERP）を使用します。
• API の価格は文字列です。計算する前に float または decimal にキャストしてください。
• ティッカーのレスポンスにある c は比率であり、パーセンテージではありません。0.0257 は +2.57% を意味します。
• 注文を照合できるよう、必ず --client-oid を指定してください。
• close-position は非同期です。実行後に cdcx account positions で確認してください。
• 高度な注文は専用の名前空間にあり、cdcx trade open-orders には表示されません。
• 1 回の呼び出しで指定できる注文は最大 10 件です。
• OTOCO の構成：Leg 1 = エントリー LIMIT、Leg 2 = 損切りトリガー、Leg 3 = 利益確定トリガー
• OTO の第 2 レッグには、トリガータイプ（STOP_LOSS、STOP_LIMIT、TAKE_PROFIT、TAKE_PROFIT_LIMIT）を指定する必要があります。
• get-open-orders にはページネーションがありません。すべての未約定注文が返されます。
• 出金額は総額です（手数料はこの額から差し引かれます）。
• メモが必要な銘柄（XRP、XLM、EOS）では、必ず --address-tag を含めてください。

エージェントの動作

1. 新しい戦略で実注文を行う前に、必ず --dry-run を実行してください。
2. 本番環境で mutate ティアの操作を行う前に、必ずユーザーに確認してください。「CONFIRM」と入力するよう依頼してください。
3. API シークレット全体を表示しないでください。認証情報はマスクしてください（キーは先頭 5 文字と末尾 4 文字、シークレットは末尾 5 文字のみ表示）。
4. プログラムでの利用では、デフォルトで --output json を使用してください。
5. 注文を出す前に、cdcx market instruments を使用してティックサイズを確認してください。
6. 注文を出す前に、cdcx account summary で利用可能残高を確認してください。
7. ストリーミングデータには、ポーリングより cdcx stream を優先してください。