# Market Data

Get the exchange rate between any two assets, crypto or fiat, and the details of each asset, by symbol or by ID, from one REST API.

- Rates between any two assets
- Crypto and fiat
- By symbol or by ID

## Key facts

| | |
| --- | --- |
| Endpoints | 5 |
| Blockchains | Any |
| Custody | Non-custodial, you sign |
| Free trial | 14 days, no card |

## Prices for wallets, invoices and reports

**Show values in fiat.** Convert balances and payments to USD, EUR or any listed currency at the current exchange rate.

**Price an invoice.** Quote a crypto amount for a price in fiat at the moment the customer pays.

**Describe an asset.** Read an asset's details, with its latest rate, and list every supported asset to build your own picker.

## Make your first Market Data call

Real paths and example responses from the API reference. Add your API key and run it.

### Rate by symbol

```
curl https://rest.cryptoapis.io/market-data/exchange-rates/by-symbol/FROM_ASSET_SYMBOL/TO_ASSET_SYMBOL \
  -H "X-API-Key: YOUR_API_KEY"
```

### Asset by symbol

```
curl https://rest.cryptoapis.io/market-data/assets/by-symbol/ASSET_SYMBOL \
  -H "X-API-Key: YOUR_API_KEY"
```

### Supported assets

```
curl https://rest.cryptoapis.io/market-data/metadata/assets \
  -H "X-API-Key: YOUR_API_KEY"
```

## Every Market Data endpoint

Each operation links to its page in the API reference, with its parameters and responses. Paths take an asset symbol or ID, not a blockchain.

| What it does | Method and path | Blockchains | Reference |
| --- | --- | --- | --- |
| Get Asset Details By Asset ID | `GET /market-data/assets/by-id/{assetId}` | Any | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/assets/get-asset-details-by-asset-id/get) |
| Get Asset Details By Asset Symbol | `GET /market-data/assets/by-symbol/{assetSymbol}` | Any | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/assets/get-asset-details-by-asset-symbol/get) |
| Get Exchange Rate By Assets IDs | `GET /market-data/exchange-rates/by-id/{fromAssetId}/{toAssetId}` | Any | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/exchange-rates/get-exchange-rate-by-assets-ids/get) |
| Get Exchange Rate By Asset Symbols | `GET /market-data/exchange-rates/by-symbol/{fromAssetSymbol}/{toAssetSymbol}` | Any | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/exchange-rates/get-exchange-rate-by-asset-symbols/get) |
| List Supported Assets | `GET /market-data/metadata/assets` | Any | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/metadata/list-supported-assets/get) |

## Build the rest of the flow

- [Contracts](/products/blockchain-api/contracts) — Token details from a contract address
- [Address Latest](/products/blockchain-api/address-latest) — Balance and recent transactions of any address, no setup
- [Blockchain Fees](/products/blockchain-api/blockchain-fees) — Fee recommendations and gas estimates

## Market Data questions

**Does Market Data depend on a blockchain?** No. Its paths take an asset symbol or ID rather than a blockchain and network, so the same call works for every asset it lists, crypto or fiat.

**Can I try Market Data for free?** Yes, for 14 days. The Blockchain API free trial includes Market Data and every other feature, with no card. It ends after 14 days or when its credits run out; after that, calls need a subscription, listed on the [pricing page](/pricing).

**What data does the Crypto APIs Market Data API return for a cryptocurrency?** It returns current asset details including live price, circulating and max supply, market capitalization, 24-hour trading volume, and token contract addresses across protocols. You can look up an asset by its symbol (e.g. BTC) or by its unique asset ID. Data is sourced from CoinMarketCap.

**Does the Market Data API provide OHLCV candlesticks or order-book data?** No. The Market Data API provides current price and current asset-to-asset exchange rates only. It does not include OHLCV/candlestick history or per-exchange order-book data.

**How do I get the exchange rate between two assets, like BTC to USD?** Use the exchange-rate endpoints, which return the current rate between any two assets. You can request the rate either by asset symbols (for example BTC to USD) or by the two assets' unique asset IDs.

**How many assets does the Crypto APIs Market Data API cover?** The API covers approximately 14,600 crypto and fiat assets, sourced from CoinMarketCap. You can enumerate the full supported list via the list-supported-assets endpoint, which supports pagination and a filter for crypto or fiat asset types.

**Can I look up assets by symbol or do I need an asset ID?** Both are supported. Asset details and exchange rates can be requested either by human-readable symbol (such as BTC or ETH) or by the asset's unique asset ID. Symbol-based lookups are convenient, while asset IDs disambiguate tokens that share a ticker.

## Pointers

- [Blockchain API](/products/blockchain-api)
- [All networks](/what-we-support)
- [Pricing](/pricing)
- [Developer portal](https://developers.cryptoapis.io/)