crypto-com-exchange

What this skill does

# Crypto.com Exchange Spot Skill

Spot request on Crypto.com Exchange using authenticated API endpoints. Requires API key and secret key for private endpoints. Return the result in JSON format.

## Quick Reference

| Endpoint | Method | Description | Required | Optional | Authentication |
|----------|--------|-------------|----------|----------|----------------|
| `public/get-instruments` (GET) | GET | List all supported instruments | None | None | No |
| `public/get-book` (GET) | GET | Order book for an instrument | instrument_name, depth | None | No |
| `public/get-candlestick` (GET) | GET | Candlestick/OHLCV data | instrument_name | timeframe, count, start_ts, end_ts | No |
| `public/get-trades` (GET) | GET | Recent public trades | instrument_name | count, start_ts, end_ts | No |
| `public/get-tickers` (GET) | GET | Ticker information | None | instrument_name | No |
| `public/get-valuations` (GET) | GET | Valuation data (index/mark price) | instrument_name, valuation_type | count, start_ts, end_ts | No |
| `public/get-expired-settlement-price` (GET) | GET | Expired settlement prices | instrument_type | page (must be ≥1) | No |
| `public/get-insurance` (GET) | GET | Insurance fund balance | instrument_name | count, start_ts, end_ts | No |
| `public/get-announcements` (GET) | GET | Exchange announcements (base: `https://api.crypto.com/v1/`) | None | category, product_type | No |
| `public/get-risk-parameters` (GET) | GET | Risk parameters for margin | None | None | No |
| `private/create-order` (POST) | POST | Place a new order | instrument_name, side, type | price, quantity, notional, client_oid, exec_inst, time_in_force, spot_margin, stp_scope, stp_inst, stp_id, fee_instrument_name, isolation_id, leverage, isolated_margin_amount | Yes |
| `private/create-order-list` (POST) | POST | Batch order creation (1-10, LIST only) | contingency_type, order_list | Per-order params | Yes |
| `private/amend-order` (POST) | POST | Modify an existing order | new_price, new_quantity | order_id, orig_client_oid, client_oid | Yes |
| `private/cancel-order` (POST) | POST | Cancel a single order | order_id or client_oid | None | Yes |
| `private/cancel-order-list` (POST) | POST | Batch cancel orders | contingency_type, order_list | None | Yes |
| `private/cancel-all-orders` (POST) | POST | Cancel all orders | None | instrument_name, type | Yes |
| `private/close-position` (POST) | POST | Close an open position | instrument_name, type | price, quantity, isolation_id | Yes |
| `private/get-open-orders` (POST) | POST | List ALL active open orders | None | instrument_name | Yes |
| `private/get-order-detail` (POST) | POST | Query specific order | order_id or client_oid | None | Yes |
| `private/get-order-history` (POST) | POST | Historical orders | None | instrument_name, start_time, end_time, limit, isolation_id | Yes |
| `private/get-trades` (POST) | POST | Account trade list | None | instrument_name, start_time, end_time, limit, isolation_id | Yes |
| `private/get-transactions` (POST) | POST | Transaction journal (trading, settlement, funding) | None | instrument_name, journal_type, start_time, end_time, limit, isolation_id | Yes |
| `private/user-balance` (POST) | POST | Current wallet balances | None | None | Yes |
| `private/user-balance-history` (POST) | POST | Historical balance snapshots | None | timeframe, end_time, limit | Yes |
| `private/get-accounts` (POST) | POST | Master/sub-account info | None | page_size, page | Yes |
| `private/get-subaccount-balances` (POST) | POST | All sub-account balances | None | None | Yes |
| `private/get-positions` (POST) | POST | Active positions | None | instrument_name | Yes |
| `private/create-subaccount-transfer` (POST) | POST | Transfer between accounts | from, to, currency, amount | None | Yes |
| `private/get-fee-rate` (POST) | POST | Trading fee structure | None | None | Yes |
| `private/get-instrument-fee-rate` (POST) | POST | Fee rate by instrument | instrument_name | None | Yes |
| `private/change-account-leverage` (POST) | POST | Adjust account leverage | account_id, leverage | None | Yes |
| `private/change-account-settings` (POST) | POST | Update account settings | None | stp_scope, stp_inst, stp_id, leverage | Yes |
| `private/get-account-settings` (POST) | POST | Retrieve account config | None | None | Yes |
| `private/create-withdrawal` (POST) | POST | Create a withdrawal | currency, amount, address | client_wid, address_tag, network_id | Yes |
| `private/get-deposit-address` (POST) | POST | Get deposit address | currency | None | Yes |
| `private/get-currency-networks` (POST) | POST | Get currency network info | None | None | Yes |
| `private/get-deposit-history` (POST) | POST | Get deposit history | None | currency, start_ts, end_ts, page_size, page, status | Yes |
| `private/get-withdrawal-history` (POST) | POST | Get withdrawal history | None | currency, start_ts, end_ts, page_size, page, status | Yes |
| `private/advanced/create-order` (POST) | POST | Create trigger/stop/TP order | instrument_name, side, type, quantity | price, ref_price, client_oid, time_in_force, exec_inst, stp_scope, stp_inst, stp_id, fee_instrument_name | Yes |
| `private/advanced/create-oco` (POST) | POST | Create OCO order (2 orders) | order_list (2 orders) | Per-order params | Yes |
| `private/advanced/cancel-oco` (POST) | POST | Cancel OCO order | list_id | None | Yes |
| `private/advanced/create-oto` (POST) | POST | Create OTO order (2 orders) | order_list (2 orders) | Per-order params | Yes |
| `private/advanced/cancel-oto` (POST) | POST | Cancel OTO order | list_id | None | Yes |
| `private/advanced/create-otoco` (POST) | POST | Create OTOCO order (3 orders) | order_list (3 orders) | Per-order params | Yes |
| `private/advanced/cancel-otoco` (POST) | POST | Cancel OTOCO order | list_id | None | Yes |
| `private/advanced/cancel-order` (POST) | POST | Cancel individual OTO/OTOCO leg | order_id or client_oid | None | Yes |
| `private/advanced/cancel-all-orders` (POST) | POST | Cancel all advanced orders | None | instrument_name, type | Yes |
| `private/advanced/get-open-orders` (POST) | POST | List open advanced orders | None | instrument_name | Yes |
| `private/advanced/get-order-detail` (POST) | POST | Query advanced order detail | order_id or client_oid | None | Yes |
| `private/advanced/get-order-history` (POST) | POST | Advanced order history | None | instrument_name, start_time, end_time, limit | Yes |

