MCPInstall

crypto-com-exchange

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.

Installs
215
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/crypto-com/crypto-agent-trading --skill crypto-com-exchange
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads crypto-com-exchange automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

DomainCLI GroupWhat It Does
Market Datacdcx marketPrices, orderbook, candles, trades, instruments — no auth needed
Order Executioncdcx tradePlace/amend/cancel LIMIT and MARKET orders
Advanced Orderscdcx advancedOCO, OTO, OTOCO bracket orders with trigger logic
Portfoliocdcx accountBalances, positions, sub-accounts, P&L
Historycdcx historyOrder history, fills, transactions
Walletcdcx walletDeposits, withdrawals, network info
Margincdcx marginIsolated margin transfers, leverage
Stakingcdcx stakingStake/unstake, conversion, reward history
Fiatcdcx fiatFiat deposit/withdrawal, bank accounts
Paper Tradingcdcx paperLocal simulation with live prices, no auth
Streamingcdcx streamReal-time WebSocket data (NDJSON)

Safety Model

Every command has a safety tier. The CLI enforces these automatically:

TierBehaviorExamples
readRuns freelycdcx market ticker, cdcx market book
sensitive_readRuns freely (auth required)cdcx account summary, cdcx trade open-orders
mutateRequires --yes or MCP acknowledged=truecdcx trade order, cdcx trade amend
dangerousRequires --allow-dangerous on MCP servercdcx 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

FlagPurpose
--typeLIMIT or MARKET
--priceLimit price (string)
--notionalSpend amount in quote currency (MARKET BUY)
--client-oidYour correlation ID (max 36 chars)
--time-in-forceGOOD_TILL_CANCEL, FILL_OR_KILL, IMMEDIATE_OR_CANCEL
--exec-instPOST_ONLY, SMART_POST_ONLY, REDUCE_ONLY, ISOLATED_MARGIN
--dry-runPreview 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

FAQ

What does the crypto-com-exchange skill do?

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.

How do I install crypto-com-exchange?

Run npx skills add https://github.com/crypto-com/crypto-agent-trading --skill crypto-com-exchange in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/crypto-com-exchange/ (personal) or .claude/skills/crypto-com-exchange/ (project).

Which AI agents can use crypto-com-exchange?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is crypto-com-exchange safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains crypto-com-exchange?

It is published by crypto-com in crypto-com/crypto-agent-trading. It has 215 recorded installs.

More from crypto-com/crypto-agent-trading

View all →

crypto-com-app

crypto-com/crypto-agent-trading

Execute crypto trades (buy, sell, swap, exchange), manage cash deposits and withdrawals, and query account balances, market prices, and transaction history via the Crypto.com APP API. View weekly trading limits, portfolio positions, bank accounts, and payment networks. Use when the user wants to trade cryptocurrency, deposit or withdraw cash, check bank account details, view deposit instructions, or manage fiat wallet operations. Supports BTC, ETH, CRO, and 200+ tokens across fiat and crypto wallets.

Business & Finance1.4K installs

crypto-agent-trading

crypto-com/crypto-agent-trading

Open the skill to read its SKILL.md instructions.

Business & Finance337 installs

Popular business & finance skills

View category →

sales-enablement

coreyhaines31/marketingskills

When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts. Also use when the user mentions 'sales deck,' 'pitch deck,' 'one-pager,' 'leave-behind,' 'objection handling,' 'deal-specific ROI analysis,' 'demo script,' 'talk track,' 'sales playbook,' 'proposal template,' 'buyer persona card,' 'battle card,' 'battlecard,' 'competitive one-pager,' 'win-loss analysis,' 'why are we losing deals,' 'loss reasons,' 'how do I respond to this objection,' 'prospect just said,' 'help my sales team,' 'sales materials,' or 'what should I give my sales reps,' 'cold call script,' or 'voicemail script.' Use this for any document or asset that helps a sales team close deals. For public competitor comparison pages, see competitors. For running buyer interviews or churn research, see customer-research. For marketing website copy, see copywriting. For cold outreach emails, see cold-email. For the offer being sold (bonuses, guarantees, pricing structure),

Business & Finance119.5K installs

revops

coreyhaines31/marketingskills

When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes. Also use when the user mentions 'RevOps,' 'revenue operations,' 'lead scoring,' 'outbound pipeline stages,' 'lead routing,' 'MQL,' 'SQL,' 'pipeline stages,' 'deal desk,' 'CRM automation,' 'marketing-to-sales handoff,' 'data hygiene,' 'leads aren't getting to sales,' 'pipeline management,' 'lead qualification,' or 'when should marketing hand off to sales.' Use this for anything involving the systems and processes that connect marketing to revenue. For cold outreach emails, see cold-email. For email drip campaigns, see emails. For pricing decisions, see pricing.

Business & Finance114.1K installs

sales-funnel-blueprint

autonnel/autonnel-skills

Turn an offer into a concrete multi-step sales funnel spec - page-by-page structure, price ladder, copy outline and the metrics each step must hit. Use when asked to build a sales funnel, marketing funnel, landing page flow, lead magnet funnel, webinar funnel, tripwire or VSL funnel, when planning a product launch page flow, or when someone asks "what pages do I need" for selling something online.

Business & Finance104.5K installs

pricing

coreyhaines31/marketingskills

When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' 'monetization,' 'how much should I charge,' 'my pricing is wrong,' 'pricing page,' 'annual vs monthly,' 'per seat pricing,' 'should I offer a free plan,' 'pricing page teardown,' 'pricing page audit,' 'is my pricing page AI-readable,' or 'can AI read my pricing.' Use this whenever someone is figuring out what to charge, how to structure their plans, or wants to audit a pricing page (for humans and for the AI agents that shortlist tools). For in-app upgrade screens, see paywalls. For offer construction (bonuses, guarantees, value framing, naming) on services/courses/coaching/high-ticket B2B, see offers.

Business & Finance80K installs

cross-border-ecommerce

nexscope-ai/ecommerce-skills

Cross-border e-commerce expansion advisor. Scores target markets on 8 weighted dimensions (market size, ecommerce penetration, competition, regulatory complexity, logistics infrastructure, payment ecosystem, cultural distance, IP protection), compares 5 fulfillment models with cost and transit data, provides country-by-country tax/duty compliance guides (EU VAT/IOSS, UK VAT, US sales tax, CA GST, AU GST, JP consumption tax), maps local payment preferences by market, and builds a phased expansion roadmap. No API key required.

Business & Finance62.9K installs

pricing-strategy

coreyhaines31/marketingskills

When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' 'monetization,' 'how much should I charge,' 'my pricing is wrong,' 'pricing page,' 'annual vs monthly,' 'per seat pricing,' or 'should I offer a free plan.' Use this whenever someone is figuring out what to charge or how to structure their plans. For in-app upgrade screens, see paywall-upgrade-cro.

Business & Finance61.2K installs