# Crypto.com Reference and Market Data API

**Canonical:** https://apis.io/apis/crypto-com/crypto-com-reference-and-market-data-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 Reference and Market Data 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 Reference and Market Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, and a changelog.

Reference and market data endpoints provide public, unauthenticated access to instrument metadata, real-time market data, and historical pricing information. These endpoints form the foundation for price discovery, order book analysis, and trading decision workflows. ## Core Data Types ### Instrument Reference Data Use [`public/get-instruments`](/docs/api/rest/public-get-instruments) to retrieve the full catalog of tradable instruments. Each instrument includes: - Contract specifications (tick size, quantity decimals, leverage limits) - Product classification (perpetual swap, future, option) - Trading status and expiry information - Underlying index reference This endpoint should be called on application startup and periodically refreshed to detect new listings or contract expirations. ### Real-Time Market Data | Endpoint | Use Case | Update Frequency | |----------|----------|------------------| | [`public/get-book`](/docs/api/rest/public-get-book) | Order book depth (bids/asks) | Snapshot on request (up to 50 levels) | | [`public/get-tickers`](/docs/api/rest/public-get-tickers) | 24h summary (high, low, volume, open interest) | Updated per trade | | [`public/get-trades`](/docs/api/rest/public-get-trades) | Recent trade history | Last 150 trades (7-day max window) | For low-latency applications, use WebSocket subscriptions instead: - `book.{instrument_name}.{depth}` - Order book updates (10 or 50 levels) - `ticker.{instrument_name}` - Real-time ticker updates - `trade.{instrument_name}` - Trade feed ### Settlement and Expiry [`public/get-expired-settlement-price`](/docs/api/rest/public-get-expired-settlement-price) provides historical settlement prices for expired futures contracts. Use this for post-trade reconciliation and historical PnL calculations. ## Rate Limits Public endpoints share a global rate limit pool. For market data-intensive applications: - Use WebSocket subscriptions instead of polling REST endpoints - Cache `public/get-instruments` responses (updates infrequently) - Batch ticker requests by omitting `instrument_name` to get all tickers in one call ## Typical Integration Flow **Step 1 — Bootstrap Reference Data** Call `public/get-instruments` to load the instrument catalog. Store contract specifications locally. **Step 2 — Subscribe to Market Data** For real-time pricing, establish WebSocket connections and subscribe to: - `book.{instrument_name}.10` - top 10 order book levels - `ticker.{instrument_name}` - 24h summary stats - `trade.{instrument_name}` - trade feed **Step 3 — Polling Fallback** If WebSocket connections are unavailable, poll `public/get-tickers` and `public/get-book` at reasonable intervals (e.g., 1-5 seconds).

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/crypto-com/refs/heads/main/openapi/crypto-com-reference-and-market-data-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 Staking API](https://apis.io/apis/crypto-com/crypto-com-staking-api/)
- [Crypto.com Trading API](https://apis.io/apis/crypto-com/crypto-com-trading-api/)
- [Crypto.com Trading Bot API](https://apis.io/apis/crypto-com/crypto-com-trading-bot-api-api/)

## Tags

Reference and Market Data

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/crypto-com/crypto-com-reference-and-market-data-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/crypto-com/.