---

## Parameters

### Common Parameters

* **instrument_name**: Instrument name. Spot pairs use underscore format (e.g., `BTC_USD`, `ETH_USDT`, `CRO_USD`). **Case-sensitive** — `btc_usd` will not work
* **side**: Order side — `BUY` or `SELL`
* **type**: Order type — `LIMIT` or `MARKET`
* **quantity**: Order quantity (string, e.g., `"0.01"`)
* **notional**: Order value in quote currency (for MARKET BUY orders, use instead of quantity)
* **price**: Limit price (string, required for LIMIT orders, e.g., `"50000.00"`)
* **client_oid**: Optional client-assigned order ID (max 36 characters)
* **time_in_force**: Order duration policy
* **exec_inst**: Execution instructions (array)
* **stp_scope**: Self-trade prevention scope
* **stp_inst**: Self-trade prevention instruction
* **stp_id**: Self-trade prevention ID (0 to 32767)
* **fee_instrument_name**: Instrument to use for fee payment
* **spot_margin**: `SPOT` (default) or `MARGIN`
* **isolation_id**: Isolated margin position ID
* **leverage**: Leverage multiplier
* **isolated_margin_amount**: Amount for isolated margin
* **depth**: Order book depth. Must be ≥1 (e.g., 10, 50, 150). No hard upper limit — returns available levels
* **timeframe**: Candlestick interval
* **count**: Number of results to return. Max: 300 for candlestick, 150 for public trades. Min: 1 (0 → error 40004)
* **start_ts**: Start timestamp in Unix ms (used for public endpoints and wallet history)
* **end_ts**: End timestamp in Unix ms (used for public endpoints and wallet history)
* **start_time**: Start time