# Crypto.com Trading API **Canonical:** https://apis.io/apis/crypto-com/crypto-com-trading-api/ **Provider:** Crypto.com — https://apis.io/providers/crypto-com/ **Base URL:** https://api.crypto.com/exchange/v1 **Documentation:** https://exchange-developer.crypto.com/exchange/v1/docs/api/rest-introduction Crypto.com Trading API is one of 14 APIs that [Crypto.com](https://apis.io/providers/crypto-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Trading. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, and a changelog. Private trading endpoints manage order placement and lifecycle. All order operations (create, amend, cancel) are asynchronous — the REST response confirms the request was received, but order lifecycle updates arrive via WebSocket subscriptions. ## Order Management Workflow **Create Order** Call `private/create-order` to submit a new order. The response returns an `order_id` and `client_oid`, but the order may still be pending acceptance by the matching engine. Subscribe to `user.order` or `user.order.{instrument_name}` to receive real-time order status updates. **Amend Order** Call [`private/amend-order`](/docs/api/rest/private-amend-order) to modify price or quantity on an existing order. Behind the scenes, amend performs a cancel-then-create operation. The new order loses queue priority unless you are only reducing quantity. **Cancel Order** Call [`private/cancel-order`](/docs/api/rest/private-cancel-order) to cancel a single order by `order_id` or `client_oid`, or [`private/cancel-all-orders`](/docs/api/rest/private-cancel-all-orders) to cancel all orders for a given instrument. ## Order Types | Type | Description | |------|-------------| | `LIMIT` | Limit order with specified price. Rests on the order book until filled or canceled. | | `MARKET` | Market order that executes immediately at best available price. | For trigger orders (stop-loss, take-profit) and multi-leg strategies (OCO, OTO, OTOCO), see [Advanced Order Management](/docs/api/rest/advanced-order-management). ## Time in Force | Value | Description | |-------|-------------| | `GOOD_TILL_CANCEL` | Order remains active until filled or explicitly canceled. Default for limit orders. | | `IMMEDIATE_OR_CANCEL` | Order fills immediately (partial or full), unfilled portion is canceled. | | `FILL_OR_KILL` | Order must fill entirely and immediately, or the entire order is canceled. | ## Execution Instructions Execution instructions are passed as an array in `exec_inst`. Multiple instructions can be combined. | Instruction | Description | |-------------|-------------| | `POST_ONLY` | Order is rejected if it would take liquidity. Ensures maker fee. | | `SMART_POST_ONLY` | If the order would take liquidity, it is repriced to the best maker level instead of being rejected. | | `REDUCE_ONLY` | Order can only reduce an existing position, not increase or open a new position. | ## Order Statuses | Status | Description | |--------|-------------| | `PENDING` | Order submitted, awaiting processing by the matching engine. | | `NEW` | Order accepted by the matching engine, not yet on the order book. | | `ACTIVE` | Order is live on the order book, waiting to be filled. | | `FILLED` | Order has been completely filled. | | `CANCELED` | Order was canceled (by user request, or by system). | | `EXPIRED` | Order expired due to time-in-force constraints. | | `REJECTED` | Order was rejected (e.g., invalid parameters, risk checks failed). | ## Querying Orders and Trades - [`private/get-open-orders`](/docs/api/rest/private-get-open-orders) — retrieve all currently active orders - [`private/get-order-detail`](/docs/api/rest/private-get-order-detail) — fetch detailed information about a single order - [`private/get-order-history`](/docs/api/rest/private-get-order-history) — retrieve past orders (filled, canceled, or rejected) - [`private/get-trades`](/docs/api/rest/private-get-trades) — retrieve executed trades (fills) ## Real-Time Order and Trade Updates Subscribe to the following WebSocket channels for real-time updates: | Channel | Description | |---------|-------------| | `user.order` | Order lifecycle events across all instruments | | `user.order.{instrument_name}` | Order updates for a specific instrument | | `user.trade` | Trade execution events across all instruments | | `user.trade.{instrument_name}` | Trade execution events for a specific instrument | These subscriptions require authentication and eliminate the need for polling REST endpoints. ## Machine-readable artifacts (12) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/openapi/crypto-com-trading-api-openapi.yml - **Documentation** — https://exchange-developer.crypto.com/exchange/v1/docs/api/rest-introduction - **APIReference** — https://exchange-developer.crypto.com/exchange/v1/docs/api/rest/crypto-com-exchange-api-v-1 - **Authentication** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/authentication/crypto-com-authentication.yml - **Conventions** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/conventions/crypto-com-conventions.yml - **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/errors/crypto-com-error-codes.yml - **RateLimits** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/rate-limits/crypto-com-rate-limits.yml - **Sandbox** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/sandbox/crypto-com-sandbox.yml - **ChangeLog** — https://exchange-developer.crypto.com/exchange/v1/docs/api/rest-change-log - **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/mcp/crypto-com-tool-crosswalk.yml - **DataModel** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/data-model/crypto-com-data-model.yml - **LLMsTxt** — https://exchange-developer.crypto.com/exchange/v1/llms.txt ## Other Crypto.com APIs (12) - [Crypto.com Exchange WebSocket API v1](https://apis.io/apis/crypto-com/cryptocom-exchange-websocket-api-v1/) - [Crypto.com Exchange FIX API](https://apis.io/apis/crypto-com/cryptocom-exchange-fix-api/) - [Crypto.com Pay API](https://apis.io/apis/crypto-com/cryptocom-pay-api/) - [Crypto.com Developer Platform API](https://apis.io/apis/crypto-com/cryptocom-developer-platform-api/) - [Crypto.com Account Balance and Positions API](https://apis.io/apis/crypto-com/crypto-com-account-balance-and-positions-api/) - [Crypto.com Advanced Order Management API](https://apis.io/apis/crypto-com/crypto-com-advanced-order-management-api/) - [Crypto.com Crypto Wallet API](https://apis.io/apis/crypto-com/crypto-com-crypto-wallet-api/) - [Crypto.com Fiat Wallet API](https://apis.io/apis/crypto-com/crypto-com-fiat-wallet-api/) - [Crypto.com OTC RFQ for Taker API](https://apis.io/apis/crypto-com/crypto-com-otc-rfq-for-taker-api/) - [Crypto.com Reference and Market Data API](https://apis.io/apis/crypto-com/crypto-com-reference-and-market-data-api/) - [Crypto.com Staking API](https://apis.io/apis/crypto-com/crypto-com-staking-api/) - [Crypto.com Trading Bot API](https://apis.io/apis/crypto-com/crypto-com-trading-bot-api-api/) ## Tags Trading --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/crypto-com/crypto-com-trading-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/crypto-com/.