Endpoints for cryptocurrency exchanges. This category includes 7 endpoints:
- /v1/exchange/map - CoinMarketCap ID Map
- /v1/exchange/info - Metadata
- /v1/exchange/listings/latest - Exchange Listings Latest
- /v1/exchange/quotes/latest - Quotes Latest
- /v1/exchange/quotes/historical - Quotes Historical
- /v1/exchange/market-pairs/latest - Market Pairs Latest
- /v1/exchange/assets - Exchange Assets
Exchange Assets
Returns the exchange assets in the form of token holdings. This information includes details like wallet address, cryptocurrency, blockchain platform, balance, and etc.
- Only wallets containing at least 100,000 USD in balance are shown
- Balances from wallets might be delayed
** Disclaimer: All information and data relating to the holdings in the third-party wallet addresses are provided by the third parties to CoinMarketCap, and CoinMarketCap does not confirm or verify the accuracy or timeliness of such information and data. The information and data are provided "as is" without warranty of any kind. CoinMarketCap shall have no responsibility or liability for these third parties’ information and data or have the duty to review, confirm, verify or otherwise perform any inquiry or investigation as to the completeness, accuracy, sufficiency, integrity, reliability or timeliness of any such information or data provided.
This endpoint is available on the following API plans:
- Free
- Hobbyist
- Startup
- Standard
- Professional
- Enterprise
Cache / Update frequency: Balance data is updated statically based on the source. Price data is updated every 5 minutes.
Plan credit use: 1 credit.
CMC equivalent pages: Exchange detail page like coinmarketcap.com/exchanges/binance/
query Parameters
id^\d*$A CoinMarketCap exchange ID. Example: 270
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Exchange Assets › Responses
Successful
Standardized status object for API calls.
Metadata
Returns all static metadata for one or more exchanges. This information includes details like launch date, logo, official website URL, social links, and market fee documentation URL.
This endpoint is available on the following API plans:
- Basic
- Hobbyist
- Startup
- Standard
- Professional
- Enterprise
Cache / Update frequency: Static data is updated only as needed, every 30 seconds.
Plan credit use: 1 call credit per 100 exchanges returned (rounded up).
CMC equivalent pages: Exchange detail page metadata like coinmarketcap.com/exchanges/binance/.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated CoinMarketCap cryptocurrency exchange ids. Example: "1,2"
slug^[0-9a-z-]+(?:,[0-9a…Alternatively, one or more comma-separated exchange names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens). Example: "binance,gdax". At least one "id" or "slug" is required.
aux^(urls|logo|descript…Optionally specify a comma-separated list of supplemental data fields to return. Pass urls,logo,description,date_launched,notice,status to include all auxiliary fields.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Metadata › Responses
Successful
Results of your query returned as an object map.
Standardized status object for API calls.
CoinMarketCap ID Map
Returns a paginated list of all active cryptocurrency exchanges by CoinMarketCap ID. We recommend using this convenience endpoint to lookup and utilize our unique exchange id across all endpoints as typical exchange identifiers may change over time. As a convenience you may pass a comma-separated list of exchanges by slug to filter this list to only those you require or the aux parameter to slim down the payload.
By default this endpoint returns exchanges that have at least 1 actively tracked market. You may receive a map of all inactive cryptocurrencies by passing listing_status=inactive. You may also receive a map of registered exchanges that are listed but do not yet meet methodology requirements to have tracked markets available via listing_status=untracked. Please review (3) Listing Tiers in our methodology documentation for additional details on listing states.
This endpoint is available on the following API plans:
- Basic
- Hobbyist
- Startup
- Standard
- Professional
- Enterprise
Cache / Update frequency: Mapping data is updated only as needed, every 30 seconds.
Plan credit use: 1 call credit per call.
CMC equivalent pages: No equivalent, this data is only available via API.
query Parameters
listing_status^(active|inactive|un…Only active exchanges are returned by default. Pass inactive to get a list of exchanges that are no longer active. Pass untracked to get a list of exchanges that are registered but do not currently meet methodology requirements to have active markets tracked. You may pass one or more comma-separated values.
slug^[0-9a-z-]+(?:,[0-9a…Optionally pass a comma-separated list of exchange slugs (lowercase URL friendly shorthand name with spaces replaced with dashes) to return CoinMarketCap IDs for. If this option is passed, other options will be ignored.
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
sortWhat field to sort the list of exchanges by.
aux^(first_historical_d…Optionally specify a comma-separated list of supplemental data fields to return. Pass first_historical_data,last_historical_data,is_active,status to include all auxiliary fields.
crypto_id^\d*$Optionally include one fiat or cryptocurrency IDs to filter market pairs by. For example ?crypto_id=1 would only return exchanges that have BTC.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
CoinMarketCap ID Map › Responses
Successful
Array of exchange object results.
Standardized status object for API calls.
Exchange Listings Latest
Returns a paginated list of all cryptocurrency exchanges including the latest aggregate market data for each exchange. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.
This endpoint is available on the following API plans:
BasicHobbyistStartup- Standard
- Professional
- Enterprise
Cache / Update frequency: Every 1 minute.
Plan credit use: 1 call credit per 100 exchanges returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our latest exchange listing and ranking pages like coinmarketcap.com/rankings/exchanges/.
NOTE: Use this endpoint if you need a sorted and paginated list of exchanges. If you want to query for market data on a few specific exchanges use /v1/exchange/quotes/latest which is optimized for that purpose. The response data between these endpoints is otherwise the same.
“exchange_score" will be deprecated on 4 November 2024.
After this date, the "exchange_score" field return null from these endpoints. We encourage users to review and update their implementations accordingly to avoid any disruptions.
query Parameters
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
sortWhat field to sort the list of exchanges by.
sort_dirThe direction in which to order exchanges against the specified sort.
market_typeThe type of exchange markets to include in rankings. This field is deprecated. Please use "all" for accurate sorting.
categoryThe category for this exchange.
aux^(num_market_pairs|t…Optionally specify a comma-separated list of supplemental data fields to return. Pass num_market_pairs,traffic_score,rank,exchange_score,effective_liquidity_24h,date_launched,fiats to include all auxiliary fields.
convert^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Exchange Listings Latest › Responses
Successful
Array of exchange objects matching the list options.
Standardized status object for API calls.
Market Pairs Latest
Returns all active market pairs that CoinMarketCap tracks for a given exchange. The latest price and volume information is returned for each market. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.'
This endpoint is available on the following API plans:
BasicHobbyistStartup- Standard
- Professional
- Enterprise
Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 100 market pairs returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our exchange level active markets pages like coinmarketcap.com/exchanges/binance/.
query Parameters
id^\d*$A CoinMarketCap exchange ID. Example: "1"
slug^[0-9a-z-]*$Alternatively pass an exchange "slug" (URL friendly all lowercase shorthand version of name with spaces replaced with hyphens). Example: "binance". One "id" or "slug" is required.
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
aux^(num_market_pairs|c…Optionally specify a comma-separated list of supplemental data fields to return. Pass num_market_pairs,category,fee_type,market_url,currency_name,currency_slug,price_quote,effective_liquidity,market_score,market_reputation to include all auxiliary fields.
matched_id^\d+(?:,\d+)*$Optionally include one or more comma-delimited fiat or cryptocurrency IDs to filter market pairs by. For example ?matched_id=2781 would only return BTC markets that matched: "BTC/USD" or "USD/BTC" for the requested exchange. This parameter cannot be used when matched_symbol is used.
matched_symbol^[0-9A-Za-z$@\-,]+(?…Optionally include one or more comma-delimited fiat or cryptocurrency symbols to filter market pairs by. For example ?matched_symbol=USD would only return BTC markets that matched: "BTC/USD" or "USD/BTC" for the requested exchange. This parameter cannot be used when matched_id is used.
categoryThe category of trading this market falls under. Spot markets are the most common but options include derivatives and OTC.
fee_typeThe fee type the exchange enforces for this market.
convert^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Market Pairs Latest › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Quotes Historical
Returns an interval of historic quotes for any exchange based on time and interval parameters.
Technical Notes
- A historic quote for every "interval" period between your "time_start" and "time_end" will be returned.
- If a "time_start" is not supplied, the "interval" will be applied in reverse from "time_end".
- If "time_end" is not supplied, it defaults to the current time.
- At each "interval" period, the historic quote that is closest in time to the requested time will be returned.
- If no historic quotes are available in a given "interval" period up until the next interval period, it will be skipped.
- This endpoint supports requesting multiple exchanges in the same call. Please note the API response will be wrapped in an additional object in this case.
Interval Options
There are 2 types of time interval formats that may be used for "interval".
The first are calendar year and time constants in UTC time:
"hourly" - Get the first quote available at the beginning of each calendar hour.
"daily" - Get the first quote available at the beginning of each calendar day.
"weekly" - Get the first quote available at the beginning of each calendar week.
"monthly" - Get the first quote available at the beginning of each calendar month.
"yearly" - Get the first quote available at the beginning of each calendar year.
The second are relative time intervals.
"m": Get the first quote available every "m" minutes (60 second intervals). Supported minutes are: "5m", "10m", "15m", "30m", "45m".
"h": Get the first quote available every "h" hours (3600 second intervals). Supported hour intervals are: "1h", "2h", "3h", "4h", "6h", "12h".
"d": Get the first quote available every "d" days (86400 second intervals). Supported day intervals are: "1d", "2d", "3d", "7d", "14d", "15d", "30d", "60d", "90d", "365d".
This endpoint is available on the following API plans:
Basic- Hobbyist (1 month)
- Startup (1 month)
- Standard (3 month)
- Professional (Up to 12 months)
- Enterprise (Up to 6 years)
Note: You may use the /exchange/map endpoint to receive a list of earliest historical dates that may be fetched for each exchange as first_historical_data. This timestamp will either be the date CoinMarketCap first started tracking the exchange or 2018-04-26T00:45:00.000Z, the earliest date this type of historical data is available for.
Cache / Update frequency: Every 5 minutes.
Plan credit use: 1 call credit per 100 historical data points returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: No equivalent, this data is only available via API outside of our volume sparkline charts in coinmarketcap.com/rankings/exchanges/.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated exchange CoinMarketCap ids. Example: "24,270"
slug^[0-9a-z-]+(?:,[0-9a…Alternatively, one or more comma-separated exchange names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens). Example: "binance,kraken". At least one "id" or "slug" is required.
time_startTimestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time_end".
time_endTimestamp (Unix or ISO 8601) to stop returning quotes for (inclusive). Optional, if not passed, we'll default to the current time. If no "time_start" is passed, we return quotes in reverse order starting from this time.
countThe number of interval periods to return results for. Optional, required if both "time_start" and "time_end" aren't supplied. The default is 10 items. The current query limit is 10000.
intervalInterval of time to return data points for. See details in endpoint description.
convert^[0-9A-Za-z$@\-,]+(?…By default market quotes are returned in USD. Optionally calculate market quotes in up to 3 other fiat currencies or cryptocurrencies.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Quotes Historical › Responses
Successful
Results of your query returned as an object map.
Standardized status object for API calls.
Quotes Latest
Returns the latest aggregate market data for 1 or more exchanges. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.
This endpoint is available on the following API plans:
BasicHobbyistStartup- Standard
- Professional
- Enterprise
Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 100 exchanges returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Latest market data summary for specific exchanges like coinmarketcap.com/rankings/exchanges/.
NOTE: “exchange_score" will be deprecated on 4 November 2024.
After this date, the "exchange_score" field return null from these endpoints. We encourage users to review and update their implementations accordingly to avoid any disruptions.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated CoinMarketCap exchange IDs. Example: "1,2"
slug^[0-9a-z-]+(?:,[0-9a…Alternatively, pass a comma-separated list of exchange "slugs" (URL friendly all lowercase shorthand version of name with spaces replaced with hyphens). Example: "binance,gdax". At least one "id" or "slug" is required.
convert^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
aux^(num_market_pairs|t…Optionally specify a comma-separated list of supplemental data fields to return. Pass num_market_pairs,traffic_score,rank,exchange_score,liquidity_score,effective_liquidity_24h to include all auxiliary fields.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Quotes Latest › Responses
Successful
A map of exchange objects by ID or slugs (as used in query parameters).
Standardized status object for API calls.