# Table of Contents - [CoinMarketCap API Documentation](#coinmarketcap-api-documentation) - [CoinMarketCap API Documentation](#coinmarketcap-api-documentation) - [The World's Number 1 Cryptocurrency Market Data API](#the-world-s-number-1-cryptocurrency-market-data-api) - [Frequently Asked Questions for Crypto Market API](#frequently-asked-questions-for-crypto-market-api) - [CoinMarketCap API Pricing Plans](#coinmarketcap-api-pricing-plans) - [Unknown](#unknown) --- # CoinMarketCap API Documentation * Introduction * Quick Start Guide * Authentication * Endpoint Overview * Standards and Conventions * Errors and Rate Limits * Best Practices * Version History * cryptocurrency * get Airdrop * get Airdrops * get Categories * get Category * get CoinMarketCap ID Map * get Metadata v2 * get Listings Historical * get Listings Latest * get Listings New * get Trending Gainers & Losers * get Trending Latest * get Trending Most Visited * get Market Pairs Latest v2 * get OHLCV Historical v2 * get OHLCV Latest v2 * get Price Performance Stats v2 * get Quotes Historical v2 * get Quotes Latest v2 * get Quotes Historical v3 * DexScan * get Quotes Latest * get Pairs Listings Latest * exchange * get Exchange Assets * get Metadata * get CoinMarketCap ID Map * get Listings Latest * get Market Pairs Latest * get Quotes Historical * get Quotes Latest * global-metrics * get Quotes Historical * get Quotes Latest * CMC20 Index * get CoinMarketCap 20 Index Historical * get CoinMarketCap 20 Index Latest * CMC100 Index * get CoinMarketCap 100 Index Historical * get CoinMarketCap 100 Index Latest * fear-and-greed * get CMC Crypto Fear and Greed Historical * get CMC Crypto Fear and Greed Latest * fiat * get CoinMarketCap ID Map * tools * get Postman Conversion v1 * get Price Conversion v2 * blockchain * get Statistics Latest * content * community * key * get Key Info * deprecated * get Metadata v1 (deprecated) * get Price Conversion v1 (deprecated) * get Market Pairs Latest v1 (deprecated) * get OHLCV Historical v1 (deprecated) * get OHLCV Latest v1 (deprecated) * get Price Performance Stats v1 (deprecated) * get Quotes Historical v1 (deprecated) * get Quotes Latest v1 (deprecated) * get FCAS Listings Latest (deprecated) * get FCAS Quotes Latest (deprecated) * get DEX Metadata (deprecated) * get DEX Listings Latest (deprecated) * get DEX CoinMarketCap ID Map (deprecated) * get DEX OHLCV Historical (deprecated) * get DEX OHLCV Latest (deprecated) * get DEX Trades Latest (deprecated) * get Content Latest * get Community Trending Tokens * get Community Trending Topics * get Content Post Comments * get Content Latest Posts * get Content Top Posts CoinMarketCap Cryptocurrency API Documentation (v2.0.4) ======================================================= Contact: [api@coinmarketcap.com](mailto:api@coinmarketcap.com) [](https://coinmarketcap.com/api/documentation/v1/#section/Introduction) Introduction ===================================================================================== The CoinMarketCap API is a suite of high-performance RESTful JSON endpoints that are specifically designed to meet the mission-critical demands of application developers, data scientists, and enterprise business platforms. This API reference includes all technical documentation developers need to integrate third-party applications and platforms. Additional answers to common questions can be found in the [CoinMarketCap API FAQ](https://coinmarketcap.com/api/faq) . [](https://coinmarketcap.com/api/documentation/v1/#section/Quick-Start-Guide) Quick Start Guide =============================================================================================== For developers eager to hit the ground running with the CoinMarketCap API here are a few quick steps to make your first call with the API. 1. **Sign up for a free Developer Portal account.** You can sign up at [pro.coinmarketcap.com](https://pro.coinmarketcap.com/) - This is our live production environment with the latest market data. Select the free `Basic` plan if it meets your needs or upgrade to a paid tier. 2. **Copy your API Key.** Once you sign up you'll land on your Developer Portal account dashboard. Copy your API from the `API Key` box in the top left panel. 3. **Make a test call using your key.** You may use the code examples provided below to make a test call with your programming language of choice. This example [fetches all active cryptocurrencies by market cap and return market values in USD](https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest?start=1&limit=5000&convert=USD) . _Be sure to replace the API Key in sample code with your own and use API domain `pro-api.coinmarketcap.com` or use the test API Key `b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c` for `sandbox-api.coinmarketcap.com` testing with our sandbox environment. Please note that our sandbox api has mock data and should not be used in your application._ 4. **Postman Collection** To help with development, we provide a fully featured postman collection that you can import and use immediately! [Read more here](https://coinmarketcap.com/alexandria/article/register-for-coinmarketcap-api) . 5. **Implement your application.** Now that you've confirmed your API Key is working, get familiar with the API by reading the rest of this API Reference and commence building your application! _**Note:** Making HTTP requests on the client side with Javascript is currently prohibited through CORS configuration. This is to protect your API Key which should not be visible to users of your application so your API Key is not stolen. Secure your API Key by routing calls through your own backend service._ **View Quick Start Code Examples** cURL command line curl -H "X-CMC_PRO_API_KEY: b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c" -H "Accept: application/json" -d "start=1&limit=5000&convert=USD" -G https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest Node.js /* Example in Node.js */ const axios = require('axios'); let response = null; new Promise(async (resolve, reject) => { try { response = await axios.get('https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest', { headers: { 'X-CMC_PRO_API_KEY': 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c', }, }); } catch(ex) { response = null; // error console.log(ex); reject(ex); } if (response) { // success const json = response.data; console.log(json); resolve(json); } }); Python #This example uses Python 2.7 and the python-request library. from requests import Request, Session from requests.exceptions import ConnectionError, Timeout, TooManyRedirects import json url = 'https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest' parameters = { 'start':'1', 'limit':'5000', 'convert':'USD' } headers = { 'Accepts': 'application/json', 'X-CMC_PRO_API_KEY': 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c', } session = Session() session.headers.update(headers) try: response = session.get(url, params=parameters) data = json.loads(response.text) print(data) except (ConnectionError, Timeout, TooManyRedirects) as e: print(e) PHP /** * Requires curl enabled in php.ini **/ '1',\ 'limit' => '5000',\ 'convert' => 'USD'\ ]; $headers = [\ 'Accepts: application/json',\ 'X-CMC_PRO_API_KEY: b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c'\ ]; $qs = http_build_query($parameters); // query string encode the parameters $request = "{$url}?{$qs}"; // create the request URL $curl = curl_init(); // Get cURL resource // Set cURL options curl_setopt_array($curl, array( CURLOPT_URL => $request, // set the request URL CURLOPT_HTTPHEADER => $headers, // set the headers CURLOPT_RETURNTRANSFER => 1 // ask for raw response instead of bool )); $response = curl_exec($curl); // Send the request, save the response print_r(json_decode($response)); // print json decoded response curl_close($curl); // Close request ?> Java /** * This example uses the Apache HTTPComponents library. */ import org.apache.http.HttpEntity; import org.apache.http.HttpHeaders; import org.apache.http.NameValuePair; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpGet; import org.apache.http.client.utils.URIBuilder; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.message.BasicNameValuePair; import org.apache.http.util.EntityUtils; import java.io.IOException; import java.net.URISyntaxException; import java.util.ArrayList; import java.util.List; public class JavaExample { private static String apiKey = "b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c"; public static void main(String[] args) { String uri = "https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest"; List paratmers = new ArrayList(); paratmers.add(new BasicNameValuePair("start","1")); paratmers.add(new BasicNameValuePair("limit","5000")); paratmers.add(new BasicNameValuePair("convert","USD")); try { String result = makeAPICall(uri, paratmers); System.out.println(result); } catch (IOException e) { System.out.println("Error: cannont access content - " + e.toString()); } catch (URISyntaxException e) { System.out.println("Error: Invalid URL " + e.toString()); } } public static String makeAPICall(String uri, List parameters) throws URISyntaxException, IOException { String response_content = ""; URIBuilder query = new URIBuilder(uri); query.addParameters(parameters); CloseableHttpClient client = HttpClients.createDefault(); HttpGet request = new HttpGet(query.build()); request.setHeader(HttpHeaders.ACCEPT, "application/json"); request.addHeader("X-CMC_PRO_API_KEY", apiKey); CloseableHttpResponse response = client.execute(request); try { System.out.println(response.getStatusLine()); HttpEntity entity = response.getEntity(); response_content = EntityUtils.toString(entity); EntityUtils.consume(entity); } finally { response.close(); } return response_content; } } C# using System; using System.Net; using System.Web; class CSharpExample { private static string API_KEY = "b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c"; public static void Main(string[] args) { try { Console.WriteLine(makeAPICall()); } catch (WebException e) { Console.WriteLine(e.Message); } } static string makeAPICall() { var URL = new UriBuilder("https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest"); var queryString = HttpUtility.ParseQueryString(string.Empty); queryString["start"] = "1"; queryString["limit"] = "5000"; queryString["convert"] = "USD"; URL.Query = queryString.ToString(); var client = new WebClient(); client.Headers.Add("X-CMC_PRO_API_KEY", API_KEY); client.Headers.Add("Accepts", "application/json"); return client.DownloadString(URL.ToString()); } } Go package main import ( "fmt" "io/ioutil" "log" "net/http" "net/url" "os" ) func main() { client := &http.Client{} req, err := http.NewRequest("GET","https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest", nil) if err != nil { log.Print(err) os.Exit(1) } q := url.Values{} q.Add("start", "1") q.Add("limit", "5000") q.Add("convert", "USD") req.Header.Set("Accepts", "application/json") req.Header.Add("X-CMC_PRO_API_KEY", "b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c") req.URL.RawQuery = q.Encode() resp, err := client.Do(req); if err != nil { fmt.Println("Error sending request to server") os.Exit(1) } fmt.Println(resp.Status); respBody, _ := ioutil.ReadAll(resp.Body) fmt.Println(string(respBody)); } [](https://coinmarketcap.com/api/documentation/v1/#section/Authentication) Authentication ========================================================================================= ### Acquiring an API Key All HTTP requests made against the CoinMarketCap API must be validated with an API Key. If you don't have an API Key yet visit the [API Developer Portal](https://coinmarketcap.com/api/) to register for one. ### Using Your API Key You may use any _server side_ programming language that can make HTTP requests to target the CoinMarketCap API. All requests should target domain `https://pro-api.coinmarketcap.com`. You can supply your API Key in REST API calls in one of two ways: 1. Preferred method: Via a custom header named `X-CMC_PRO_API_KEY` 2. Convenience method: Via a query string parameter named `CMC_PRO_API_KEY` _**Security Warning:** It's important to secure your API Key against public access. The custom header option is strongly recommended over the querystring option for passing your API Key in a production environment._ ### API Key Usage Credits Most API plans include a daily and monthly limit or "hard cap" to the number of data calls that can be made. This usage is tracked as API "call credits" which are incremented 1:1 against successful (HTTP Status 200) data calls made with your key with these exceptions: * Account management endpoints, usage stats endpoints, and error responses are not included in this limit. * **Paginated endpoints:** List-based endpoints track an additional call credit for every 100 data points returned (rounded up) beyond our 100 data point defaults. Our lightweight `/map` endpoints are not included in this limit and always count as 1 credit. See individual endpoint documentation for more details. * **Bundled API calls:** Many endpoints support [resource and currency conversion bundling](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Bundled resources are also tracked as 1 call credit for every 100 resources returned (rounded up). Optional currency conversion bundling using the `convert` parameter also increment an additional API call credit for every conversion requested beyond the first. You can log in to the [Developer Portal](https://coinmarketcap.com/api/) to view live stats on your API Key usage and limits including the number of credits used for each call. You can also find call credit usage in the JSON response for each API call. See the [`status` object](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) for details. You may also use the [/key/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1KeyInfo) endpoint to quickly review your usage and when daily/monthly credits reset directly from the API. _**Note:** "day" and "month" credit usage periods are defined relative to your API subscription. For example, if your monthly subscription started on the 5th at 5:30am, this billing anchor is also when your monthly credits refresh each month. The free Basic tier resets each day at UTC midnight and each calendar month at UTC midnight._ [](https://coinmarketcap.com/api/documentation/v1/#section/Endpoint-Overview) Endpoint Overview =============================================================================================== ### The CoinMarketCap API is divided into 8 top-level categories | Endpoint Category | Description | | --- | --- | | [/cryptocurrency/\*](https://coinmarketcap.com/api/documentation/v1/#tag/cryptocurrency) | Endpoints that return data around cryptocurrencies such as ordered cryptocurrency lists or price and volume data. | | [/exchange/\*](https://coinmarketcap.com/api/documentation/v1/#tag/exchange) | Endpoints that return data around cryptocurrency exchanges such as ordered exchange lists and market pair data. | | [/global-metrics/\*](https://coinmarketcap.com/api/documentation/v1/#tag/global-metrics) | Endpoints that return aggregate market data such as global market cap and BTC dominance. | | [/tools/\*](https://coinmarketcap.com/api/documentation/v1/#tag/tools) | Useful utilities such as cryptocurrency and fiat price conversions. | | [/blockchain/\*](https://coinmarketcap.com/api/documentation/v1/#tag/blockchain) | Endpoints that return block explorer related data for blockchains. | | [/fiat/\*](https://coinmarketcap.com/api/documentation/v1/#tag/fiat) | Endpoints that return data around fiats currencies including mapping to CMC IDs. | | [/partners/\*](https://coinmarketcap.com/api/documentation/v1/#tag/partners) | Endpoints for convenient access to 3rd party crypto data. | | [/key/\*](https://coinmarketcap.com/api/documentation/v1/#tag/key) | API key administration endpoints to review and manage your usage. | | [/content/\*](https://coinmarketcap.com/api/documentation/v1/#tag/content) | Endpoints that return cryptocurrency-related news, headlines, articles, posts, and comments. | ### Endpoint paths follow a pattern matching the type of data provided | Endpoint Path | Endpoint Type | Description | | --- | --- | --- | | \*/latest | Latest Market Data | Latest market ticker quotes and averages for cryptocurrencies and exchanges. | | \*/historical | Historical Market Data | Intervals of historic market data like OHLCV data or data for use in charting libraries. | | \*/info | Metadata | Cryptocurrency and exchange metadata like block explorer URLs and logos. | | \*/map | ID Maps | Utility endpoints to get a map of resources to CoinMarketCap IDs. | ### Cryptocurrency and exchange endpoints provide 2 different ways of accessing data depending on purpose * **Listing endpoints:** Flexible paginated `*/listings/*` endpoints allow you to sort and filter lists of data like cryptocurrencies by market cap or exchanges by volume. * **Item endpoints:** Convenient ID-based resource endpoints like `*/quotes/*` and `*/market-pairs/*` allow you to bundle several IDs; for example, this allows you to get latest market quotes for a specific set of cryptocurrencies in one call. [](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) Standards and Conventions =============================================================================================================== Each HTTP request must contain the header `Accept: application/json`. You should also send an `Accept-Encoding: deflate, gzip` header to receive data fast and efficiently. ### Endpoint Response Payload Format All endpoints return data in JSON format with the results of your query under `data` if the call is successful. A `Status` object is always included for both successful calls and failures when possible. The `Status` object always includes the current time on the server when the call was executed as `timestamp`, the number of API call credits this call utilized as `credit_count`, and the number of milliseconds it took to process the request as `elapsed`. Any details about errors encountered can be found under the `error_code` and `error_message`. See [Errors and Rate Limits](https://coinmarketcap.com/api/documentation/v1/#section/Errors-and-Rate-Limits) for details on errors. { "data" : { ... }, "status": { "timestamp": "2018-06-06T07:52:27.273Z", "error_code": 400, "error_message": "Invalid value for \"id\"", "elapsed": 0, "credit_count": 0 } } ### Cryptocurrency, Exchange, and Fiat currency identifiers * Cryptocurrencies may be identified in endpoints using either the cryptocurrency's unique CoinMarketCap ID as `id` (eg. `id=1` for Bitcoin) or the cryptocurrency's symbol (eg. `symbol=BTC` for Bitcoin). For a current list of supported cryptocurrencies use our [`/cryptocurrency/map` call](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) . * Exchanges may be identified in endpoints using either the exchange's unique CoinMarketCap ID as `id` (eg. `id=270` for Binance) or the exchange's web slug (eg. `slug=binance` for Binance). For a current list of supported exchanges use our [`/exchange/map` call](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) . * All fiat currency options use the standard [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) currency code (eg. `USD` for the US Dollar). For a current list of supported fiat currencies use our [`/fiat/map`](https://coinmarketcap.com/api/documentation/v1/#operation/getV1FiatMap) endpoint. Unless otherwise stated, endpoints with fiat currency options like our `convert` parameter support these 93 major currency codes: | Currency | Currency Code | CoinMarketCap ID | | --- | --- | --- | | United States Dollar ($) | USD | 2781 | | Albanian Lek (L) | ALL | 3526 | | Algerian Dinar (د.ج) | DZD | 3537 | | Argentine Peso ($) | ARS | 2821 | | Armenian Dram (֏) | AMD | 3527 | | Australian Dollar ($) | AUD | 2782 | | Azerbaijani Manat (₼) | AZN | 3528 | | Bahraini Dinar (.د.ب) | BHD | 3531 | | Bangladeshi Taka (৳) | BDT | 3530 | | Belarusian Ruble (Br) | BYN | 3533 | | Bermudan Dollar ($) | BMD | 3532 | | Bolivian Boliviano (Bs.) | BOB | 2832 | | Bosnia-Herzegovina Convertible Mark (KM) | BAM | 3529 | | Brazilian Real (R$) | BRL | 2783 | | Bulgarian Lev (лв) | BGN | 2814 | | Cambodian Riel (៛) | KHR | 3549 | | Canadian Dollar ($) | CAD | 2784 | | Chilean Peso ($) | CLP | 2786 | | Chinese Yuan (¥) | CNY | 2787 | | Colombian Peso ($) | COP | 2820 | | Costa Rican Colón (₡) | CRC | 3534 | | Croatian Kuna (kn) | HRK | 2815 | | Cuban Peso ($) | CUP | 3535 | | Czech Koruna (Kč) | CZK | 2788 | | Danish Krone (kr) | DKK | 2789 | | Dominican Peso ($) | DOP | 3536 | | Egyptian Pound (£) | EGP | 3538 | | Euro (€) | EUR | 2790 | | Georgian Lari (₾) | GEL | 3539 | | Ghanaian Cedi (₵) | GHS | 3540 | | Guatemalan Quetzal (Q) | GTQ | 3541 | | Honduran Lempira (L) | HNL | 3542 | | Hong Kong Dollar ($) | HKD | 2792 | | Hungarian Forint (Ft) | HUF | 2793 | | Icelandic Króna (kr) | ISK | 2818 | | Indian Rupee (₹) | INR | 2796 | | Indonesian Rupiah (Rp) | IDR | 2794 | | Iranian Rial (﷼) | IRR | 3544 | | Iraqi Dinar (ع.د) | IQD | 3543 | | Israeli New Shekel (₪) | ILS | 2795 | | Jamaican Dollar ($) | JMD | 3545 | | Japanese Yen (¥) | JPY | 2797 | | Jordanian Dinar (د.ا) | JOD | 3546 | | Kazakhstani Tenge (₸) | KZT | 3551 | | Kenyan Shilling (Sh) | KES | 3547 | | Kuwaiti Dinar (د.ك) | KWD | 3550 | | Kyrgystani Som (с) | KGS | 3548 | | Lebanese Pound (ل.ل) | LBP | 3552 | | Macedonian Denar (ден) | MKD | 3556 | | Malaysian Ringgit (RM) | MYR | 2800 | | Mauritian Rupee (₨) | MUR | 2816 | | Mexican Peso ($) | MXN | 2799 | | Moldovan Leu (L) | MDL | 3555 | | Mongolian Tugrik (₮) | MNT | 3558 | | Moroccan Dirham (د.م.) | MAD | 3554 | | Myanma Kyat (Ks) | MMK | 3557 | | Namibian Dollar ($) | NAD | 3559 | | Nepalese Rupee (₨) | NPR | 3561 | | New Taiwan Dollar (NT$) | TWD | 2811 | | New Zealand Dollar ($) | NZD | 2802 | | Nicaraguan Córdoba (C$) | NIO | 3560 | | Nigerian Naira (₦) | NGN | 2819 | | Norwegian Krone (kr) | NOK | 2801 | | Omani Rial (ر.ع.) | OMR | 3562 | | Pakistani Rupee (₨) | PKR | 2804 | | Panamanian Balboa (B/.) | PAB | 3563 | | Peruvian Sol (S/.) | PEN | 2822 | | Philippine Peso (₱) | PHP | 2803 | | Polish Złoty (zł) | PLN | 2805 | | Pound Sterling (£) | GBP | 2791 | | Qatari Rial (ر.ق) | QAR | 3564 | | Romanian Leu (lei) | RON | 2817 | | Russian Ruble (₽) | RUB | 2806 | | Saudi Riyal (ر.س) | SAR | 3566 | | Serbian Dinar (дин.) | RSD | 3565 | | Singapore Dollar (S$) | SGD | 2808 | | South African Rand (R) | ZAR | 2812 | | South Korean Won (₩) | KRW | 2798 | | South Sudanese Pound (£) | SSP | 3567 | | Sovereign Bolivar (Bs.) | VES | 3573 | | Sri Lankan Rupee (Rs) | LKR | 3553 | | Swedish Krona ( kr) | SEK | 2807 | | Swiss Franc (Fr) | CHF | 2785 | | Thai Baht (฿) | THB | 2809 | | Trinidad and Tobago Dollar ($) | TTD | 3569 | | Tunisian Dinar (د.ت) | TND | 3568 | | Turkish Lira (₺) | TRY | 2810 | | Ugandan Shilling (Sh) | UGX | 3570 | | Ukrainian Hryvnia (₴) | UAH | 2824 | | United Arab Emirates Dirham (د.إ) | AED | 2813 | | Uruguayan Peso ($) | UYU | 3571 | | Uzbekistan Som (so'm) | UZS | 3572 | | Vietnamese Dong (₫) | VND | 2823 | Along with these four precious metals: | Precious Metal | Currency Code | CoinMarketCap ID | | --- | --- | --- | | Gold Troy Ounce | XAU | 3575 | | Silver Troy Ounce | XAG | 3574 | | Platinum Ounce | XPT | 3577 | | Palladium Ounce | XPD | 3576 | _**Warning:** **Using CoinMarketCap IDs is always recommended as not all cryptocurrency symbols are unique. They can also change with a cryptocurrency rebrand.** If a symbol is used the API will always default to the cryptocurrency with the highest market cap if there are multiple matches. Our `convert` parameter also defaults to fiat if a cryptocurrency symbol also matches a supported fiat currency. You may use the convenient `/map` endpoints to quickly find the corresponding CoinMarketCap ID for a cryptocurrency or exchange._ ### Bundling API Calls * Many endpoints support ID and crypto/fiat currency conversion bundling. This means you can pass multiple comma-separated values to an endpoint to query or convert several items at once. Check the `id`, `symbol`, `slug`, and `convert` query parameter descriptions in the endpoint documentation to see if this is supported for an endpoint. * Endpoints that support bundling return data as an object map instead of an array. Each key-value pair will use the identifier you passed in as the key. For example, if you passed `symbol=BTC,ETH` to `/v1/cryptocurrency/quotes/latest` you would receive: "data" : { "BTC" : { ... }, "ETH" : { ... } } Or if you passed `id=1,1027` you would receive: "data" : { "1" : { ... }, "1027" : { ... } } Price conversions that are returned inside endpoint responses behave in the same fashion. These are enclosed in a `quote` object. ### Date and Time Formats * All endpoints that require date/time parameters allow timestamps to be passed in either [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (eg. `2018-06-06T01:46:40Z`) or in Unix time (eg. `1528249600`). Timestamps that are passed in ISO 8601 format support basic and extended notations; if a timezone is not included, UTC will be the default. * All timestamps returned in JSON payloads are returned in UTC time using human-readable ISO 8601 format which follows this pattern: `yyyy-mm-ddThh:mm:ss.mmmZ`. The final `.mmm` designates milliseconds. Per the ISO 8601 spec the final `Z` is a constant that represents UTC time. * Data is collected, recorded, and reported in UTC time unless otherwise specified. ### Versioning The CoinMarketCap API is versioned to guarantee new features and updates are non-breaking. The latest version of this API is `/v1/`. [](https://coinmarketcap.com/api/documentation/v1/#section/Errors-and-Rate-Limits) Errors and Rate Limits ========================================================================================================= ### API Request Throttling Use of the CoinMarketCap API is subject to API call rate limiting or "request throttling". This is the number of HTTP calls that can be made simultaneously or within the same minute with your API Key before receiving an HTTP 429 "Too Many Requests" throttling error. This limit scales with the [usage tier](https://pro.coinmarketcap.com/features) and resets every 60 seconds. Please review our [Best Practices](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) for implementation strategies that work well with rate limiting. ### HTTP Status Codes The API uses standard HTTP status codes to indicate the success or failure of an API call. * `400 (Bad Request)` The server could not process the request, likely due to an invalid argument. * `401 (Unauthorized)` Your request lacks valid authentication credentials, likely an issue with your API Key. * `402 (Payment Required)` Your API request was rejected due to it being a paid subscription plan with an overdue balance. Pay the balance in the [Developer Portal billing tab](https://pro.coinmarketcap.com/account/plan) and it will be enabled. * `403 (Forbidden)` Your request was rejected due to a permission issue, likely a restriction on the API Key's associated service plan. Here is a [convenient map](https://coinmarketcap.com/api/features) of service plans to endpoints. * `429 (Too Many Requests)` The API Key's rate limit was exceeded; consider slowing down your API Request frequency if this is an HTTP request throttling error. Consider upgrading your service plan if you have reached your monthly API call credit limit for the day/month. * `500 (Internal Server Error)` An unexpected server issue was encountered. ### Error Response Codes A `Status` object is always included in the JSON response payload for both successful calls and failures when possible. During error scenarios you may reference the `error_code` and `error_message` properties of the Status object. One of the API error codes below will be returned if applicable otherwise the HTTP status code for the general error type is returned. | HTTP Status | Error Code | Error Message | | --- | --- | --- | | 401 | 1001 \[API\_KEY\_INVALID\] | This API Key is invalid. | | 401 | 1002 \[API\_KEY\_MISSING\] | API key missing. | | 402 | 1003 \[API\_KEY\_PLAN\_REQUIRES\_PAYEMENT\] | Your API Key must be activated. Please go to pro.coinmarketcap.com/account/plan. | | 402 | 1004 \[API\_KEY\_PLAN\_PAYMENT\_EXPIRED\] | Your API Key's subscription plan has expired. | | 403 | 1005 \[API\_KEY\_REQUIRED\] | An API Key is required for this call. | | 403 | 1006 \[API\_KEY\_PLAN\_NOT\_AUTHORIZED\] | Your API Key subscription plan doesn't support this endpoint. | | 403 | 1007 \[API\_KEY\_DISABLED\] | This API Key has been disabled. Please contact support. | | 429 | 1008 \[API\_KEY\_PLAN\_MINUTE\_RATE\_LIMIT\_REACHED\] | You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute. | | 429 | 1009 \[API\_KEY\_PLAN\_DAILY\_RATE\_LIMIT\_REACHED\] | You've exceeded your API Key's daily rate limit. | | 429 | 1010 \[API\_KEY\_PLAN\_MONTHLY\_RATE\_LIMIT\_REACHED\] | You've exceeded your API Key's monthly rate limit. | | 429 | 1011 \[IP\_RATE\_LIMIT\_REACHED\] | You've hit an IP rate limit. | [](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) Best Practices ========================================================================================= This section contains a few recommendations on how to efficiently utilize the CoinMarketCap API for your enterprise application, particularly if you already have a large base of users for your application. ### Use CoinMarketCap ID Instead of Cryptocurrency Symbol Utilizing common cryptocurrency symbols to reference cryptocurrencies on the API is easy and convenient but brittle. You should know that many cryptocurrencies have the same symbol, for example, there are currently three cryptocurrencies that commonly refer to themselves by the symbol HOT. Cryptocurrency symbols also often change with cryptocurrency rebrands. When fetching cryptocurrency by a symbol that matches several active cryptocurrencies we return the one with the highest market cap at the time of the query. To ensure you always target the cryptocurrency you expect, use our permanent CoinMarketCap IDs. These IDs are used reliably by numerous mission critical platforms and _never change_. We make fetching a map of all active cryptocurrencies' CoinMarketCap IDs very easy. Just call our [`/cryptocurrency/map`](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) endpoint to receive a list of all active currencies mapped to the unique `id` property. This map also includes other typical identifiying properties like `name`, `symbol` and platform `token_address` that can be cross referenced. In cryptocurrency calls you would then send, for example `id=1027`, instead of `symbol=ETH`. **It's strongly recommended that any production code utilize these IDs for cryptocurrencies, exchanges, and markets to future-proof your code.** ### Use the Right Endpoints for the Job You may have noticed that `/cryptocurrency/listings/latest` and `/cryptocurrency/quotes/latest` return the same crypto data but in different formats. This is because the former is for requesting paginated and ordered lists of _all_ cryptocurrencies while the latter is for selectively requesting only the specific cryptocurrencies you require. Many endpoints follow this pattern, allow the design of these endpoints to work for you! ### Implement a Caching Strategy If Needed There are standard legal data safeguards built into the [Commercial User Terms](https://pro.coinmarketcap.com/user-agreement-commercial) that application developers should keep in mind. These Terms help prevent unauthorized scraping and redistributing of CMC data but are intentionally worded to allow legitimate local caching of market data to support the operation of your application. If your application has a significant user base and you are concerned with staying within the call credit and API throttling limits of your subscription plan consider implementing a data caching strategy. For example instead of making a `/cryptocurrency/quotes/latest` call every time one of your application's users needs to fetch market rates for specific cryptocurrencies, you could pre-fetch and cache the latest market data for every cryptocurrency in your application's local database every 60 seconds. This would only require 1 API call, `/cryptocurrency/listings/latest?limit=5000`, every 60 seconds. Then, anytime one of your application's users need to load a custom list of cryptocurrencies you could simply pull this latest market data from your local cache without the overhead of additional calls. This kind of optimization is practical for customers with large, demanding user bases. ### Code Defensively to Ensure a Robust REST API Integration Whenever implementing any high availability REST API service for mission critical operations it's recommended to [code defensively](https://en.wikipedia.org/wiki/Defensive_programming) . Since the API is versioned, any breaking request or response format change would only be introduced through new versions of each endpoint, _however existing endpoints may still introduce new convenience properties over time_. We suggest these best practices: * You should parse the API response JSON as JSON and not through a regular expression or other means to avoid brittle parsing logic. * Your parsing code should explicitly parse only the response properties you require to guarantee new fields that may be returned in the future are ignored. * You should add robust field validation to your response parsing logic. You can wrap complex field parsing, like dates, in try/catch statements to minimize the impact of unexpected parsing issues (like the unlikely return of a null value). * Implement a "Retry with exponential backoff" coding pattern for your REST API call logic. This means if your HTTP request happens to get rate limited (HTTP 429) or encounters an unexpected server-side condition (HTTP 5xx) your code would automatically recover and try again using an intelligent recovery scheme. You may use one of the many libraries available; for example, [this one](https://github.com/tim-kos/node-retry) for Node or [this one](https://github.com/litl/backoff) for Python. ### Reach Out and Upgrade Your Plan If you're uncertain how to best implement the CoinMarketCap API in your application or your needs outgrow our current self-serve subscription tiers you can reach out to [api@coinmarketcap.com](mailto:api@coinmarketcap.com) . We'll review your needs and budget and may be able to tailor a custom enterprise plan that is right for you. [](https://coinmarketcap.com/api/documentation/v1/#section/Version-History) Version History =========================================================================================== The CoinMarketCap API utilizes [Semantic Versioning](https://semver.org/) in the format `major.minor.patch`. The current `major` version is incorporated into the API request path as `/v1/`. Non-breaking `minor` and `patch` updates to the API are released regularly. These may include new endpoints, data points, and API plan features which are always introduced in a non-breaking manner. _This means you can expect new properties to become available in our existing /v1/ endpoints however any breaking change will be introduced under a new major version of the API with legacy versions supported indefinitely unless otherwise stated_. You can [subscribe to our API Newsletter](https://coinmarketcap.com/#newsletter-signup) to get monthly email updates on CoinMarketCap API enhancements. ### v2.0.10 on Oct 14, 2024 * [/v3/fear-and-greed/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedLatest) and [/v3/fear-and-greed/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedHistorical) now available to get CMC Fear and Greed Index ### v2.0.9 on June 1, 2023 * [/v1/community/trending/topic](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingTopic) now available to get community trending topics. * [/v1/community/trending/token](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingToken) now available to get community trending tokens. ### v2.0.8 on November 25, 2022 * [/v1/exchange/assets](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeAssets) now available to get exchange assets in the form of token holdings. ### v2.0.7 on September 19, 2022 * [/v1/content/posts/top](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsTop) now available to get cryptocurrency-related top posts. * [/v1/content/posts/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsLatest) now available to get cryptocurrency-related latest posts. * [/v1/content/posts/comments](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsComments) now available to get comments of the post. ### v2.0.6 on Augest 18, 2022 * [/v1/content/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentLatest) now available to get news/headlines and Alexandria articles. ### v2.0.5 on Augest 4, 2022 * [/v1/tools/postman](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPostman) now API postman collection is available. ### v2.0.4 on October 11, 2021 * [/v1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes `volume_change_24h`. * [/v2/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) now includes `volume_change_24h`. ### v2.0.3 on October 6, 2021 * [/v1/cryptocurrency/trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) now supports `time_period` as an optional parameter. ### v2.0.2 on September 13, 2021 * [/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) now available to Free tier users. * [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) now available to Free tier users. ### v2.0.1 on September 8, 2021 * [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) now includes `volume_24h`, `depth_negative_two`, `depth_positive_two` and `volume_percentage`. * [/exchange/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) now includes `open_interest`. ### v2.0.0 on August 17, 2021 * By popular request we have added a number of new useful endpoints ! * [/v1/cryptocurrency/categories](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategories) can be used to access a list of categories and their associated coins. You can also filter the list of categories by one or more cryptocurrencies. * [/v1/cryptocurrency/category](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategory) can be used to load only a single category of coins, listing the coins within that category. * [/v1/cryptocurrency/airdrops](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrops) can be used to access a list of CoinMarketCap’s free airdrops. This defaults to a status of `ONGOING` but can be filtered to `UPCOMING` or `ENDED`. You can also query for a list of airdrops by cryptocurrency. * [/v1/cryptocurrency/airdrop](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrop) can be used to load a single airdrop and its associated cryptocurrency. * [/v1/cryptocurrency/trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) can be used to load the most searched for cryptocurrencies within a period of time. This defaults to a `time_period` of the previous `24h`, but can be changed to `30d`, or `7d` for a larger window of time. * [/v1/cryptocurrency/trending/most-visited](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostvisited) can be used to load the most visited cryptocurrencies within a period of time. This defaults to a `time_period` of the previous `24h`, but can be changed to `30d`, or `7d` for a larger window of time. * [/v1/cryptocurrency/trending/gainers-losers](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainerslosers) can be used to load the biggest gainers & losers within a period of time. This defaults to a `time_period` of the previous `24h`, but can be changed to `30d`, or `7d` for a larger window of time. ### v1.28.0 on August 9, 2021 * [/v1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes `market_cap_dominance` and `fully_diluted_market_cap`. * [/v1/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) now includes `market_cap_dominance` and `fully_diluted_market_cap`. ### v1.27.0 on January 27, 2021 * [/v2/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyInfo) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyMarketpairsLatest) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesHistorical) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvHistorical) response format changed to allow for multiple coins per symbol. * [/v2/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV2ToolsPriceconversion) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/ohlcv/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvLatest) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyPriceperformancestatsLatest) response format changed to allow for multiple coins per symbol. ### v1.26.0 on January 21, 2021 * [/v2/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) response format changed to allow for multiple coins per symbol. ### v1.25.0 on April 17, 2020 * [/v1.1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes a more robust `tags` response with slug, name, and category. * [/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) now include `is_active` and `is_fiat` in the response. ### v1.24.0 on Feb 24, 2020 * [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) has been modified to include the high and low timestamps. * [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) now includes `category` and `fee_type` market pair filtering options. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes `category` and `fee_type` market pair filtering options. ### v1.23.0 on Feb 3, 2020 * [/fiat/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1FiatMap) is now available to fetch the latest mapping of supported fiat currencies to CMC IDs. * [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) now includes `matched_id` and `matched_symbol` market pair filtering options. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now provides filter parameters `price_min`, `price_max`, `market_cap_min`, `market_cap_max`, `percent_change_24h_min`, `percent_change_24h_max`, `volume_24h_max`, `circulating_supply_min` and `circulating_supply_max` in addition to the existing `volume_24h_min` filter. ### v1.22.0 on Oct 16, 2019 * [/global-metrics/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesLatest) now additionally returns `total_cryptocurrencies` and `total_exchanges` counts which include inactive projects who's data is still available via API. ### v1.21.0 on Oct 1, 2019 * [/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) now includes `sort` options including `volume_24h`. * [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) fix for a scenario where `first_historical_data` and `last_historical_data` may not be populated. * Additional improvements to alphanumeric sorts. ### v1.20.0 on Sep 25, 2019 * By popular request you may now configure API plan usage notifications and email alerts in the [Developer Portal](https://pro.coinmarketcap.com/account/notifications) . * [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) now includes `sort` options including `cmc_rank`. ### v1.19.0 on Sep 19, 2019 * A new `/blockchain/` category of endpoints is now available with the introduction of our new [/v1/blockchain/statistics/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1BlockchainStatisticsLatest) endpoint. This endpoint can be used to poll blockchain statistics data as seen in our [Blockchain Explorer](https://blockchain.coinmarketcap.com/chain/bitcoin) . * Additional platform error codes are now surfaced during HTTP Status Code 401, 402, 403, and 429 scenarios as documented in [Errors and Rate Limits](https://coinmarketcap.com/api/documentation/v1/#section/Errors-and-Rate-Limits) . * OHLCV endpoints using the `convert` option now match historical UTC open period exchange rates with greater accuracy. * [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) and [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) now include the optional `aux` parameter where listing `status` can be requested in the list of supplemental properties. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) : The accuracy of `percent_change_` conversions was improved when passing non-USD fiat `convert` options. * [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) now support relaxed request validation rules via the `skip_invalid` request parameter. * We also now return a helpful `notice` warning when API key usage is above 95% of daily and monthly API credit usage limits. ### v1.18.0 on Aug 28, 2019 * [/key/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1KeyInfo) has been added as a new endpoint. It may be used programmatically monitor your key usage compared to the rate limit and daily/monthly credit limits available to your API plan as an alternative to using the [Developer Portal Dashboard](https://pro.coinmarketcap.com/account) . * [/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) and [/v1/global-metrics/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesHistorical) have new options to make charting tasks easier and more efficient. Use the new `aux` parameter to cut out response properties you don't need and include the new `search_interval` timestamp to normalize disparate historical records against the same `interval` time periods. * A 4 hour interval option `4h` was added to all historical time series data endpoints. ### v1.17.0 on Aug 22, 2019 * [/cryptocurrency/price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyPriceperformancestatsLatest) has been added as our 21st endpoint! It returns launch price ROI, all-time high / all-time low, and other price stats over several supported time periods. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) now has the ability to filter all active markets for a cryptocurrency to specific base/quote pairs. Want to return only `BTC/USD` and `BTC/USDT` markets? Just pass `?symbol=BTC&matched_symbol=USD,USDT` or `?id=1&matched_id=2781,825`. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) now features `sort` options including `cmc_rank` to reproduce the [methodology](https://coinmarketcap.com/methodology/) based sort on pages like [Bitcoin Markets](https://coinmarketcap.com/currencies/bitcoin/#markets) . * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) can now return any exchange level CMC notices affecting a market via the new `notice` `aux` parameter. * [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) will now continue to return the last updated price data for cryptocurrency that have transitioned to an `inactive` state instead of returning an HTTP 400 error. These active coins that have gone inactive can easily be identified as having a `num_market_pairs` of `0` and a stale `last_updated` date. * [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) now includes a brief text summary for most exchanges as `description`. ### v1.16.0 on Aug 9, 2019 * We've introduced a new [partners](https://coinmarketcap.com/api/documentation/v1/#tag/partners) category of endpoints for convenient access to 3rd party crypto data. [FlipSide Crypto](https://www.flipsidecrypto.com/) 's [Fundamental Crypto Asset Score](https://www.flipsidecrypto.com/fcas-explained) (FCAS) is now available as the first partner integration. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now provides a `volume_24h_min` filter parameter. It can be used when a threshold of volume is required like in our [Biggest Gainers and Losers](https://coinmarketcap.com/gainers-losers/) lists. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) can now return rolling `volume_7d` and `volume_30d` via the supplemental `aux` parameter and sort options by these fields. * `volume_24h_reported`, `volume_7d_reported`, `volume_30d_reported`, and `market_cap_by_total_supply` are also now available through the `aux` parameter with an additional sort option for the latter. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) can now provide market price relative to the quote currency. Just pass `price_quote` to the supplemental `aux` parameter. This can be used to display consistent price data for a cryptocurrency across several markets no matter if it is the base or quote in each pair as seen in our [Bitcoin markets](https://coinmarketcap.com/currencies/bitcoin/#markets) price column. * When requesting a custom `sort` on our list based endpoints, numeric fields like `percent_change_7d` now conveniently return non-applicable `null` values last regardless of sort order. ### v1.15.0 on Jul 10, 2019 * [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) and [/v1/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) now expose a 3rd listing state of `untracked` between `active` and `inactive` as outlined in our [methodology](https://coinmarketcap.com/methodology/) . See endpoint documentation for additional details. * [/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) , [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) , and [/exchange/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) now support fetching multiple cryptocurrencies and exchanges in the same call. * [/global-metrics/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesLatest) now updates more frequently, every minute. It aslo now includes `total_volume_24h_reported`, `altcoin_volume_24h`, `altcoin_volume_24h_reported`, and `altcoin_market_cap`. * [/global-metrics/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesHistorical) also includes these new dimensions along with historical `active_cryptocurrencies`, `active_exchanges`, and `active_market_pairs` counts. * We've also added a new `aux` auxiliary parameter to many endpoints which can be used to customize your request. You may request new supplemental data properties that are not returned by default or slim down your response payload by excluding default `aux` fields you don't need in endpoints like [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) . [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) and [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) can now supply `market_url`, `currency_name`, and `currency_slug` for each market using this new parameter. [/exchange/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) can now include the exchange `date_launched`. ### v1.14.1 on Jun 14, 2019 - DATA: Phase 1 methodology updates Per our [May 1 announcement](https://blog.coinmarketcap.com/2019/05/01/happy-6th-birthday-data-alliance-block-explorers-and-more/) of the Data Accountability & Transparency Alliance ([DATA](https://coinmarketcap.com/data-transparency-alliance/) ), a platform [methodology](https://coinmarketcap.com/methodology/) update was published. No API changes are required but users should take note: * Exchanges that are not compliant with mandatory transparency requirements (Ability to surface live trade and order book data) will be excluded from VWAP price and volume calculations returned from our `/cryptocurrency/` and `/global-metrics/` endpoints going forward. * These exchanges will also return a `volume_24h_adjusted` value of 0 from our `/exchange/` endpoints like the exclusions based on market category and fee type. Stale markets (24h or older) will also be excluded. All exchanges will continue to return `exchange_reported` values as reported. * We welcome you to [learn more about the DATA alliance and become a partner](https://coinmarketcap.com/data-transparency-alliance/) . ### v1.14.0 on Jun 3, 2019 * [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) now include up to 5 block explorer URLs for each cryptocurrency including our brand new [Bitcoin and Ethereum Explorers](https://blockchain.coinmarketcap.com/) . * [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) now provides links to most cryptocurrency white papers and technical documentation! Just reference the `technical_doc` array. * [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) now returns a `notice` property that may highlight a significant event or condition that is impacting the cryptocurrency or how it is displayed. See the endpoint property description for more details. * [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) also includes a `notice` property. This one may highlight a condition that is impacting the availability of an exchange's market data or the use of the exchange. See the endpoint property description for more details. * [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) now includes the official launch date for each exchange as `date_launched`. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) and [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) now include market `category` (Spot, Derivatives, or OTC) and `fee_type` (Percentage, No Fees, Transactional Mining, or Unknown) for every market returned. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) now supports querying by cryptocurrency `slug`. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes a `market_cap_strict` sort option to apply a strict numeric sort on this field. ### v1.13.0 on May 17, 2019 * You may now leverage CoinMarketCap IDs for currency `quote` conversions across all endpoints! Just utilize the new `convert_id` parameter instead of the `convert` parameter. Learn more about creating robust integrations with CMC IDs in our [Best Practices](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) . * We've updated requesting cryptocurrencies by `slug` to support legacy names from past cryptocurrency rebrands. For example, a request to `/cryptocurrency/quotes/latest?slug=antshares` successfully returns the cryptocurrency by current slug `neo`. * We've extended the brief text summary included as `description` in [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) to now cover all cryptocurrencies! * We've added the fetch-by-slug option to [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) . * Premium subscription users: On your next billing period we'll conveniently switch to displaying monthly/daily credit usage relative to your monthly billing period instead of calendar month and UTC midnight. Click the `?` on our updated [API Key Usage](https://pro.coinmarketcap.com/account) panel for more details. ### v1.12.1 on May 1, 2019 * To celebrate CoinMarketCap's 6th anniversary we've upgraded the crypto API to make more of our data available at each tier! * Our free Basic tier may now access live price conversions via [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) . * Our Hobbyist tier now supports a month of historical price conversions with [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) using the `time` parameter. We've also made this plan 12% cheaper at $29/mo with a yearly subscription or $35/mo month-to-month. * Our Startup tier can now access a month of cryptocurrency OHLCV data via [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) along with [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) . * Our Standard tier has been upgraded from 1 month to now 3 months of historical market data access across all historical endpoints. * Our Enterprise, Professional, and Standard tiers now get access to a new #18th endpoint [/cryptocurrency/listings/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsHistorical) ! Utilize this endpoint to fetch daily historical crypto rankings from the past. We've made historical ranking snapshots available all the way back to 2013! * All existing accounts and subscribers may take advantage of these updates. If you haven't signed up yet you can check out our updated plans on our [feature comparison page](https://coinmarketcap.com/api/features/) . ### v1.12.0 on Apr 28, 2019 * Our API docs now supply API request examples in 7 languages for every endpoint: cURL, Node.js, Python, PHP, Java, C#, and Go. * Many customer sites format cryptocurrency data page URLs by SEO friendly names like we do here: [coinmarketcap.com/currencies/binance-coin](https://coinmarketcap.com/currencies/binance-coin/) . We've made it much easier for these kinds of pages to dynamically reference data from our API. You may now request cryptocurrencies from our [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) endpoints by `slug` as an alternative to `symbol` or `id`. As always, you can retrieve a quick list of every cryptocurrency we support and it's `id`, `symbol`, and `slug` via our [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) endpoint. * We've increased `convert` limits on historical endpoints once more. You can now request historical market data in up to 3 conversion options at a time like we do internally to display line charts [like this](https://coinmarketcap.com/currencies/0x/#charts) . You can now fetch market data converted into your primary cryptocurrency, fiat currency, and a parent platform cryptocurrency (Ethereum in this case) all in one call! ### v1.11.0 on Mar 25, 2019 * We now supply a brief text summary for each cryptocurrency in the `description` field of [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) . The majority of top cryptocurrencies include this field with more coming in the future. * We've made `convert` limits on some endpoints and plans more flexible. Historical endpoints are now allowed 2 price conversion options instead of 1. Professional plan convert limit has doubled from 40 to 80. Enterprise has tripled from 40 to 120. * CoinMarketCap Market ID: We now return `market_id` in /market-pairs/latest endpoints. Like our cryptocurrency and exchange IDs, this ID can reliably be used to uniquely identify each market _permanently_ as this ID never changes. * Market symbol overrides: We now supply an `exchange_symbol` in addition to `currency_symbol` for each market pair returned in our /market-pairs/latest endpoints. This allows you to reference the currency symbol provided by the exchange in case it differs from the CoinMarketCap identified symbol that the majority of markets use. ### v1.10.1 on Jan 30, 2019 * Our API health status dashboard is now public at [http://status.coinmarketcap.com](http://status.coinmarketcap.com/) . * We now conveniently return `market_cap` in our [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) endpoint so you don't have to make a separately query when fetching historic OHLCV data. * We've improved the accuracy of percent\_change\_1h / 24h / 7d calculations when using the `convert` option with our latest cryptocurrency endpoints. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) now updates more frequently, every 1 minute. * Contract Address and parent platform metadata changes are reflected on the API much more quickly. ### v1.9.0 on Jan 8, 2019 * Did you know there are currently 684 active USD market pairs tracked by CoinMarketCap? You can now pass any [fiat CoinMarketCap ID](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) to the [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) `id` parameter to list all active markets across all exchanges for a given fiat currency. * We've added a new dedicated migration FAQ page for users migrating from our old Public API to the new API [here](https://pro.coinmarketcap.com/migrate) . It includes a helpful tutorial link for Excel and Google Sheets users who need help migrating. * Cryptocurrency and exchange symbol and name rebrands are now reflected in the API much more quickly. ### v1.8.0 on Dec 27, 2018 * We now supply the contract address for all cryptocurrencies on token platforms like Ethereum! Look for `token_address` in the `platform` property of our cryptocurrency endpoints like [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) and [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) . * All 96 non-USD fiat conversion rates now update every 1 minute like our USD rates! This includes using the `convert` option for all /latest market data endpoints as well as our [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) endpoint. ### v1.7.0 on Dec 18, 2018 * We've upgraded our fiat (government) currency conversion support from our original 32 to now cover 93 fiat currencies! * We've also introduced currency conversions for four precious metals: Gold, Silver, Platinum, and Palladium! * You may pass all 97 fiat currency options to our [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) endpoint using either the `symbol` or `id` parameter. Using CMC `id` is always the most robust option. CMC IDs are now included in the full list of fiat options located [here](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . * All historical endpoints including our price conversion endpoint with "time" parameter now support historical fiat conversions back to 2013! ### v1.6.0 on Dec 4, 2018 * We've rolled out another top requested feature, giving you access to platform metadata for cryptocurrencies that are tokens built on other cryptocurrencies like Ethereum. Look for the new `platform` property on our cryptocurrency endpoints like [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) and [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) . * We've also added a **CMC equivalent pages** section to our endpoint docs so you can easily determine which endpoints to use to reproduce functionality on the main coinmarketcap.com website. * Welcome Public API users! With the migration of our legacy Public API into the Professional API we now have 1 unified API at CMC. This API is now known as the CoinMarketCap API and can always be accessed at [coinmarketcap.com/api](https://coinmarketcap.com/api) . ### v1.5.0 on Nov 28, 2018 * [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) now supports hourly OHLCV! Use time\_period="hourly" and don't forget to set the "interval" parameter to "hourly" or one of the new hourly interval options. * [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) now supports historical USD conversions. * We've increased the minute based rate limits for several plans. Standard plan has been upgraded from 30 to 60 calls per minute. Professional from 60 to 90. Enterprise from 90 to 120. * We now include some customer and data partner logos and testimonials on the CoinMarketCap API site. Visit [pro.coinmarketcap.com](http://pro.coinmarketcap.com/) to check out what our enterprise customers are saying and contact us at [api@coinmarketcap.com](mailto:api@coinmarketcap.com) if you'd like to get added to the list! ### v1.4.0 on Nov 20, 2018 * [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) can now provide the latest crypto-to-crypto conversions at 1 minute accuracy with extended decimal precision upwards of 8 decimal places. * [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) now supports historical crypto-to-crypto conversions leveraging our closest averages to the specified "time" parameter. * All of our historical data endpoints now support historical cryptocurrency conversions using the "convert" parameter. The closest reference price for each "convert" option against each historical datapoint is used for each conversion. * [/global-metrics/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesHistorical) now supports the "convert" parameter. ### v1.3.0 on Nov 9, 2018 * The latest UTC day's OHLCV record is now available sooner. 5-10 minutes after each UTC midnight. * We're now returning a new `vol_24h_adjusted` property on [/exchange/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) and [/exchange/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) and a sort option for the latter so you may now list exchange rankings by CMC adjusted volume as well as exchange reported. * We are now returning a `tags` property with [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) with our first tag `mineable` so you know which currencies are mineable. Additional tags will be introduced in the future. * We've increased the "convert" parameter limit from 32 to 40 for plans that support max conversion limits. ### v1.2.0 on Oct 30, 2018 * Our exchange [listing](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) and [quotes](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) endpoints now update much more frequently! Every 1 minute instead of every 5 minutes. * These latest exchange data endpoints also now return `volume_7d / 30d` and `percent_change_volume_24h / 7d / 30d` along with existing data. * We've updated our documentation for [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) to reflect that it receives updates every 1 minute, not 5, since June. ### v1.1.4 on Oct 19, 2018 * We've improved our tiered support inboxes by plan type to answer support requests even faster. * You may now opt-in to our API mailing list on signup. If you haven't signed up you can [here](https://coinmarketcap.com/#newsletter-signup) . ### v1.1.3 on Oct 12, 2018 * We've increased the rate limit of our free Basic plan from 10 calls a minute to 30. * We've increased the rate limit of our Hobbyist plan from 15 to 30. ### v1.1.2 on Oct 5, 2018 * We've updated our most popular /cryptocurrency/listings/latest endpoint to cost 1 credit per 200 data points instead of 100 to give customers more flexibility. * By popular request we've introduced a new $33 personal use Hobbyist tier with access to our currency conversion calculator endpoint. * Our existing commercial use Hobbyist tier has been renamed to Startup. Our free Starter tier has been renamed to Basic. ### v1.1.1 on Sept 28, 2018 * We've increased our monthly credit limits for our smaller plans! Existing customers plans have also been updated. * Our free Starter plan has been upgraded from 6 to 10k monthly credits (66% increase). * Our Hobbyist plan has been upgraded from 60k to 120k monthly credits (100% increase). * Our Standard plan has been upgraded from 300 to 500k monthly credits (66% increase). ### v1.1.0 on Sept 14, 2018 * We've introduced our first new endpoint since rollout, active day OHLCV for Standard plan and above with [/v1/cryptocurrency/ohlcv/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvLatest) ### v1.0.4 on Sept 7, 2018 * Subscription customers with billing renewal issues now receive an alert from our API during usage and an unpublished grace period before access is restricted. * API Documentation has been improved including an outline of credit usage cost outlined on each endpoint documentation page. ### v1.0.3 on Aug 24, 2018 * /v1/tools/price-conversion floating point conversion accuracy was improved. * Added ability to query for non-alphanumeric crypto symbols like $PAC * Customers may now update their billing card on file with an active Stripe subscription at pro.coinmarketcap.com/account/plan [](https://coinmarketcap.com/api/documentation/v1/#tag/cryptocurrency) cryptocurrency ===================================================================================== ##### API endpoints for cryptocurrencies. This category currently includes 17 endpoints: * [/v1/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) - CoinMarketCap ID map * [/v2/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyInfo) - Metadata * [/v1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) - Latest listings * [/v1/cryptocurrency/listings/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsHistorical) - Historical listings * [/v2/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) - Latest quotes * [/v2/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesHistorical) - Historical quotes * [/v2/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyMarketpairsLatest) - Latest market pairs * [/v2/cryptocurrency/ohlcv/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvLatest) - Latest OHLCV * [/v2/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvHistorical) - Historical OHLCV * [/v2/cryptocurrency/price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyPriceperformancestatsLatest) - Price performance Stats * [/v1/cryptocurrency/categories](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategories) - Categories * [/v1/cryptocurrency/category](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategory) - Category * [/v1/cryptocurrency/airdrops](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrops) - Airdrops * [/v1/cryptocurrency/airdrop](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrop) - Airdrop * [/v1/cryptocurrency/trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) - Trending Latest * [/v1/cryptocurrency/trending/most-visited](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostvisited) - Trending Most Visited * [/v1/cryptocurrency/trending/gainers-losers](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainerslosers) - Trending Gainers & Losers [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrop) Airdrop ------------------------------------------------------------------------------------------------ Returns information about a single airdrop available on CoinMarketCap. Includes the cryptocurrency metadata. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request no matter query size. **CMC equivalent pages:** Our free airdrops page [coinmarketcap.com/airdrop/](https://coinmarketcap.com/airdrop/) . ##### Parameters id string Required Airdrop Unique ID. This can be found using the Airdrops API. Responses --------- 200 Successful | | | | --- | --- | | data null | Airdrop%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/airdrop Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/airdrop * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": "60e59b99c8ca1d58514a2322", * "project\_name": "DeRace Airdrop", * "description": "For 7 days starting from August 15, 2021, CoinMarketCap will host an Airdrop event...", * "status": "UPCOMING", * "coin": { * "id": 10744, * "name": "DeRace", * "slug": "derace", * "symbol": "DERC" }, * "start\_date": "2021-06-01T22:11:00.000Z", * "end\_date": "2021-07-01T22:11:00.000Z", * "total\_prize": 20000000000, * "winner\_count": 1000, * "link": "[https://coinmarketcap.com/currencies/derace/airdrop/](https://coinmarketcap.com/currencies/derace/airdrop/) " }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrops) Airdrops -------------------------------------------------------------------------------------------------- Returns a list of past, present, or future airdrops which have run on CoinMarketCap. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request no matter query size. **CMC equivalent pages:** Our free airdrops page [coinmarketcap.com/airdrop/](https://coinmarketcap.com/airdrop/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. status string "ONGOING" "ENDED" "ONGOING" "UPCOMING" What status of airdrops. id string ^\\d\*$ Filtered airdrops by one cryptocurrency CoinMarketCap IDs. Example: 1 slug string ^\[0-9a-z-\]\*$ Alternatively filter airdrops by a cryptocurrency slug. Example: "bitcoin" symbol string ^\[0-9A-Za-z$@\\-\]\*$ Alternatively filter airdrops one cryptocurrency symbol. Example: "BTC". Responses --------- 200 Successful | | | | --- | --- | | data null | Airdrops%20-%20Airdrop%20Object Required

Array of airdrop object results. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/airdrops Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/airdrops * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": "60e59b99c8ca1d58514a2322",\ \ * "project\_name": "DeRace Airdrop",\ \ * "description": "For 7 days starting from August 15, 2021, CoinMarketCap will host an Airdrop event...",\ \ * "status": "UPCOMING",\ \ * "coin": \ \ {\ \ * "id": 10744,\ \ * "name": "DeRace",\ \ * "slug": "derace",\ \ * "symbol": "DERC"\ \ \ },\ \ * "start\_date": "2021-06-01T22:11:00.000Z",\ \ * "end\_date": "2021-07-01T22:11:00.000Z",\ \ * "total\_prize": 20000000000,\ \ * "winner\_count": 1000,\ \ * "link": "[https://coinmarketcap.com/currencies/derace/airdrop/](https://coinmarketcap.com/currencies/derace/airdrop/)\ "\ \ \ }\ \ \ \], * "status": { * "timestamp": "2021-08-01T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 3, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategories) Categories ------------------------------------------------------------------------------------------------------ Returns information about all coin categories available on CoinMarketCap. Includes a paginated list of cryptocurrency quotes and metadata from each category. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Free * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request + 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our free airdrops page [coinmarketcap.com/cryptocurrency-category/](https://coinmarketcap.com/cryptocurrency-category/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. id string ^\\d+(?:,\\d+)\*$ Filtered categories by one or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2 slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively filter categories by a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively filter categories one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". Responses --------- 200 Successful | | | | --- | --- | | data null | Categories%20-%20Category%20object Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/categories Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/categories * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": "605e2ce9d41eae1066535f7c",\ \ * "name": "A16Z Portfolio",\ \ * "title": "A16Z Portfolio",\ \ * "description": "A16Z Portfolio",\ \ * "num\_tokens": 12,\ \ * "avg\_price\_change": 0.61305157,\ \ * "market\_cap": 29429241867.031097,\ \ * "market\_cap\_change": 3.049044106496,\ \ * "volume": 4103706600.0391645,\ \ * "volume\_change": \-10.538325849854,\ \ * "last\_updated": 1616488708878\ \ \ }\ \ \ \], * "status": { * "timestamp": "2021-08-01T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 3, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategory) Category -------------------------------------------------------------------------------------------------- Returns information about a single coin category available on CoinMarketCap. Includes a paginated list of the cryptocurrency quotes and metadata for the category. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Free * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request + 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our Cryptocurrency Category page [coinmarketcap.com/cryptocurrency-category/](https://coinmarketcap.com/cryptocurrency-category/) . ##### Parameters id string Required The Category ID. This can be found using the Categories API. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of coins to return. limit integer \[ 1 .. 1000 \] 100 Optionally specify the number of coins to return. Use this parameter and the "start" parameter to determine your own pagination size. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Category%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/category Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/category * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": "605e2ce9d41eae1066535f7c", * "name": "A16Z Portfolio", * "title": "A16Z Portfolio", * "description": "A16Z Portfolio", * "num\_tokens": 12, * "avg\_price\_change": 0.61305157, * "market\_cap": 29429241867.031097, * "market\_cap\_change": 3.049044106496, * "volume": 4103706600.0391645, * "volume\_change": \-10.538325849854, * "coins": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "last\_updated": 1616488708878 }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) CoinMarketCap ID Map --------------------------------------------------------------------------------------------------------- Returns a mapping of all cryptocurrencies to unique CoinMarketCap `id`s. Per our [Best Practices](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) we recommend utilizing CMC ID instead of cryptocurrency symbols to securely identify cryptocurrencies with our other endpoints and in your own application logic. Each cryptocurrency returned includes typical identifiers such as `name`, `symbol`, and `token_address` for flexible mapping to `id`. By default this endpoint returns cryptocurrencies that have actively tracked markets on supported exchanges. You may receive a map of all inactive cryptocurrencies by passing `listing_status=inactive`. You may also receive a map of registered cryptocurrency projects that are listed but do not yet meet methodology requirements to have tracked markets via `listing_status=untracked`. Please review our [methodology documentation](https://coinmarketcap.com/methodology/) for additional details on listing states. Cryptocurrencies returned include `first_historical_data` and `last_historical_data` timestamps to conveniently reference historical date ranges available to query with historical time-series data endpoints. You may also use the `aux` parameter to only include properties you require to slim down the payload if calling this endpoint frequently. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Basic * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Mapping data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request no matter query size. **CMC equivalent pages:** No equivalent, this data is only available via API. ##### Parameters listing\_status string "active" ^(active|inactive|untracked)+(?:,(active|inactive|untracked)+)\*$ Only active cryptocurrencies are returned by default. Pass `inactive` to get a list of cryptocurrencies that are no longer active. Pass `untracked` to get a list of cryptocurrencies that are listed but do not yet meet methodology requirements to have tracked markets available. You may pass one or more comma-separated values. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. sort string "id" "cmc\_rank" "id" What field to sort the list of cryptocurrencies by. symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Optionally pass a comma-separated list of cryptocurrency symbols to return CoinMarketCap IDs for. If this option is passed, other options will be ignored. aux string "platform,first\_historical\_data,last\_historical\_data,is\_active" ^(platform|first\_historical\_data|last\_historical\_data|is\_active|status)+(?:,(platform|first\_historical\_data|last\_historical\_data|is\_active|status)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `platform,first_historical_data,last_historical_data,is_active,status` to include all auxiliary fields. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Map%20-%20Cryotocurrency%20Object Required

Array of cryptocurrency object results. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/map Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/map * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "rank": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "is\_active": 1,\ \ * "first\_historical\_data": "2013-04-28T18:47:21.000Z",\ \ * "last\_historical\_data": "2020-05-05T20:44:01.000Z",\ \ * "platform": null\ \ \ },\ \ * {\ \ * "id": 1839,\ \ * "rank": 3,\ \ * "name": "Binance Coin",\ \ * "symbol": "BNB",\ \ * "slug": "binance-coin",\ \ * "is\_active": 1,\ \ * "first\_historical\_data": "2017-07-25T04:30:05.000Z",\ \ * "last\_historical\_data": "2020-05-05T20:44:02.000Z",\ \ * "platform": \ \ {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "token\_address": "0xB8c77482e45F1F44dE1745F52C74426C631bDD52"\ \ \ }\ \ \ },\ \ * {\ \ * "id": 825,\ \ * "rank": 5,\ \ * "name": "Tether",\ \ * "symbol": "USDT",\ \ * "slug": "tether",\ \ * "is\_active": 1,\ \ * "first\_historical\_data": "2015-02-25T13:34:26.000Z",\ \ * "last\_historical\_data": "2020-05-05T20:44:01.000Z",\ \ * "platform": \ \ {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "token\_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyInfo) Metadata v2 ------------------------------------------------------------------------------------------------- Returns all static metadata available for one or more cryptocurrencies. This information includes details like logo, description, official website URL, social links, and links to a cryptocurrency's technical documentation. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Basic * Startup * Hobbyist * Standard * Professional * Enterprise **Cache / Update frequency:** Static data is updated only as needed, every 30 seconds. **Plan credit use:** 1 call credit per 100 cryptocurrencies returned (rounded up). **CMC equivalent pages:** Cryptocurrency detail page metadata like [coinmarketcap.com/currencies/bitcoin/](https://coinmarketcap.com/currencies/bitcoin/) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "slug" _or_ "symbol" is required for this request. Please note that starting in the v2 endpoint, due to the fact that a symbol is not unique, if you request by symbol each data response will contain an array of objects containing all of the coins that use each requested symbol. The v1 endpoint will still return a single object, the highest ranked coin using that symbol. address string Alternatively pass in a contract address. Example: "0xc40af1e4fecfa05ce6bab79dcd8b373d2e436c4e" skip\_invalid boolean false Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if any invalid cryptocurrencies are requested or a cryptocurrency does not have matching records in the requested timeframe. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. aux string "urls,logo,description,tags,platform,date\_added,notice" ^(urls|logo|description|tags|platform|date\_added|notice|status)+(?:,(urls|logo|description|tags|platform|date\_added|notice|status)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `urls,logo,description,tags,platform,date_added,notice,status` to include all auxiliary fields. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Info%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/info Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/info * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "1": { * "urls": { * "website": \[\ \ * "[https://bitcoin.org/](https://bitcoin.org/)\ "\ \ \ \], * "technical\_doc": \[\ \ * "[https://bitcoin.org/bitcoin.pdf](https://bitcoin.org/bitcoin.pdf)\ "\ \ \ \], * "twitter": \[ \], * "reddit": \[\ \ * "[https://reddit.com/r/bitcoin](https://reddit.com/r/bitcoin)\ "\ \ \ \], * "message\_board": \[\ \ * "[https://bitcointalk.org](https://bitcointalk.org/)\ "\ \ \ \], * "announcement": \[ \], * "chat": \[ \], * "explorer": \[\ \ * "[https://blockchain.coinmarketcap.com/chain/bitcoin](https://blockchain.coinmarketcap.com/chain/bitcoin)\ ",\ \ * "[https://blockchain.info/](https://blockchain.info/)\ ",\ \ * "[https://live.blockcypher.com/btc/](https://live.blockcypher.com/btc/)\ "\ \ \ \], * "source\_code": \[\ \ * "[https://github.com/bitcoin/](https://github.com/bitcoin/)\ "\ \ \ \] }, * "logo": "[https://s2.coinmarketcap.com/static/img/coins/64x64/1.png](https://s2.coinmarketcap.com/static/img/coins/64x64/1.png) ", * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "slug": "bitcoin", * "description": "Bitcoin (BTC) is a consensus network that enables a new payment system and a completely digital currency. Powered by its users, it is a peer to peer payment network that requires no central authority to operate. On October 31st, 2008, an individual or group of individuals operating under the pseudonym "Satoshi Nakamoto" published the Bitcoin Whitepaper and described it as: "a purely peer-to-peer version of electronic cash would allow online payments to be sent directly from one party to another without going through a financial institution."", * "date\_added": "2013-04-28T00:00:00.000Z", * "date\_launched": "2013-04-28T00:00:00.000Z", * "tags": \[\ \ * "mineable"\ \ \ \], * "platform": null, * "category": "coin" }, * "1027": { * "urls": { * "website": \[\ \ * "[https://www.ethereum.org/](https://www.ethereum.org/)\ "\ \ \ \], * "technical\_doc": \[\ \ * "[https://github.com/ethereum/wiki/wiki/White-Paper](https://github.com/ethereum/wiki/wiki/White-Paper)\ "\ \ \ \], * "twitter": \[\ \ * "[https://twitter.com/ethereum](https://twitter.com/ethereum)\ "\ \ \ \], * "reddit": \[\ \ * "[https://reddit.com/r/ethereum](https://reddit.com/r/ethereum)\ "\ \ \ \], * "message\_board": \[\ \ * "[https://forum.ethereum.org/](https://forum.ethereum.org/)\ "\ \ \ \], * "announcement": \[\ \ * "[https://bitcointalk.org/index.php?topic=428589.0](https://bitcointalk.org/index.php?topic=428589.0)\ "\ \ \ \], * "chat": \[\ \ * "[https://gitter.im/orgs/ethereum/rooms](https://gitter.im/orgs/ethereum/rooms)\ "\ \ \ \], * "explorer": \[\ \ * "[https://blockchain.coinmarketcap.com/chain/ethereum](https://blockchain.coinmarketcap.com/chain/ethereum)\ ",\ \ * "[https://etherscan.io/](https://etherscan.io/)\ ",\ \ * "[https://ethplorer.io/](https://ethplorer.io/)\ "\ \ \ \], * "source\_code": \[\ \ * "[https://github.com/ethereum](https://github.com/ethereum)\ "\ \ \ \] }, * "logo": "[https://s2.coinmarketcap.com/static/img/coins/64x64/1027.png](https://s2.coinmarketcap.com/static/img/coins/64x64/1027.png) ", * "id": 1027, * "name": "Ethereum", * "symbol": "ETH", * "slug": "ethereum", * "description": "Ethereum (ETH) is a smart contract platform that enables developers to build decentralized applications (dapps) conceptualized by Vitalik Buterin in 2013. ETH is the native currency for the Ethereum platform and also works as the transaction fees to miners on the Ethereum network. Ethereum is the pioneer for blockchain based smart contracts. When running on the blockchain a smart contract becomes like a self-operating computer program that automatically executes when specific conditions are met. On the blockchain, smart contracts allow for code to be run exactly as programmed without any possibility of downtime, censorship, fraud or third-party interference. It can facilitate the exchange of money, content, property, shares, or anything of value. The Ethereum network went live on July 30th, 2015 with 72 million Ethereum premined.", * "notice": null, * "date\_added": "2015-08-07T00:00:00.000Z", * "date\_launched": "2015-08-07T00:00:00.000Z", * "tags": \[\ \ * "mineable"\ \ \ \], * "platform": null, * "category": "coin", * "self\_reported\_circulating\_supply": null, * "self\_reported\_market\_cap": null, * "self\_reported\_tags": null, * "infinite\_supply": false } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsHistorical) Listings Historical ----------------------------------------------------------------------------------------------------------------------- Returns a ranked and sorted list of all cryptocurrencies for a historical UTC date. **Technical Notes** * This endpoint is identical in format to our [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) endpoint but is used to retrieve historical daily ranking snapshots from the end of each UTC day. * Daily snapshots reflect market data at the end of each UTC day and may be requested as far back as 2013-04-28 (as supported by your plan's historical limits). * The required "date" parameter can be passed as a Unix timestamp or ISO 8601 date but only the date portion of the timestamp will be referenced. It is recommended to send an ISO date format like "2019-10-10" without time. * This endpoint is for retrieving paginated and sorted lists of all currencies. If you require historical market data on specific cryptocurrencies you should use [/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) . Cryptocurrencies are listed by cmc\_rank by default. You may optionally sort against any of the following: **cmc\_rank**: CoinMarketCap's market cap rank as outlined in [our methodology](https://coinmarketcap.com/methodology/) . **name**: The cryptocurrency name. **symbol**: The cryptocurrency symbol. **market\_cap**: market cap (latest trade price x circulating supply). **price**: latest average trade price across markets. **circulating\_supply**: approximate number of coins currently in circulation. **total\_supply**: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned). **max\_supply**: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency. **num\_market\_pairs**: number of market pairs across all exchanges trading each currency. **volume\_24h**: 24 hour trading volume for each currency. **percent\_change\_1h**: 1 hour trading price percentage change for each currency. **percent\_change\_24h**: 24 hour trading price percentage change for each currency. **percent\_change\_7d**: 7 day trading price percentage change for each currency. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * Hobbyist (1 month) * Startup (1 month) * Standard (3 month) * Professional (12 months) * Enterprise (Up to 6 years) **Cache / Update frequency:** The last completed UTC day is available 30 minutes after midnight on the next UTC day. **Plan credit use:** 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our historical daily crypto ranking snapshot pages like this one on [February 02, 2014](https://coinmarketcap.com/historical/20140202/) . ##### Parameters date string Required date (Unix or ISO 8601) to reference day of snapshot. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. sort string "cmc\_rank" "cmc\_rank" "name" "symbol" "market\_cap" "price" "circulating\_supply" "total\_supply" "max\_supply" "num\_market\_pairs" "volume\_24h" "percent\_change\_1h" "percent\_change\_24h" "percent\_change\_7d" What field to sort the list of cryptocurrencies by. sort\_dir string "asc" "desc" The direction in which to order cryptocurrencies against the specified sort. cryptocurrency\_type string "all" "all" "coins" "tokens" The type of cryptocurrency to include. aux string "platform,tags,date\_added,circulating\_supply,total\_supply,max\_supply,cmc\_rank,num\_market\_pairs" ^(platform|tags|date\_added|circulating\_supply|total\_supply|max\_supply|cmc\_rank|num\_market\_pairs)+(?:,(platform|tags|date\_added|circulating\_supply|total\_supply|max\_supply|cmc\_rank|num\_market\_pairs)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `platform,tags,date_added,circulating_supply,total_supply,max_supply,cmc_rank,num_market_pairs` to include all auxiliary fields. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Listings%20Latest%20-%20Cryptocurrency%20object Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/listings/historical Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 1,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 17200062,\ \ * "total\_supply": 17200062,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6089,\ \ * "circulating\_supply": 17200062,\ \ * "total\_supply": 17200062,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1678.6501384942708,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2019-04-02T22:44:24.200Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) Listings Latest --------------------------------------------------------------------------------------------------------------- Returns a paginated list of all active cryptocurrencies with latest market data. The default "market\_cap" sort returns cryptocurrency in order of CoinMarketCap's market cap rank (as outlined in [our methodology](https://coinmarketcap.com/methodology/) ) but you may configure this call to order by another market ranking field. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call. You may sort against any of the following: **market\_cap**: CoinMarketCap's market cap rank as outlined in [our methodology](https://coinmarketcap.com/methodology/) . **market\_cap\_strict**: A strict market cap sort (latest trade price x circulating supply). **name**: The cryptocurrency name. **symbol**: The cryptocurrency symbol. **date\_added**: Date cryptocurrency was added to the system. **price**: latest average trade price across markets. **circulating\_supply**: approximate number of coins currently in circulation. **total\_supply**: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned). **max\_supply**: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency. **num\_market\_pairs**: number of market pairs across all exchanges trading each currency. **market\_cap\_by\_total\_supply\_strict**: market cap by total supply. **volume\_24h**: rolling 24 hour adjusted trading volume. **volume\_7d**: rolling 24 hour adjusted trading volume. **volume\_30d**: rolling 24 hour adjusted trading volume. **percent\_change\_1h**: 1 hour trading price percentage change for each currency. **percent\_change\_24h**: 24 hour trading price percentage change for each currency. **percent\_change\_7d**: 7 day trading price percentage change for each currency. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Basic * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our latest cryptocurrency listing and ranking pages like [coinmarketcap.com/all/views/all/](https://coinmarketcap.com/all/views/all/) , [coinmarketcap.com/tokens/](https://coinmarketcap.com/tokens/) , [coinmarketcap.com/gainers-losers/](https://coinmarketcap.com/gainers-losers/) , [coinmarketcap.com/new/](https://coinmarketcap.com/new/) . _**NOTE:** Use this endpoint if you need a sorted and paginated list of all cryptocurrencies. If you want to query for market data on a few specific cryptocurrencies use [/v1/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) which is optimized for that purpose. The response data between these endpoints is otherwise the same._ ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. price\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum USD price to filter results by. price\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum USD price to filter results by. market\_cap\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum market cap to filter results by. market\_cap\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum market cap to filter results by. volume\_24h\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum 24 hour USD volume to filter results by. volume\_24h\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum 24 hour USD volume to filter results by. circulating\_supply\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum circulating supply to filter results by. circulating\_supply\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum circulating supply to filter results by. percent\_change\_24h\_min number \>= -100 Optionally specify a threshold of minimum 24 hour percent change to filter results by. percent\_change\_24h\_max number \>= -100 Optionally specify a threshold of maximum 24 hour percent change to filter results by. self\_reported\_circulating\_supply\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum self reported circulating supply to filter results by. self\_reported\_circulating\_supply\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum self reported circulating supply to filter results by. self\_reported\_market\_cap\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum self reported market cap to filter results by. self\_reported\_market\_cap\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum self reported market cap to filter results by. unlocked\_market\_cap\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum unlocked market cap to filter results by. unlocked\_market\_cap\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum unlocked market cap to filter results by. unlocked\_circulating\_supply\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum unlocked circulating supply to filter results by. unlocked\_circulating\_supply\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum unlocked circulating supply to filter results by. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. sort string "market\_cap" "name" "symbol" "date\_added" "market\_cap" "market\_cap\_strict" "price" "circulating\_supply" "total\_supply" "max\_supply" "num\_market\_pairs" "volume\_24h" "percent\_change\_1h" "percent\_change\_24h" "percent\_change\_7d" "market\_cap\_by\_total\_supply\_strict" "volume\_7d" "volume\_30d" What field to sort the list of cryptocurrencies by. sort\_dir string "asc" "desc" The direction in which to order cryptocurrencies against the specified sort. cryptocurrency\_type string "all" "all" "coins" "tokens" The type of cryptocurrency to include. tag string "all" "all" "defi" "filesharing" The tag of cryptocurrency to include. aux string "num\_market\_pairs,cmc\_rank,date\_added,tags,platform,max\_supply,circulating\_supply,total\_supply" ^(num\_market\_pairs|cmc\_rank|date\_added|tags|platform|max\_supply|circulating\_supply|total\_supply|market\_cap\_by\_total\_supply|volume\_24h\_reported|volume\_7d|volume\_7d\_reported|volume\_30d|volume\_30d\_reported|is\_market\_cap\_included\_in\_calc)+(?:,(num\_market\_pairs|cmc\_rank|date\_added|tags|platform|max\_supply|circulating\_supply|total\_supply|market\_cap\_by\_total\_supply|volume\_24h\_reported|volume\_7d|volume\_7d\_reported|volume\_30d|volume\_30d\_reported|is\_market\_cap\_included\_in\_calc)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply,market_cap_by_total_supply,volume_24h_reported,volume_7d,volume_7d_reported,volume_30d,volume_30d_reported,is_market_cap_included_in_calc` to include all auxiliary fields. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Listings%20Latest%20-%20Cryptocurrency%20object%201 Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/listings/latest Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "infinite\_supply": false,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "self\_reported\_circulating\_supply": null,\ \ * "self\_reported\_market\_cap": null,\ \ * "minted\_market\_cap": 1802955697670.94,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 852164659250.2758,\ \ * "market\_cap\_dominance": 51,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "volume\_change\_24h": 0,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "market\_cap\_dominance": 12,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "infinite\_supply": false,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "minted\_market\_cap": 364793475572.53,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "market\_cap\_dominance": 51,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "market\_cap\_dominance": 12,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsNew) Listings New --------------------------------------------------------------------------------------------------------- Returns a paginated list of most recently added cryptocurrencies. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our "new" cryptocurrency page [coinmarketcap.com/new/](https://coinmarketcap.com/new) _**NOTE:** Use this endpoint if you need a sorted and paginated list of all recently added cryptocurrencies._ ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. sort\_dir string "asc" "desc" The direction in which to order cryptocurrencies against the specified sort. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Listings%20Latest%20-%20Cryptocurrency%20object%202 Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/listings/new Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/new * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "minted\_market\_cap": 1802955697670.94,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 852164659250.2758,\ \ * "market\_cap\_dominance": 51,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "volume\_change\_24h": 0,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "market\_cap\_dominance": 12,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "minted\_market\_cap": 364793475572.53,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "market\_cap\_dominance": 51,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "market\_cap\_dominance": 12,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainerslosers) Trending Gainers & Losers -------------------------------------------------------------------------------------------------------------------------------- Returns a paginated list of all trending cryptocurrencies, determined and sorted by the largest price gains or losses. You may sort against any of the following: **percent\_change\_24h**: 24 hour trading price percentage change for each currency. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 10 minutes. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our cryptocurrency Gainers & Losers page [coinmarketcap.com/gainers-losers/](https://coinmarketcap.com/gainers-losers/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 1000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. time\_period string "24h" "1h" "24h" "30d" "7d" Adjusts the overall window of time for the biggest gainers and losers. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. sort string "percent\_change\_24h" "percent\_change\_24h" What field to sort the list of cryptocurrencies by. sort\_dir string "asc" "desc" The direction in which to order cryptocurrencies against the specified sort. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20-%20Cryptocurrency%20object Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/trending/gainers-losers Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/gainers-losers * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) Trending Latest --------------------------------------------------------------------------------------------------------------- Returns a paginated list of all trending cryptocurrency market data, determined and sorted by CoinMarketCap search volume. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 10 minutes. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our cryptocurrency Trending page [coinmarketcap.com/trending-cryptocurrencies/](https://coinmarketcap.com/trending-cryptocurrencies/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 1000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. time\_period string "24h" "24h" "30d" "7d" Adjusts the overall window of time for the latest trending coins. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Trending%20Latest%20-%20Cryptocurrency%20object Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/trending/latest Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "is\_active": true,\ \ * "is\_fiat": 0,\ \ * "self\_reported\_circulating\_supply": null,\ \ * "self\_reported\_market\_cap": null,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostvisited) Trending Most Visited -------------------------------------------------------------------------------------------------------------------------- Returns a paginated list of all trending cryptocurrency market data, determined and sorted by traffic to coin detail pages. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 24 hours. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** The CoinMarketCap “Most Visited” trending list. [coinmarketcap.com/most-viewed-pages/](https://coinmarketcap.com/most-viewed-pages/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 1000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. time\_period string "24h" "24h" "30d" "7d" Adjusts the overall window of time for most visited currencies. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20-%20Cryptocurrency%20object Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/trending/most-visited Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/most-visited * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyMarketpairsLatest) Market Pairs Latest v2 ------------------------------------------------------------------------------------------------------------------------- Lists all active market pairs that CoinMarketCap tracks for a given cryptocurrency or fiat currency. All markets with this currency as the pair base _or_ pair quote will be returned. 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. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * ~Startup~ * Standard * Professional * Enterprise **Cache / Update frequency:** Every 1 minute. **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 active cryptocurrency markets pages like [coinmarketcap.com/currencies/bitcoin/#markets](https://coinmarketcap.com/currencies/bitcoin/#markets) . ##### Parameters id string A cryptocurrency or fiat currency by CoinMarketCap ID to list market pairs for. Example: "1" slug string ^\[0-9a-z-\]\*$ Alternatively pass a cryptocurrency by slug. Example: "bitcoin" symbol string ^\[0-9A-Za-z$@\\-\]\*$ Alternatively pass a cryptocurrency by symbol. Fiat currencies are not supported by this field. Example: "BTC". A single cryptocurrency "id", "slug", _or_ "symbol" is required. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. sort\_dir string "desc" "asc" "desc" Optionally specify the sort direction of markets returned. sort string "volume\_24h\_strict" "volume\_24h\_strict" "cmc\_rank" "cmc\_rank\_advanced" "effective\_liquidity" "market\_score" "market\_reputation" Optionally specify the sort order of markets returned. By default we return a strict sort on 24 hour reported volume. Pass `cmc_rank` to return a CMC methodology based sort where markets with excluded volumes are returned last. aux string "num\_market\_pairs,category,fee\_type" ^(num\_market\_pairs|category|fee\_type|market\_url|currency\_name|currency\_slug|price\_quote|notice|cmc\_rank|effective\_liquidity|market\_score|market\_reputation)+(?:,(num\_market\_pairs|category|fee\_type|market\_url|currency\_name|currency\_slug|price\_quote|notice|cmc\_rank|effective\_liquidity|market\_score|market\_reputation)+)\*$ 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,notice,cmc_rank,effective_liquidity,market_score,market_reputation` to include all auxiliary fields. matched\_id string ^\\d+(?:,\\d+)\*$ Optionally include one or more fiat or cryptocurrency IDs to filter market pairs by. For example `?id=1&matched_id=2781` would only return BTC markets that matched: "BTC/USD" or "USD/BTC". This parameter cannot be used when `matched_symbol` is used. matched\_symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Optionally include one or more fiat or cryptocurrency symbols to filter market pairs by. For example `?symbol=BTC&matched_symbol=USD` would only return BTC markets that matched: "BTC/USD" or "USD/BTC". This parameter cannot be used when `matched_id` is used. category string "all" "all" "spot" "derivatives" "otc" "perpetual" The category of trading this market falls under. Spot markets are the most common but options include derivatives and OTC. fee\_type string "all" "all" "percentage" "no-fees" "transactional-mining" "unknown" The fee type the exchange enforces for this market. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Market%20Pairs%20Latest%20-%20Results%20object Required

Results of your query returned as an object. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/market-pairs/latest Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/market-pairs/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "num\_market\_pairs": 7526, * "market\_pairs": \[\ \ * {\ \ * "exchange": \ \ {\ \ * "id": 157,\ \ * "name": "BitMEX",\ \ * "slug": "bitmex"\ \ \ },\ \ * "market\_id": 4902,\ \ * "market\_pair": "BTC/USD",\ \ * "category": "derivatives",\ \ * "fee\_type": "no-fees",\ \ * "market\_pair\_base": \ \ {\ \ * "currency\_id": 1,\ \ * "currency\_symbol": "BTC",\ \ * "exchange\_symbol": "XBT",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "market\_pair\_quote": \ \ {\ \ * "currency\_id": 2781,\ \ * "currency\_symbol": "USD",\ \ * "exchange\_symbol": "USD",\ \ * "currency\_type": "fiat"\ \ \ },\ \ * "quote": \ \ {\ \ * "exchange\_reported": \ \ {\ \ * "price": 7839,\ \ * "volume\_24h\_base": 434215.85308502,\ \ * "volume\_24h\_quote": 3403818072.33347,\ \ * "last\_updated": "2019-05-24T02:39:00.000Z"\ \ \ },\ \ * "USD": \ \ {\ \ * "price": 7839,\ \ * "volume\_24h": 3403818072.33347,\ \ * "last\_updated": "2019-05-24T02:39:00.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "exchange": \ \ {\ \ * "id": 108,\ \ * "name": "Negocie Coins",\ \ * "slug": "negocie-coins"\ \ \ },\ \ * "market\_id": 3377,\ \ * "market\_pair": "BTC/BRL",\ \ * "category": "spot",\ \ * "fee\_type": "percentage",\ \ * "market\_pair\_base": \ \ {\ \ * "currency\_id": 1,\ \ * "currency\_symbol": "BTC",\ \ * "exchange\_symbol": "BTC",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "market\_pair\_quote": \ \ {\ \ * "currency\_id": 2783,\ \ * "currency\_symbol": "BRL",\ \ * "exchange\_symbol": "BRL",\ \ * "currency\_type": "fiat"\ \ \ },\ \ * "quote": \ \ {\ \ * "exchange\_reported": \ \ {\ \ * "price": 33002.11,\ \ * "volume\_24h\_base": 336699.03559957,\ \ * "volume\_24h\_quote": 11111778609.7509,\ \ * "last\_updated": "2019-05-24T02:39:00.000Z"\ \ \ },\ \ * "USD": \ \ {\ \ * "price": 8165.02539531659,\ \ * "volume\_24h": 2749156176.2491,\ \ * "last\_updated": "2019-05-24T02:39:00.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvHistorical) OHLCV Historical v2 -------------------------------------------------------------------------------------------------------------------- Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any cryptocurrency using time interval parameters. Currently daily and hourly OHLCV periods are supported. Volume is not currently supported for hourly OHLCV intervals before 2020-09-22. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **Technical Notes** * Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time for this "time\_period". * One OHLCV quote will be returned for every "time\_period" between your "time\_start" (exclusive) and "time\_end" (inclusive). * If a "time\_start" is not supplied, the "time\_period" will be calculated in reverse from "time\_end" using the "count" parameter which defaults to 10 results. * If "time\_end" is not supplied, it defaults to the current time. * If you don't need every "time\_period" between your dates you may adjust the frequency that "time\_period" is sampled using the "interval" parameter. For example with "time\_period" set to "daily" you may set "interval" to "2d" to get the daily OHLCV for every other day. You could set "interval" to "monthly" to get the first daily OHLCV for each month, or set it to "yearly" to get the daily OHLCV value against the same date every year. **Implementation Tips** * If querying for a specific OHLCV date your "time\_start" should specify a timestamp of 1 interval prior as "time\_start" is an exclusive time parameter (as opposed to "time\_end" which is inclusive to the search). This means that when you pass a "time\_start" results will be returned for the _next_ complete "time\_period". For example, if you are querying for a daily OHLCV datapoint for 2018-11-30 your "time\_start" should be "2018-11-29". * If only specifying a "count" parameter to return latest OHLCV periods, your "count" should be 1 number higher than the number of results you expect to receive. "Count" defines the number of "time\_period" intervals queried, _not_ the number of results to return, and this includes the currently active time period which is incomplete when working backwards from current time. For example, if you want the last daily OHLCV value available simply pass "count=2" to skip the incomplete active time period. * This endpoint supports requesting multiple cryptocurrencies 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 "time\_period" and "interval" parameters. For "time\_period" these return aggregate OHLCV data from the beginning to end of each interval period. Apply these time intervals to "interval" to adjust how frequently "time\_period" is sampled. The first are calendar year and time constants in UTC time: **"hourly"** - Hour intervals in UTC. **"daily"** - Calendar day intervals for each UTC day. **"weekly"** - Calendar week intervals for each calendar week. **"monthly"** - Calendar month intervals for each calendar month. **"yearly"** - Calendar year intervals for each calendar year. The second are relative time intervals. **"h"**: Get the first quote available every "h" hours (3600 second intervals). Supported hour intervals are: "1h", "2h", "3h", "4h", "6h", "12h". **"d"**: Time periods that repeat every "d" days (86400 second intervals). Supported day intervals are: "1d", "2d", "3d", "7d", "14d", "15d", "30d", "60d", "90d", "365d". Please note that "time\_period" currently supports the "daily" and "hourly" options. "interval" supports all interval options. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * Startup (1 month) * Standard (3 months) * Professional (12 months) * Enterprise (Up to 6 years) **Cache / Update frequency:** Latest Daily OHLCV record is available ~5 to ~10 minutes after each midnight UTC. The latest hourly OHLCV record is available 5 minutes after each UTC hour. **Plan credit use:** 1 call credit per 100 OHLCV data points returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our historical cryptocurrency data pages like [coinmarketcap.com/currencies/bitcoin/historical-data/](https://coinmarketcap.com/currencies/bitcoin/historical-data/) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,1027" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "slug" _or_ "symbol" is required for this request. time\_period string "daily" "daily" "hourly" Time period to return OHLCV data for. The default is "daily". If hourly, the open will be 01:00 and the close will be 01:59. If daily, the open will be 00:00:00 for the day and close will be 23:59:99 for the same day. See the main endpoint description for details. time\_start string Timestamp (Unix or ISO 8601) to start returning OHLCV time periods for. Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time. time\_end string Timestamp (Unix or ISO 8601) to stop returning OHLCV time periods for (inclusive). Optional, if not passed we'll default to the current time. Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time. count number \[ 1 .. 10000 \] 10 Optionally limit the number of time periods to return results for. The default is 10 items. The current query limit is 10000 items. interval string "daily" "hourly" "daily" "weekly" "monthly" "yearly" "1h" "2h" "3h" "4h" "6h" "12h" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d" Optionally adjust the interval that "time\_period" is sampled. For example with interval=monthly&time\_period=daily you will see a daily OHLCV record for January, February, March and so on. See main endpoint description for available options. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ By default market quotes are returned in USD. Optionally calculate market quotes in up to 3 fiat currencies or cryptocurrencies. convert\_id string ^\\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. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if any invalid cryptocurrencies are requested or a cryptocurrency does not have matching records in the requested timeframe. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20OHLCV%20Historical%20-%20Results%20object Required

Results of your query returned as an object. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/ohlcv/historical Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/ohlcv/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "quotes": \[\ \ * {\ \ * "time\_open": "2019-01-02T00:00:00.000Z",\ \ * "time\_close": "2019-01-02T23:59:59.999Z",\ \ * "time\_high": "2019-01-02T03:53:00.000Z",\ \ * "time\_low": "2019-01-02T02:43:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "open": 3849.21640853,\ \ * "high": 3947.9812729,\ \ * "low": 3817.40949569,\ \ * "close": 3943.40933686,\ \ * "volume": 5244856835.70851,\ \ * "market\_cap": 68849856731.6738,\ \ * "timestamp": "2019-01-02T23:59:59.999Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "time\_open": "2019-01-03T00:00:00.000Z",\ \ * "time\_close": "2019-01-03T23:59:59.999Z",\ \ * "time\_high": "2019-01-02T03:53:00.000Z",\ \ * "time\_low": "2019-01-02T02:43:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "open": 3931.04863841,\ \ * "high": 3935.68513083,\ \ * "low": 3826.22287069,\ \ * "close": 3836.74131867,\ \ * "volume": 4530215218.84018,\ \ * "market\_cap": 66994920902.7202,\ \ * "timestamp": "2019-01-03T23:59:59.999Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvLatest) OHLCV Latest v2 ------------------------------------------------------------------------------------------------------------ Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more cryptocurrencies for the current UTC day. Since the current UTC day is still active these values are updated frequently. You can find the final calculated OHLCV values for the last completed UTC day along with all historic days using /cryptocurrency/ohlcv/historical. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 10 minutes. Additional OHLCV intervals and 1 minute updates will be available in the future. **Plan credit use:** 1 call credit per 100 OHLCV values 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. ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2 symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "symbol" is required. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if any invalid cryptocurrencies are requested or a cryptocurrency does not have matching records in the requested timeframe. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20OHLCV%20Latest%20-%20Cryptocurrency%20Results%20map Required

A map of cryptocurrency objects by ID or symbol (as passed in query parameters). | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/ohlcv/latest Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/ohlcv/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "1": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "last\_updated": "2018-09-10T18:54:00.000Z", * "time\_open": "2018-09-10T00:00:00.000Z", * "time\_close": null, * "time\_high": "2018-09-10T00:00:00.000Z", * "time\_low": "2018-09-10T00:00:00.000Z", * "quote": { * "USD": { * "open": 6301.57, * "high": 6374.98, * "low": 6292.76, * "close": 6308.76, * "volume": 3786450000, * "last\_updated": "2018-09-10T18:54:00.000Z" } } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyPriceperformancestatsLatest) Price Performance Stats v2 --------------------------------------------------------------------------------------------------------------------------------------- Returns price performance statistics for one or more cryptocurrencies including launch price ROI and all-time high / all-time low. Stats are returned for an `all_time` period by default. UTC `yesterday` and a number of _rolling time periods_ may be requested using the `time_period` parameter. Utilize the `convert` parameter to translate values into multiple fiats or cryptocurrencies using historical rates. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** The statistics module displayed on cryptocurrency pages like [Bitcoin](https://coinmarketcap.com/currencies/bitcoin/) . _**NOTE:** You may also use [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) for traditional OHLCV data at historical daily and hourly intervals. You may also use [/v1/cryptocurrency/ohlcv/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvLatest) for OHLCV data for the current UTC day._ ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2 slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "slug" _or_ "symbol" is required for this request. time\_period string "all\_time" ^(all\_time|yesterday|24h|7d|30d|90d|365d)+(?:,(all\_time|yesterday|24h|7d|30d|90d|365d)+)\*$ Specify one or more comma-delimited time periods to return stats for. `all_time` is the default. Pass `all_time,yesterday,24h,7d,30d,90d,365d` to return all supported time periods. All rolling periods have a rolling close time of the current request time. For example `24h` would have a close time of now and an open time of 24 hours before now. _Please note: `yesterday` is a UTC period and currently does not currently support `high` and `low` timestamps._ convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Optionally calculate 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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\d+(?:,\\d+)\*$ Optionally calculate 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. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Price%20Performance%20Stats%20Latest%20-%20Cryptocurrency%20Results%20map Required

An object map of cryptocurrency objects by ID, slug, or symbol (as used in query parameters). | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/price-performance-stats/latest Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/price-performance-stats/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "1": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "slug": "bitcoin", * "last\_updated": "2019-08-22T01:51:32.000Z", * "periods": { * "all\_time": { * "open\_timestamp": "2013-04-28T00:00:00.000Z", * "high\_timestamp": "2017-12-17T12:19:14.000Z", * "low\_timestamp": "2013-07-05T18:56:01.000Z", * "close\_timestamp": "2019-08-22T01:52:18.613Z", * "quote": { * "USD": { * "open": 135.3000030517578, * "open\_timestamp": "2013-04-28T00:00:00.000Z", * "high": 20088.99609375, * "high\_timestamp": "2017-12-17T12:19:14.000Z", * "low": 65.5260009765625, * "low\_timestamp": "2013-07-05T18:56:01.000Z", * "close": 65.5260009765625, * "close\_timestamp": "2019-08-22T01:52:18.618Z", * "percent\_change": 7223.718930042746, * "price\_change": 9773.691932798241 } } } } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesHistorical) Quotes Historical v2 ---------------------------------------------------------------------------------------------------------------------- Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **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. **Implementation Tips** * Want to get the last quote of each UTC day? Don't use "interval=daily" as that returns the first quote. Instead use "interval=24h" to repeat a specific timestamp search every 24 hours and pass ex. "time\_start=2019-01-04T23:59:00.000Z" to query for the last record of each UTC day. * This endpoint supports requesting multiple cryptocurrencies 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * Hobbyist (1 month) * Startup (1 month) * Standard (3 month) * Professional (12 months) * Enterprise (Up to 6 years) **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:** Our historical cryptocurrency charts like [coinmarketcap.com/currencies/bitcoin/#charts](https://coinmarketcap.com/currencies/bitcoin/#charts) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "symbol" is required for this request. time\_start string Timestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time\_end". time\_end string Timestamp (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. count number \[ 1 .. 10000 \] 10 The 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. interval string "5m" "yearly" "monthly" "weekly" "daily" "hourly" "5m" "10m" "15m" "30m" "45m" "1h" "2h" "3h" "4h" "6h" "12h" "24h" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d" Interval of time to return data points for. See details in endpoint description. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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 string (^\\d+(?:,\\d+)\*$|(\\d,)\*PLATFORM\_ID+(?:,\\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 string "price,volume,market\_cap,circulating\_supply,total\_supply,quote\_timestamp,is\_active,is\_fiat" ^(price|volume|market\_cap|circulating\_supply|total\_supply|quote\_timestamp|is\_active|is\_fiat|search\_interval)+(?:,(price|volume|market\_cap|circulating\_supply|total\_supply|quote\_timestamp|is\_active|is\_fiat|search\_interval)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `price,volume,market_cap,circulating_supply,total_supply,quote_timestamp,is_active,is_fiat,search_interval` to include all auxiliary fields. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Quotes%20Historical%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/quotes/historical Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "is\_active": 1, * "is\_fiat": 0, * "quotes": \[\ \ * {\ \ * "timestamp": "2018-06-22T19:29:37.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 6242.29,\ \ * "volume\_24h": 4681670000,\ \ * "market\_cap": 106800038746.48,\ \ * "circulating\_supply": 4681670000,\ \ * "total\_supply": 4681670000,\ \ * "timestamp": "2018-06-22T19:29:37.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "timestamp": "2018-06-22T19:34:33.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 6242.82,\ \ * "volume\_24h": 4682330000,\ \ * "market\_cap": 106809106575.84,\ \ * "circulating\_supply": 4681670000,\ \ * "total\_supply": 4681670000,\ \ * "timestamp": "2018-06-22T19:34:33.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) Quotes Latest v2 -------------------------------------------------------------------------------------------------------------- Returns the latest market quote for 1 or more cryptocurrencies. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Basic * Startup * Hobbyist * Standard * Professional * Enterprise **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Latest market data pages for specific cryptocurrencies like [coinmarketcap.com/currencies/bitcoin/](https://coinmarketcap.com/currencies/bitcoin/) . _**NOTE:** Use this endpoint to request the latest quote for specific cryptocurrencies. If you need to request all cryptocurrencies use [/v1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) which is optimized for that purpose. The response data between these endpoints is otherwise the same._ ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2 slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "slug" _or_ "symbol" is required for this request. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string (^\\d+(?:,\\d+)\*$|(\\d,)\*PLATFORM\_ID+(?:,\\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 string "num\_market\_pairs,cmc\_rank,date\_added,tags,platform,max\_supply,circulating\_supply,total\_supply,is\_active,is\_fiat" ^(num\_market\_pairs|cmc\_rank|date\_added|tags|platform|max\_supply|circulating\_supply|total\_supply|market\_cap\_by\_total\_supply|volume\_24h\_reported|volume\_7d|volume\_7d\_reported|volume\_30d|volume\_30d\_reported|is\_active|is\_fiat)+(?:,(num\_market\_pairs|cmc\_rank|date\_added|tags|platform|max\_supply|circulating\_supply|total\_supply|market\_cap\_by\_total\_supply|volume\_24h\_reported|volume\_7d|volume\_7d\_reported|volume\_30d|volume\_30d\_reported|is\_active|is\_fiat)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply,market_cap_by_total_supply,volume_24h_reported,volume_7d,volume_7d_reported,volume_30d,volume_30d_reported,is_active,is_fiat` to include all auxiliary fields. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Quotes%20Latest%20-%20Cryptocurrency%20Results%20map Required

A map of cryptocurrency objects by ID, symbol, or slug (as used in query parameters). | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/quotes/latest Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "1": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "slug": "bitcoin", * "is\_active": 1, * "is\_fiat": 0, * "circulating\_supply": 17199862, * "total\_supply": 17199862, * "max\_supply": 21000000, * "date\_added": "2013-04-28T00:00:00.000Z", * "num\_market\_pairs": 331, * "cmc\_rank": 1, * "last\_updated": "2018-08-09T21:56:28.000Z", * "tags": \[\ \ * "mineable"\ \ \ \], * "platform": null, * "self\_reported\_circulating\_supply": null, * "self\_reported\_market\_cap": null, * "minted\_market\_cap": 1802955697670.94, * "quote": { * "USD": { * "price": 6602.60701122, * "volume\_24h": 4314444687.5194, * "volume\_change\_24h": \-0.152774, * "percent\_change\_1h": 0.988615, * "percent\_change\_24h": 4.37185, * "percent\_change\_7d": \-12.1352, * "percent\_change\_30d": \-12.1352, * "market\_cap": 852164659250.2758, * "market\_cap\_dominance": 51, * "fully\_diluted\_market\_cap": 952835089431.14, * "last\_updated": "2018-08-09T21:56:28.000Z" } } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV3CryptocurrencyQuotesHistorical) Quotes Historical v3 ---------------------------------------------------------------------------------------------------------------------- Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters. **Please note**: This documentation relates to our updated V3 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **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. **Implementation Tips** * Want to get the last quote of each UTC day? Don't use "interval=daily" as that returns the first quote. Instead use "interval=24h" to repeat a specific timestamp search every 24 hours and pass ex. "time\_start=2019-01-04T23:59:00.000Z" to query for the last record of each UTC day. * This endpoint supports requesting multiple cryptocurrencies 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * Hobbyist (1 month) * Startup (1 month) * Standard (3 month) * Professional (12 months) * Enterprise (Up to 6 years) **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:** Our historical cryptocurrency charts like [coinmarketcap.com/currencies/bitcoin/#charts](https://coinmarketcap.com/currencies/bitcoin/#charts) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "symbol" is required for this request. time\_start string Timestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time\_end". time\_end string Timestamp (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. count number \[ 1 .. 10000 \] 10 The 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. interval string "5m" "yearly" "monthly" "weekly" "daily" "hourly" "5m" "10m" "15m" "30m" "45m" "1h" "2h" "3h" "4h" "6h" "12h" "24h" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d" Interval of time to return data points for. See details in endpoint description. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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 string (^\\d+(?:,\\d+)\*$|(\\d,)\*PLATFORM\_ID+(?:,\\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 string "price,volume,market\_cap,circulating\_supply,total\_supply,quote\_timestamp,is\_active,is\_fiat" ^(price|volume|market\_cap|circulating\_supply|total\_supply|quote\_timestamp|is\_active|is\_fiat|search\_interval)+(?:,(price|volume|market\_cap|circulating\_supply|total\_supply|quote\_timestamp|is\_active|is\_fiat|search\_interval)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `price,volume,market_cap,circulating_supply,total_supply,quote_timestamp,is_active,is_fiat,search_interval` to include all auxiliary fields. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Quotes%20Historical%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v3/cryptocurrency/quotes/historical Server URL https://pro-api.coinmarketcap.com/v3/cryptocurrency/quotes/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "is\_active": 1, * "is\_fiat": 0, * "quotes": \[\ \ * {\ \ * "timestamp": "2018-06-22T19:29:37.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 6242.29,\ \ * "volume\_24h": 4681670000,\ \ * "market\_cap": 106800038746.48,\ \ * "circulating\_supply": 4681670000,\ \ * "total\_supply": 4681670000,\ \ * "timestamp": "2018-06-22T19:29:37.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "timestamp": "2018-06-22T19:34:33.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 6242.82,\ \ * "volume\_24h": 4682330000,\ \ * "market\_cap": 106809106575.84,\ \ * "circulating\_supply": 4681670000,\ \ * "total\_supply": 4681670000,\ \ * "timestamp": "2018-06-22T19:34:33.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#tag/DexScan) DexScan ======================================================================= ##### The on-chain data API is currently undergoing an upgrade. Out of the original eight endpoints, only the following two will remain available. We sincerely apologize if you are using any of the soon-to-be deprecated endpoints. * [/v4/dex/spot-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV4DexSpotpairsLatest) - Latest listings of pairs * [/v4/dex/pairs/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV4DexPairsQuotesLatest) - Latest quotes The upgraded APIs will be available to serve you shortly. If you have any questions, please feel free to contact our customer service team. Thank you. [](https://coinmarketcap.com/api/documentation/v1/#operation/getLatestPairsQuotes) Quotes Latest ------------------------------------------------------------------------------------------------ Returns the latest market quote for 1 or more spot pairs. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call. ##### Parameters contract\_address string One or more comma-separated contract addresses. network\_id string One or more CoinMarketCap cryptocurrency network ids network\_slug string Alternatively, one network names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens). aux string Default:`""` Valid values: `"pool_created"` `"percent_pooled_base_asset"` `"num_transactions_24h"` `"pool_base_asset"` `"pool_quote_asset"` `"24h_volume_quote_asset"` `"total_supply_quote_asset"` `"total_supply_base_asset"` `"holders"` `"buy_tax"` `"sell_tax"` `"security_scan"` `"24h_no_of_buys"` `"24h_no_of_sells"` `"24h_buy_volume"` `"24h_sell_volume"` Optionally specify a comma-separated list of supplemental data fields to return. convert\_id string 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. skip\_invalid string Pass true to relax request validation rules. When requesting records on multiple spot pairs an error is returned if no match is found for 1 or more requested spot pairs. If set to true, invalid lookups will be skipped allowing valid spot pairs to still be returned. reverse\_order string Pass true to invert the order of a spot pair. For example, a trading pair is set up as Token B/Token A in the contract and is commonly referred to as Token A/Token B. Using reverse\_order would change the order to reflect the true Token B/Token A pairing as it exists in the pool. Responses --------- 200 OK | | | | --- | --- | | 24h\_no\_of\_buys null | integer

Number of asset buys in the past 24 hours | | | | | 24h\_no\_of\_sells null | integer

Number of asset sells in the past 24 hours | | | | | 24h\_volume\_quote\_asset null | number

24 hours volume of the quote asset | | | | | base\_asset\_contract\_address null | string

The contract addres of this base asset in the spot pair. | | | | | base\_asset\_id null | string

The id of this base asset in the spot pair. | | | | | base\_asset\_name null | string

The name of this base asset in the spot pair. | | | | | base\_asset\_symbol null | string

The symbol of this base asset in the spot pair. | | | | | base\_asset\_ucid null | string

The ucid of this base asset in the spot pair. | | | | | buy\_tax null | number

Buy tax on the asset | | | | | contract\_address null | string

The unique contract address for this spot pair. | | | | | created\_at null | string

Timestamp (ISO 8601) when we started tracking this asset. | | | | | date\_launched null | string

Timestamp (ISO 8601) of the launch date for this exchange. | | | | | dex\_id null | string

The id of this dex the spot pair is on. | | | | | dex\_slug null | string

The name of this dex the spot pair is on. | | | | | holders null | integer

Number of holders of the asset | | | | | last\_updated null | string

Timestamp (ISO 8601) of the last time this record was updated. | | | | | name null | string

The name of this spot pair. | | | | | network\_id null | string

The id of the network the spot pair is on. | | | | | network\_slug null | string

The slug of the network the spot pair is on. | | | | | num\_transactions\_24h null | integer

Number of transactions in past 24 hours | | | | | percent\_pooled\_base\_asset null | number

Percentage of the base asset in the pool | | | | | pool\_base\_asset null | number

Base asset in the pool | | | | | pool\_created null | string

When the pool of the asset was created | | | | | pool\_quote\_asset null | number

Quote asset in the pool | | | | | quote null | DexQuoteDTO

A map of market quotes in different currency conversions. The default map included is USD. | | | | | quote\_asset\_contract\_address null | string

The contract addresss of this quote asset in the spot pair. | | | | | quote\_asset\_id null | string

The id of this quote asset in the spot pair. | | | | | quote\_asset\_name null | string

The name of this quote asset in the spot pair. | | | | | quote\_asset\_symbol null | string

The symbol of this quote asset in the spot pair. | | | | | quote\_asset\_ucid null | string

The ucid of this quote asset in the spot pair. | | | | | security\_scan null | SecurityScanResult

Security scan by Go+.

All infomation and data relating to contract detection are based on public third party information. CoinMarketCap does not confirm or verify the accuracy or timeliness of such information and data.

CoinMarketCap shall have no responsibility or liability for the accuracy of data, nor 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.

Only returned if passed in aux. | | | | | sell\_tax null | number

Sell tax on the asset | | | | | total\_supply\_base\_asset null | number

Total supply of the quote asset | | | | | total\_supply\_quote\_asset null | number

Total supply of the quote asset | | | | 400 Bad Request ##### get /v4/dex/pairs/quotes/latest Server URL https://pro-api.coinmarketcap.com/v4/dex/pairs/quotes/latest * 200 OK Copy Expand all Collapse all \[\ \ * {\ \ * "24h\_no\_of\_buys": 0,\ \ * "24h\_no\_of\_sells": 0,\ \ * "24h\_volume\_quote\_asset": 0,\ \ * "base\_asset\_contract\_address": "string",\ \ * "base\_asset\_id": "string",\ \ * "base\_asset\_name": "string",\ \ * "base\_asset\_symbol": "string",\ \ * "base\_asset\_ucid": "string",\ \ * "buy\_tax": 0,\ \ * "contract\_address": "string",\ \ * "created\_at": "2025-12-23T17:31:50Z",\ \ * "date\_launched": "2025-12-23T17:31:50Z",\ \ * "dex\_id": "string",\ \ * "dex\_slug": "string",\ \ * "holders": 0,\ \ * "last\_updated": "2025-12-23T17:31:50Z",\ \ * "name": "string",\ \ * "network\_id": "string",\ \ * "network\_slug": "string",\ \ * "num\_transactions\_24h": 0,\ \ * "percent\_pooled\_base\_asset": 0,\ \ * "pool\_base\_asset": 0,\ \ * "pool\_created": "2025-12-23T17:31:50Z",\ \ * "pool\_quote\_asset": 0,\ \ * "quote": \ \ \[\ \ * {\ \ * "24h\_buy\_volume": 0,\ \ * "24h\_sell\_volume": 0,\ \ * "convert\_id": "string",\ \ * "fully\_diluted\_value": 0,\ \ * "last\_updated": "string",\ \ * "liquidity": 0,\ \ * "percent\_change\_price\_1h": 0,\ \ * "percent\_change\_price\_24h": 0,\ \ * "price": 0,\ \ * "price\_by\_quote\_asset": 0,\ \ * "volume\_24h": 0\ \ \ }\ \ \ \],\ \ * "quote\_asset\_contract\_address": "string",\ \ * "quote\_asset\_id": "string",\ \ * "quote\_asset\_name": "string",\ \ * "quote\_asset\_symbol": "string",\ \ * "quote\_asset\_ucid": "string",\ \ * "security\_scan": \ \ \[\ \ * {\ \ * "aggregated": \ \ {\ \ * "contract\_verified": true,\ \ * "honeypot": true\ \ \ },\ \ * "third\_party": \ \ {\ \ * "airdrop\_scam": true,\ \ * "anti\_whale": true,\ \ * "anti\_whale\_modifiable": true,\ \ * "blacklisted": true,\ \ * "can\_take\_back\_ownership": true,\ \ * "cannot\_buy": true,\ \ * "cannot\_sell\_all": true,\ \ * "external\_call": true,\ \ * "hidden\_owner": true,\ \ * "honeypot": true,\ \ * "in\_dex": true,\ \ * "mintable": true,\ \ * "open\_source": true,\ \ * "owner\_change\_balance": true,\ \ * "personal\_slippage\_modifiable": true,\ \ * "proxy": true,\ \ * "self\_destruct": true,\ \ * "slippage\_modifiable": true,\ \ * "trading\_cool\_down": true,\ \ * "transfer\_pausable": true,\ \ * "true\_token": true,\ \ * "trust\_list": true,\ \ * "whitelisted": true\ \ \ }\ \ \ }\ \ \ \],\ \ * "sell\_tax": 0,\ \ * "total\_supply\_base\_asset": 0,\ \ * "total\_supply\_quote\_asset": 0\ \ \ }\ \ \ \] [](https://coinmarketcap.com/api/documentation/v1/#operation/getSpotPairsLatest) Pairs Listings Latest ------------------------------------------------------------------------------------------------------ Returns a paginated list of all active dex spot pairs with latest market data. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call. ##### Parameters network\_id string One or more comma-separated CoinMarketCap cryptocurrency network ids. network\_slug string Alternatively, one or more comma-separated network names in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required. dex\_id string One or more comma-separated CoinMarketCap dex exchange ids dex\_slug string Alternatively, one or more comma-separated dex exchange names in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required. base\_asset\_id string One or more comma-separated CoinMarketCap cryptocurrency ids. base\_asset\_symbol string Alternatively, one or more comma-separated network symbol in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens).At least one id or slug is required. base\_asset\_contract\_address string Alternatively, one base asset contract address in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens).At least one id or slug is required. base\_asset\_ucid string One or more comma-separated CoinMarketCap cryptocurrency IDs. quote\_asset\_id string One or more comma-separated CoinMarketCap cryptocurrency ids. quote\_asset\_symbol string Alternatively, one or more comma-separated network symbol in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required. quote\_asset\_contract\_address string Alternatively, one quote asset contract address in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required. quote\_asset\_ucid string One or more comma-separated CoinMarketCap cryptocurrency IDs. scroll\_id string After your initial query, the API responds with the initial set of results and a scroll\_ids. To retrieve the next set of results, provide this scroll\_id of the last JSON with your follow-up request. scroll\_id is an alternative to traditional pagination techniques. limit string Optionally specify the number of results to return. Use this parameter and the start parameter to determine your own pagination size. liquidity\_min string Optionally specify a threshold of minimum liquidity to filter results by. liquidity\_max string Optionally specify a threshold of maximum liquidity to filter results by. volume\_24h\_min string Optionally specify a threshold of minimum 24 hour USD volume to filter results by. volume\_24h\_max string Optionally specify a threshold of maximum 24 hour USD volume to filter results by. no\_of\_transactions\_24h\_min string Optionally specify a threshold of minimum 24h no. of transactions to filter results by. no\_of\_transactions\_24h\_max string Optionally specify a threshold of maximum 24h no. of transactions to filter results by. percent\_change\_24h\_min string Optionally specify a threshold of minimum 24 hour percent change to filter results by. percent\_change\_24h\_max string Optionally specify a threshold of maximum 24 hour percent change to filter results by. sort string Default:`"volume_24h"` Valid values: `"volume_24h"` `"liquidity"` `"no_of_transactions_24h"` `"percent_change_24h"` // todo Sort the list of dex spot pairs by. sort\_dir string Default:`"desc"` Valid values: `"desc"` `"asc"` The direction in which to order dex spot pairs against the specified sort. aux string Default:`""` Valid values: `"pool_created"` `"percent_pooled_base_asset"` `"num_transactions_24h"` `"pool_base_asset"` `"pool_quote_asset"` `"24h_volume_quote_asset"` `"total_supply_quote_asset"` `"total_supply_base_asset"` `"holders"` `"buy_tax"` `"sell_tax"` `"security_scan"` `"24h_no_of_buys"` `"24h_no_of_sells"` `"24h_buy_volume"` `"24h_sell_volume"` Optionally specify a comma-separated list of supplemental data fields to return. reverse\_order string Pass true to invert the order of a spot pair. For example, a trading pair is set up as Token B/Token A in the contract and is commonly referred to as Token A/Token B. Using reverse\_order would change the order to reflect the true Token B/Token A pairing as it exists in the pool. convert\_id string 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. Responses --------- 200 OK | | | | --- | --- | | 24h\_no\_of\_buys null | integer

Number of asset buys in the past 24 hours | | | | | 24h\_no\_of\_sells null | integer

Number of asset sells in the past 24 hours | | | | | 24h\_volume\_quote\_asset null | number

24 hours volume of the quote asset | | | | | base\_asset\_contract\_address null | string

The contract addres of this base asset in the spot pair. | | | | | base\_asset\_id null | string

The id of this base asset in the spot pair. | | | | | base\_asset\_name null | string

The name of this base asset in the spot pair. | | | | | base\_asset\_symbol null | string

The symbol of this base asset in the spot pair. | | | | | base\_asset\_ucid null | string

The ucid of this base asset in the spot pair. | | | | | buy\_tax null | number

Buy tax on the asset | | | | | contract\_address null | string

The unique contract address for this spot pair. | | | | | created\_at null | string

Timestamp (ISO 8601) when we started tracking this asset. | | | | | date\_launched null | string

Timestamp (ISO 8601) of the launch date for this exchange. | | | | | dex\_id null | string

The id of this dex the spot pair is on. | | | | | dex\_slug null | string

The name of this dex the spot pair is on. | | | | | holders null | integer

Number of holders of the asset | | | | | last\_updated null | string

Timestamp (ISO 8601) of the last time this record was updated. | | | | | name null | string

The name of this spot pair. | | | | | network\_id null | string

The id of the network the spot pair is on. | | | | | network\_slug null | string

The slug of the network the spot pair is on. | | | | | num\_transactions\_24h null | integer

Number of transactions in past 24 hours | | | | | percent\_pooled\_base\_asset null | number

Percentage of the base asset in the pool | | | | | pool\_base\_asset null | number

Base asset in the pool | | | | | pool\_created null | string

When the pool of the asset was created | | | | | pool\_quote\_asset null | number

Quote asset in the pool | | | | | quote null | DexQuoteDTO

A map of market quotes in different currency conversions. The default map included is USD. | | | | | quote\_asset\_contract\_address null | string

The contract addresss of this quote asset in the spot pair. | | | | | quote\_asset\_id null | string

The id of this quote asset in the spot pair. | | | | | quote\_asset\_name null | string

The name of this quote asset in the spot pair. | | | | | quote\_asset\_symbol null | string

The symbol of this quote asset in the spot pair. | | | | | quote\_asset\_ucid null | string

The ucid of this quote asset in the spot pair. | | | | | scroll\_id null | string

A unique identifier used to fetch the next batch of results from the next API related API call, if applicable. scroll\_id is an alternative to traditional pagingation techniques. | | | | | security\_scan null | SecurityScanResult

Security scan by Go+.

All infomation and data relating to contract detection are based on public third party information. CoinMarketCap does not confirm or verify the accuracy or timeliness of such information and data.

CoinMarketCap shall have no responsibility or liability for the accuracy of data, nor 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.

Only returned if passed in aux. | | | | | sell\_tax null | number

Sell tax on the asset | | | | | total\_supply\_base\_asset null | number

Total supply of the quote asset | | | | | total\_supply\_quote\_asset null | number

Total supply of the quote asset | | | | 400 Bad Request ##### get /v4/dex/spot-pairs/latest Server URL https://pro-api.coinmarketcap.com/v4/dex/spot-pairs/latest * 200 OK Copy Expand all Collapse all \[\ \ * {\ \ * "24h\_no\_of\_buys": 0,\ \ * "24h\_no\_of\_sells": 0,\ \ * "24h\_volume\_quote\_asset": 0,\ \ * "base\_asset\_contract\_address": "string",\ \ * "base\_asset\_id": "string",\ \ * "base\_asset\_name": "string",\ \ * "base\_asset\_symbol": "string",\ \ * "base\_asset\_ucid": "string",\ \ * "buy\_tax": 0,\ \ * "contract\_address": "string",\ \ * "created\_at": "2025-12-23T17:31:50Z",\ \ * "date\_launched": "2025-12-23T17:31:50Z",\ \ * "dex\_id": "string",\ \ * "dex\_slug": "string",\ \ * "holders": 0,\ \ * "last\_updated": "2025-12-23T17:31:50Z",\ \ * "name": "string",\ \ * "network\_id": "string",\ \ * "network\_slug": "string",\ \ * "num\_transactions\_24h": 0,\ \ * "percent\_pooled\_base\_asset": 0,\ \ * "pool\_base\_asset": 0,\ \ * "pool\_created": "2025-12-23T17:31:50Z",\ \ * "pool\_quote\_asset": 0,\ \ * "quote": \ \ \[\ \ * {\ \ * "24h\_buy\_volume": 0,\ \ * "24h\_sell\_volume": 0,\ \ * "convert\_id": "string",\ \ * "fully\_diluted\_value": 0,\ \ * "last\_updated": "string",\ \ * "liquidity": 0,\ \ * "percent\_change\_price\_1h": 0,\ \ * "percent\_change\_price\_24h": 0,\ \ * "price": 0,\ \ * "price\_by\_quote\_asset": 0,\ \ * "volume\_24h": 0\ \ \ }\ \ \ \],\ \ * "quote\_asset\_contract\_address": "string",\ \ * "quote\_asset\_id": "string",\ \ * "quote\_asset\_name": "string",\ \ * "quote\_asset\_symbol": "string",\ \ * "quote\_asset\_ucid": "string",\ \ * "scroll\_id": "string",\ \ * "security\_scan": \ \ \[\ \ * {\ \ * "aggregated": \ \ {\ \ * "contract\_verified": true,\ \ * "honeypot": true\ \ \ },\ \ * "third\_party": \ \ {\ \ * "airdrop\_scam": true,\ \ * "anti\_whale": true,\ \ * "anti\_whale\_modifiable": true,\ \ * "blacklisted": true,\ \ * "can\_take\_back\_ownership": true,\ \ * "cannot\_buy": true,\ \ * "cannot\_sell\_all": true,\ \ * "external\_call": true,\ \ * "hidden\_owner": true,\ \ * "honeypot": true,\ \ * "in\_dex": true,\ \ * "mintable": true,\ \ * "open\_source": true,\ \ * "owner\_change\_balance": true,\ \ * "personal\_slippage\_modifiable": true,\ \ * "proxy": true,\ \ * "self\_destruct": true,\ \ * "slippage\_modifiable": true,\ \ * "trading\_cool\_down": true,\ \ * "transfer\_pausable": true,\ \ * "true\_token": true,\ \ * "trust\_list": true,\ \ * "whitelisted": true\ \ \ }\ \ \ }\ \ \ \],\ \ * "sell\_tax": 0,\ \ * "total\_supply\_base\_asset": 0,\ \ * "total\_supply\_quote\_asset": 0\ \ \ }\ \ \ \] [](https://coinmarketcap.com/api/documentation/v1/#tag/exchange) exchange ========================================================================= ##### API endpoints for cryptocurrency exchanges. This category currently includes 7 endpoints: * [/v1/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) - CoinMarketCap ID map * [/v1/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) - Metadata * [/v1/exchange/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) - Latest listings * [/v1/exchange/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) - Latest quotes * [/v1/exchange/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesHistorical) - Historical quotes * [/v1/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) - Latest market pairs * [/v1/exchange/assets](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeAssets) - Exchange Assets [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeAssets) 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](https://coinmarketcap.com/api/features) :** * 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/](https://coinmarketcap.com/exchanges/binance/) ##### Parameters id string ^\\d\*$ A CoinMarketCap exchange ID. Example: 270 Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Assets%20Wallets%20-%20Response%20Model | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/assets Server URL https://pro-api.coinmarketcap.com/v1/exchange/assets * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "status": { * "timestamp": "2022-11-24T08:23:22.028Z", * "error\_code": 0, * "error\_message": null, * "elapsed": 1828, * "credit\_count": 0, * "notice": null }, * "data": \[\ \ * {\ \ * "wallet\_address": "0x5a52e96bacdabb82fd05763e25335261b270efcb",\ \ * "balance": 45000000,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 5117,\ \ * "price\_usd": 0.10241799413549,\ \ * "symbol": "OGN",\ \ * "name": "Origin Protocol"\ \ \ }\ \ \ },\ \ * {\ \ * "wallet\_address": "0xf977814e90da44bfa03b6295a0616a897441acec",\ \ * "balance": 400000000,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 5824,\ \ * "price\_usd": 0.00251174724338,\ \ * "symbol": "SLP",\ \ * "name": "Smooth Love Potion"\ \ \ }\ \ \ },\ \ * {\ \ * "wallet\_address": "0x5a52e96bacdabb82fd05763e25335261b270efcb",\ \ * "balance": 5588175,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 3928,\ \ * "price\_usd": 0.04813245442357,\ \ * "symbol": "IDEX",\ \ * "name": "IDEX"\ \ \ }\ \ \ },\ \ * {\ \ * "wallet\_address": "0x5a52e96bacdabb82fd05763e25335261b270efcb",\ \ * "balance": 125000,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 1552,\ \ * "price\_usd": 20.46545919550142,\ \ * "symbol": "MLN",\ \ * "name": "Enzyme"\ \ \ }\ \ \ },\ \ * {\ \ * "wallet\_address": "0x21a31ee1afc51d94c2efccaa2092ad1028285549",\ \ * "balance": 27241191.98,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 14806,\ \ * "price\_usd": 0.02390427295165,\ \ * "symbol": "PEOPLE",\ \ * "name": "ConstitutionDAO"\ \ \ }\ \ \ }\ \ \ \] } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) 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](https://coinmarketcap.com/api/features) :** * 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/](https://coinmarketcap.com/exchanges/binance/) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency exchange ids. Example: "1,2" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ 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 string "urls,logo,description,date\_launched,notice" ^(urls|logo|description|date\_launched|notice|status)+(?:,(urls|logo|description|date\_launched|notice|status)+)\*$ 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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchanges%20Info%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/info Server URL https://pro-api.coinmarketcap.com/v1/exchange/info * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "270": { * "id": 270, * "name": "Binance", * "slug": "binance", * "logo": "[https://s2.coinmarketcap.com/static/img/exchanges/64x64/270.png](https://s2.coinmarketcap.com/static/img/exchanges/64x64/270.png) ", * "description": "Launched in Jul-2017, Binance is a centralized exchange based in Malta.", * "date\_launched": "2017-07-14T00:00:00.000Z", * "notice": null, * "countries": \[ \], * "fiats": \[\ \ * "AED",\ \ * "USD"\ \ \ \], * "tags": null, * "type": "", * "maker\_fee": 0.02, * "taker\_fee": 0.04, * "weekly\_visits": 5123451, * "spot\_volume\_usd": 66926283498.60113, * "spot\_volume\_last\_updated": "2021-05-06T01:20:15.451Z", * "urls": { * "website": \[\ \ * "[https://www.binance.com/](https://www.binance.com/)\ "\ \ \ \], * "twitter": \[\ \ * "[https://twitter.com/binance](https://twitter.com/binance)\ "\ \ \ \], * "blog": \[ \], * "chat": \[\ \ * "[https://t.me/binanceexchange](https://t.me/binanceexchange)\ "\ \ \ \], * "fee": \[\ \ * "[https://www.binance.com/fees.html](https://www.binance.com/fees.html)\ "\ \ \ \] } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) 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](https://coinmarketcap.com/methodology/) for additional details on listing states. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * 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. ##### Parameters listing\_status string "active" ^(active|inactive|untracked)+(?:,(active|inactive|untracked)+)\*$ 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 string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ 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. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. sort string "id" "volume\_24h" "id" What field to sort the list of exchanges by. aux string "first\_historical\_data,last\_historical\_data,is\_active" ^(first\_historical\_data|last\_historical\_data|is\_active|status)+(?:,(first\_historical\_data|last\_historical\_data|is\_active|status)+)\*$ 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 string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Map%20-%20Exchange%20Object Required

Array of exchange object results. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/map Server URL https://pro-api.coinmarketcap.com/v1/exchange/map * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 270,\ \ * "name": "Binance",\ \ * "slug": "binance",\ \ * "is\_active": 1,\ \ * "status": "active",\ \ * "first\_historical\_data": "2018-04-26T00:45:00.000Z",\ \ * "last\_historical\_data": "2019-06-02T21:25:00.000Z"\ \ \ }\ \ \ \], * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * ~Startup~ * 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/](https://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._ ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. sort string "volume\_24h" "name" "volume\_24h" "volume\_24h\_adjusted" "exchange\_score" What field to sort the list of exchanges by. sort\_dir string "asc" "desc" The direction in which to order exchanges against the specified sort. market\_type string "all" "fees" "no\_fees" "all" The type of exchange markets to include in rankings. This field is deprecated. Please use "all" for accurate sorting. category string "all" "all" "spot" "derivatives" "dex" "lending" The category for this exchange. aux string "num\_market\_pairs,traffic\_score,rank,exchange\_score,effective\_liquidity\_24h" ^(num\_market\_pairs|traffic\_score|rank|exchange\_score|effective\_liquidity\_24h|date\_launched|fiats)+(?:,(num\_market\_pairs|traffic\_score|rank|exchange\_score|effective\_liquidity\_24h|date\_launched|fiats)+)\*$ 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 string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Listings%20Latest%20-%20Exchange%20object Required

Array of exchange objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/listings/latest Server URL https://pro-api.coinmarketcap.com/v1/exchange/listings/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 270,\ \ * "name": "Binance",\ \ * "slug": "binance",\ \ * "num\_market\_pairs": 1214,\ \ * "fiats": \ \ \[\ \ * "AED",\ \ * "USD"\ \ \ \],\ \ * "traffic\_score": 1000,\ \ * "rank": 1,\ \ * "exchange\_score": null,\ \ * "liquidity\_score": 9.8028,\ \ * "last\_updated": "2018-11-08T22:18:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 769291636.239632,\ \ * "volume\_24h\_adjusted": 769291636.239632,\ \ * "volume\_7d": 3666423776,\ \ * "volume\_30d": 21338299776,\ \ * "percent\_change\_volume\_24h": \-11.6153,\ \ * "percent\_change\_volume\_7d": 67.2055,\ \ * "percent\_change\_volume\_30d": 0.00169339,\ \ * "effective\_liquidity\_24h": 629.9774,\ \ * "derivative\_volume\_usd": 62828618628.85901,\ \ * "spot\_volume\_usd": 39682580614.8572\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 294,\ \ * "name": "OKEx",\ \ * "slug": "okex",\ \ * "num\_market\_pairs": 385,\ \ * "fiats": \ \ \[\ \ * "AED",\ \ * "USD"\ \ \ \],\ \ * "traffic\_score": 845.1565,\ \ * "rank": 1,\ \ * "exchange\_score": null,\ \ * "liquidity\_score": 9.8028,\ \ * "last\_updated": "2018-11-08T22:18:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 677439315.721563,\ \ * "volume\_24h\_adjusted": 677439315.721563,\ \ * "volume\_7d": 3506137120,\ \ * "volume\_30d": 14418225072,\ \ * "percent\_change\_volume\_24h": \-13.9256,\ \ * "percent\_change\_volume\_7d": 60.0461,\ \ * "percent\_change\_volume\_30d": 67.2225,\ \ * "effective\_liquidity\_24h": 629.9774,\ \ * "derivative\_volume\_usd": 62828618628.85901,\ \ * "spot\_volume\_usd": 39682580614.8572\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * ~Startup~ * 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/](https://coinmarketcap.com/exchanges/binance/) . ##### Parameters id string ^\\d\*$ A CoinMarketCap exchange ID. Example: "1" slug string ^\[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. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. aux string "num\_market\_pairs,category,fee\_type" ^(num\_market\_pairs|category|fee\_type|market\_url|currency\_name|currency\_slug|price\_quote|effective\_liquidity|market\_score|market\_reputation)+(?:,(num\_market\_pairs|category|fee\_type|market\_url|currency\_name|currency\_slug|price\_quote|effective\_liquidity|market\_score|market\_reputation)+)\*$ 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 string ^\\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 string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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. category string "all" "all" "spot" "derivatives" "otc" "futures" "perpetual" The category of trading this market falls under. Spot markets are the most common but options include derivatives and OTC. fee\_type string "all" "all" "percentage" "no-fees" "transactional-mining" "unknown" The fee type the exchange enforces for this market. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Market%20Pairs%20Latest%20-%20Results%20object Required

Results of your query returned as an object. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/market-pairs/latest Server URL https://pro-api.coinmarketcap.com/v1/exchange/market-pairs/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 270, * "name": "Binance", * "slug": "binance", * "num\_market\_pairs": 473, * "volume\_24h": 769291636.239632, * "market\_pairs": \[\ \ * {\ \ * "market\_id": 9933,\ \ * "market\_pair": "BTC/USDT",\ \ * "category": "spot",\ \ * "fee\_type": "percentage",\ \ * "outlier\_detected": 0,\ \ * "exclusions": null,\ \ * "market\_pair\_base": \ \ {\ \ * "currency\_id": 1,\ \ * "currency\_symbol": "BTC",\ \ * "exchange\_symbol": "BTC",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "market\_pair\_quote": \ \ {\ \ * "currency\_id": 825,\ \ * "currency\_symbol": "USDT",\ \ * "exchange\_symbol": "USDT",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "quote": \ \ {\ \ * "exchange\_reported": \ \ {\ \ * "price": 7901.83,\ \ * "volume\_24h\_base": 47251.3345550653,\ \ * "volume\_24h\_quote": 373372012.927251,\ \ * "volume\_percentage": 19.4346563602467,\ \ * "last\_updated": "2019-05-24T01:40:10.000Z"\ \ \ },\ \ * "USD": \ \ {\ \ * "price": 7933.66233493434,\ \ * "volume\_24h": 374876133.234903,\ \ * "depth\_negative\_two": 40654.68019906,\ \ * "depth\_positive\_two": 17352.9964811,\ \ * "last\_updated": "2019-05-24T01:40:10.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "market\_id": 36329,\ \ * "market\_pair": "MATIC/BTC",\ \ * "category": "spot",\ \ * "fee\_type": "percentage",\ \ * "outlier\_detected": 0,\ \ * "exclusions": null,\ \ * "market\_pair\_base": \ \ {\ \ * "currency\_id": 3890,\ \ * "currency\_symbol": "MATIC",\ \ * "exchange\_symbol": "MATIC",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "market\_pair\_quote": \ \ {\ \ * "currency\_id": 1,\ \ * "currency\_symbol": "BTC",\ \ * "exchange\_symbol": "BTC",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "quote": \ \ {\ \ * "exchange\_reported": \ \ {\ \ * "price": 0.0000034,\ \ * "volume\_24h\_base": 8773968381.05,\ \ * "volume\_24h\_quote": 29831.49249557,\ \ * "volume\_percentage": 19.4346563602467,\ \ * "last\_updated": "2019-05-24T01:41:16.000Z"\ \ \ },\ \ * "USD": \ \ {\ \ * "price": 0.0269295015799739,\ \ * "volume\_24h": 236278595.380127,\ \ * "depth\_negative\_two": 40654.68019906,\ \ * "depth\_positive\_two": 17352.9964811,\ \ * "last\_updated": "2019-05-24T01:41:16.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesHistorical) 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](https://coinmarketcap.com/api/features) :** * ~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/](https://coinmarketcap.com/rankings/exchanges/) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated exchange CoinMarketCap ids. Example: "24,270" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ 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\_start string Timestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time\_end". time\_end string Timestamp (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. count number \[ 1 .. 10000 \] 10 The 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. interval string "5m" "yearly" "monthly" "weekly" "daily" "hourly" "5m" "10m" "15m" "30m" "45m" "1h" "2h" "3h" "4h" "6h" "12h" "24h" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d" Interval of time to return data points for. See details in endpoint description. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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 string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Historical%20Quotes%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/quotes/historical Server URL https://pro-api.coinmarketcap.com/v1/exchange/quotes/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 270, * "name": "Binance", * "slug": "binance", * "quotes": \[\ \ * {\ \ * "timestamp": "2018-06-03T00:00:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 1632390000,\ \ * "timestamp": "2018-06-03T00:00:00.000Z"\ \ \ }\ \ \ },\ \ * "num\_market\_pairs": 338\ \ \ },\ \ * {\ \ * "timestamp": "2018-06-10T00:00:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 1034720000,\ \ * "timestamp": "2018-06-10T00:00:00.000Z"\ \ \ }\ \ \ },\ \ * "num\_market\_pairs": 349\ \ \ },\ \ * {\ \ * "timestamp": "2018-06-17T00:00:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 883885000,\ \ * "timestamp": "2018-06-17T00:00:00.000Z"\ \ \ }\ \ \ },\ \ * "num\_market\_pairs": 357\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#tag/global-metrics) global-metrics ===================================================================================== ##### API endpoints for global aggregate market data. This category currently includes 2 endpoints: * [/v1/global-metrics/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesLatest) - Latest global metrics * [/v1/global-metrics/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesHistorical) - Historical global metrics [](https://coinmarketcap.com/api/documentation/v1/#tag/CMC20-Index) CMC20 Index =============================================================================== ##### API endpoints for CoinMarketCap20 Index. This category currently includes 2 endpoints: * [/v3/index/cmc20-latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC20Latest) - Latest CoinMarketCap 20 Index * [/v3/index/cmc20-historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC20Historical) - Historical CoinMarketCap 20 Index Your Product shall prominently provide attribution to CoinMarketCap as follows: "Data provided by [CoinMarketCap.com](http://coinmarketcap.com/) " and shall include a hyperlink to such website. For more details on the commercial agreement, visit [https://pro.coinmarketcap.com/user-agreement-commercial/](https://pro.coinmarketcap.com/user-agreement-commercial/) or contact us at [https://support.coinmarketcap.com/hc/en-us/requests/new?ticket\_form\_id=360001156492](https://support.coinmarketcap.com/hc/en-us/requests/new?ticket_form_id=360001156492) . [](https://coinmarketcap.com/api/documentation/v1/#tag/CMC100-Index) CMC100 Index ================================================================================= ##### API endpoints for CoinMarketCap100 Index. This category currently includes 2 endpoints: * [/v3/index/cmc100-latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC100Latest) - Latest CoinMarketCap 100 Index * [/v3/index/cmc100-historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC100Historical) - Historical CoinMarketCap 100 Index Your Product shall prominently provide attribution to CoinMarketCap as follows: "Data provided by [CoinMarketCap.com](http://coinmarketcap.com/) " and shall include a hyperlink to such website. For more details on the commercial agreement, visit [https://pro.coinmarketcap.com/user-agreement-commercial/](https://pro.coinmarketcap.com/user-agreement-commercial/) or contact us at [https://support.coinmarketcap.com/hc/en-us/requests/new?ticket\_form\_id=360001156492](https://support.coinmarketcap.com/hc/en-us/requests/new?ticket_form_id=360001156492) . [](https://coinmarketcap.com/api/documentation/v1/#tag/fear-and-greed) fear-and-greed ===================================================================================== ##### API endpoints for cryptocurrencies. This category currently includes 2 endpoints: * [/v3/fear-and-greed/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedLatest) - Latest CMC Crypto Fear and Greed Index * [/v3/fear-and-greed/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedHistorical) - Historical CMC Crypto Fear and Greed Index CMC Crypto Fear and Greed APIs are free to use for personal and commercial purposes. Any commercial product using the API should prominently feature the following text: "Data provided by [CoinMarketCap.com](http://coinmarketcap.com/) " with a hyperlink to [https://coinmarketcap.com/](https://coinmarketcap.com/) . For more details on the commercial agreement, visit [https://pro.coinmarketcap.com/user-agreement-commercial/](https://pro.coinmarketcap.com/user-agreement-commercial/) or contact us at [https://support.coinmarketcap.com/hc/en-us/requests/new?ticket\_form\_id=360001156492](https://support.coinmarketcap.com/hc/en-us/requests/new?ticket_form_id=360001156492) . [](https://coinmarketcap.com/api/documentation/v1/#tag/fiat) fiat ================================================================= ##### API endpoints for fiat currencies. This category currently includes 1 endpoint: * [/v1/fiat/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1FiatMap) - CoinMarketCap ID map [](https://coinmarketcap.com/api/documentation/v1/#tag/tools) tools =================================================================== ##### API endpoints for convenience utilities. This category currently includes 1 endpoint: * [/v2/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV2ToolsPriceconversion) - Price conversion tool * [/v1/tools/postman](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPostman) - Postman tool [](https://coinmarketcap.com/api/documentation/v1/#tag/blockchain) blockchain ============================================================================= ##### API endpoints for blockchain data. This category currently includes 1 endpoint: * [/v1/blockchain/statistics/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1BlockchainStatisticsLatest) - Latest statistics [](https://coinmarketcap.com/api/documentation/v1/#tag/content) content ======================================================================= ##### API endpoints for content data. This category currently includes 4 endpoints: * [/v1/content/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentLatest) - Content latest * [/v1/content/posts/top](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsTop) - Content top posts * [/v1/content/posts/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsLatest) - Content latest posts * [/v1/content/posts/comments](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsComments) - Content post comments [](https://coinmarketcap.com/api/documentation/v1/#tag/community) community =========================================================================== ##### API endpoints for community data. This category currently includes 2 endpoints: * [/v1/community/trending/topic](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingTopic) - Community Trending Topics * [/v1/community/trending/token](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingToken) - Community Trending Tokens [](https://coinmarketcap.com/api/documentation/v1/#tag/key) key =============================================================== ##### API endpoints for managing your API key. This category currently includes 1 endpoint: * [/v1/key/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1KeyInfo) - Key Info [](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) deprecated ============================================================================= ##### Deprecated (V1) Endpoints These endpoints have been replaced with their V2 versions, and are no longer being actively supported. We strongly suggest migrating to V2 endpoints, and this documentation only exists for legacy purposes. --- # CoinMarketCap API Documentation * Introduction * Quick Start Guide * Authentication * Endpoint Overview * Standards and Conventions * Errors and Rate Limits * Best Practices * Version History * cryptocurrency * get Airdrop * get Airdrops * get Categories * get Category * get CoinMarketCap ID Map * get Metadata v2 * get Listings Historical * get Listings Latest * get Listings New * get Trending Gainers & Losers * get Trending Latest * get Trending Most Visited * get Market Pairs Latest v2 * get OHLCV Historical v2 * get OHLCV Latest v2 * get Price Performance Stats v2 * get Quotes Historical v2 * get Quotes Latest v2 * get Quotes Historical v3 * DexScan * get Quotes Latest * get Pairs Listings Latest * exchange * get Exchange Assets * get Metadata * get CoinMarketCap ID Map * get Listings Latest * get Market Pairs Latest * get Quotes Historical * get Quotes Latest * global-metrics * get Quotes Historical * get Quotes Latest * CMC20 Index * get CoinMarketCap 20 Index Historical * get CoinMarketCap 20 Index Latest * CMC100 Index * get CoinMarketCap 100 Index Historical * get CoinMarketCap 100 Index Latest * fear-and-greed * get CMC Crypto Fear and Greed Historical * get CMC Crypto Fear and Greed Latest * fiat * get CoinMarketCap ID Map * tools * get Postman Conversion v1 * get Price Conversion v2 * blockchain * get Statistics Latest * content * community * key * get Key Info * deprecated * get Metadata v1 (deprecated) * get Price Conversion v1 (deprecated) * get Market Pairs Latest v1 (deprecated) * get OHLCV Historical v1 (deprecated) * get OHLCV Latest v1 (deprecated) * get Price Performance Stats v1 (deprecated) * get Quotes Historical v1 (deprecated) * get Quotes Latest v1 (deprecated) * get FCAS Listings Latest (deprecated) * get FCAS Quotes Latest (deprecated) * get DEX Metadata (deprecated) * get DEX Listings Latest (deprecated) * get DEX CoinMarketCap ID Map (deprecated) * get DEX OHLCV Historical (deprecated) * get DEX OHLCV Latest (deprecated) * get DEX Trades Latest (deprecated) * get Content Latest * get Community Trending Tokens * get Community Trending Topics * get Content Post Comments * get Content Latest Posts * get Content Top Posts CoinMarketCap Cryptocurrency API Documentation (v2.0.4) ======================================================= Contact: [api@coinmarketcap.com](mailto:api@coinmarketcap.com) [](https://coinmarketcap.com/api/documentation/v1/#section/Introduction) Introduction ===================================================================================== The CoinMarketCap API is a suite of high-performance RESTful JSON endpoints that are specifically designed to meet the mission-critical demands of application developers, data scientists, and enterprise business platforms. This API reference includes all technical documentation developers need to integrate third-party applications and platforms. Additional answers to common questions can be found in the [CoinMarketCap API FAQ](https://coinmarketcap.com/api/faq) . [](https://coinmarketcap.com/api/documentation/v1/#section/Quick-Start-Guide) Quick Start Guide =============================================================================================== For developers eager to hit the ground running with the CoinMarketCap API here are a few quick steps to make your first call with the API. 1. **Sign up for a free Developer Portal account.** You can sign up at [pro.coinmarketcap.com](https://pro.coinmarketcap.com/) - This is our live production environment with the latest market data. Select the free `Basic` plan if it meets your needs or upgrade to a paid tier. 2. **Copy your API Key.** Once you sign up you'll land on your Developer Portal account dashboard. Copy your API from the `API Key` box in the top left panel. 3. **Make a test call using your key.** You may use the code examples provided below to make a test call with your programming language of choice. This example [fetches all active cryptocurrencies by market cap and return market values in USD](https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest?start=1&limit=5000&convert=USD) . _Be sure to replace the API Key in sample code with your own and use API domain `pro-api.coinmarketcap.com` or use the test API Key `b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c` for `sandbox-api.coinmarketcap.com` testing with our sandbox environment. Please note that our sandbox api has mock data and should not be used in your application._ 4. **Postman Collection** To help with development, we provide a fully featured postman collection that you can import and use immediately! [Read more here](https://coinmarketcap.com/alexandria/article/register-for-coinmarketcap-api) . 5. **Implement your application.** Now that you've confirmed your API Key is working, get familiar with the API by reading the rest of this API Reference and commence building your application! _**Note:** Making HTTP requests on the client side with Javascript is currently prohibited through CORS configuration. This is to protect your API Key which should not be visible to users of your application so your API Key is not stolen. Secure your API Key by routing calls through your own backend service._ **View Quick Start Code Examples** cURL command line curl -H "X-CMC_PRO_API_KEY: b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c" -H "Accept: application/json" -d "start=1&limit=5000&convert=USD" -G https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest Node.js /* Example in Node.js */ const axios = require('axios'); let response = null; new Promise(async (resolve, reject) => { try { response = await axios.get('https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest', { headers: { 'X-CMC_PRO_API_KEY': 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c', }, }); } catch(ex) { response = null; // error console.log(ex); reject(ex); } if (response) { // success const json = response.data; console.log(json); resolve(json); } }); Python #This example uses Python 2.7 and the python-request library. from requests import Request, Session from requests.exceptions import ConnectionError, Timeout, TooManyRedirects import json url = 'https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest' parameters = { 'start':'1', 'limit':'5000', 'convert':'USD' } headers = { 'Accepts': 'application/json', 'X-CMC_PRO_API_KEY': 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c', } session = Session() session.headers.update(headers) try: response = session.get(url, params=parameters) data = json.loads(response.text) print(data) except (ConnectionError, Timeout, TooManyRedirects) as e: print(e) PHP /** * Requires curl enabled in php.ini **/ '1',\ 'limit' => '5000',\ 'convert' => 'USD'\ ]; $headers = [\ 'Accepts: application/json',\ 'X-CMC_PRO_API_KEY: b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c'\ ]; $qs = http_build_query($parameters); // query string encode the parameters $request = "{$url}?{$qs}"; // create the request URL $curl = curl_init(); // Get cURL resource // Set cURL options curl_setopt_array($curl, array( CURLOPT_URL => $request, // set the request URL CURLOPT_HTTPHEADER => $headers, // set the headers CURLOPT_RETURNTRANSFER => 1 // ask for raw response instead of bool )); $response = curl_exec($curl); // Send the request, save the response print_r(json_decode($response)); // print json decoded response curl_close($curl); // Close request ?> Java /** * This example uses the Apache HTTPComponents library. */ import org.apache.http.HttpEntity; import org.apache.http.HttpHeaders; import org.apache.http.NameValuePair; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpGet; import org.apache.http.client.utils.URIBuilder; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.message.BasicNameValuePair; import org.apache.http.util.EntityUtils; import java.io.IOException; import java.net.URISyntaxException; import java.util.ArrayList; import java.util.List; public class JavaExample { private static String apiKey = "b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c"; public static void main(String[] args) { String uri = "https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest"; List paratmers = new ArrayList(); paratmers.add(new BasicNameValuePair("start","1")); paratmers.add(new BasicNameValuePair("limit","5000")); paratmers.add(new BasicNameValuePair("convert","USD")); try { String result = makeAPICall(uri, paratmers); System.out.println(result); } catch (IOException e) { System.out.println("Error: cannont access content - " + e.toString()); } catch (URISyntaxException e) { System.out.println("Error: Invalid URL " + e.toString()); } } public static String makeAPICall(String uri, List parameters) throws URISyntaxException, IOException { String response_content = ""; URIBuilder query = new URIBuilder(uri); query.addParameters(parameters); CloseableHttpClient client = HttpClients.createDefault(); HttpGet request = new HttpGet(query.build()); request.setHeader(HttpHeaders.ACCEPT, "application/json"); request.addHeader("X-CMC_PRO_API_KEY", apiKey); CloseableHttpResponse response = client.execute(request); try { System.out.println(response.getStatusLine()); HttpEntity entity = response.getEntity(); response_content = EntityUtils.toString(entity); EntityUtils.consume(entity); } finally { response.close(); } return response_content; } } C# using System; using System.Net; using System.Web; class CSharpExample { private static string API_KEY = "b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c"; public static void Main(string[] args) { try { Console.WriteLine(makeAPICall()); } catch (WebException e) { Console.WriteLine(e.Message); } } static string makeAPICall() { var URL = new UriBuilder("https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest"); var queryString = HttpUtility.ParseQueryString(string.Empty); queryString["start"] = "1"; queryString["limit"] = "5000"; queryString["convert"] = "USD"; URL.Query = queryString.ToString(); var client = new WebClient(); client.Headers.Add("X-CMC_PRO_API_KEY", API_KEY); client.Headers.Add("Accepts", "application/json"); return client.DownloadString(URL.ToString()); } } Go package main import ( "fmt" "io/ioutil" "log" "net/http" "net/url" "os" ) func main() { client := &http.Client{} req, err := http.NewRequest("GET","https://sandbox-api.coinmarketcap.com/v1/cryptocurrency/listings/latest", nil) if err != nil { log.Print(err) os.Exit(1) } q := url.Values{} q.Add("start", "1") q.Add("limit", "5000") q.Add("convert", "USD") req.Header.Set("Accepts", "application/json") req.Header.Add("X-CMC_PRO_API_KEY", "b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c") req.URL.RawQuery = q.Encode() resp, err := client.Do(req); if err != nil { fmt.Println("Error sending request to server") os.Exit(1) } fmt.Println(resp.Status); respBody, _ := ioutil.ReadAll(resp.Body) fmt.Println(string(respBody)); } [](https://coinmarketcap.com/api/documentation/v1/#section/Authentication) Authentication ========================================================================================= ### Acquiring an API Key All HTTP requests made against the CoinMarketCap API must be validated with an API Key. If you don't have an API Key yet visit the [API Developer Portal](https://coinmarketcap.com/api/) to register for one. ### Using Your API Key You may use any _server side_ programming language that can make HTTP requests to target the CoinMarketCap API. All requests should target domain `https://pro-api.coinmarketcap.com`. You can supply your API Key in REST API calls in one of two ways: 1. Preferred method: Via a custom header named `X-CMC_PRO_API_KEY` 2. Convenience method: Via a query string parameter named `CMC_PRO_API_KEY` _**Security Warning:** It's important to secure your API Key against public access. The custom header option is strongly recommended over the querystring option for passing your API Key in a production environment._ ### API Key Usage Credits Most API plans include a daily and monthly limit or "hard cap" to the number of data calls that can be made. This usage is tracked as API "call credits" which are incremented 1:1 against successful (HTTP Status 200) data calls made with your key with these exceptions: * Account management endpoints, usage stats endpoints, and error responses are not included in this limit. * **Paginated endpoints:** List-based endpoints track an additional call credit for every 100 data points returned (rounded up) beyond our 100 data point defaults. Our lightweight `/map` endpoints are not included in this limit and always count as 1 credit. See individual endpoint documentation for more details. * **Bundled API calls:** Many endpoints support [resource and currency conversion bundling](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Bundled resources are also tracked as 1 call credit for every 100 resources returned (rounded up). Optional currency conversion bundling using the `convert` parameter also increment an additional API call credit for every conversion requested beyond the first. You can log in to the [Developer Portal](https://coinmarketcap.com/api/) to view live stats on your API Key usage and limits including the number of credits used for each call. You can also find call credit usage in the JSON response for each API call. See the [`status` object](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) for details. You may also use the [/key/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1KeyInfo) endpoint to quickly review your usage and when daily/monthly credits reset directly from the API. _**Note:** "day" and "month" credit usage periods are defined relative to your API subscription. For example, if your monthly subscription started on the 5th at 5:30am, this billing anchor is also when your monthly credits refresh each month. The free Basic tier resets each day at UTC midnight and each calendar month at UTC midnight._ [](https://coinmarketcap.com/api/documentation/v1/#section/Endpoint-Overview) Endpoint Overview =============================================================================================== ### The CoinMarketCap API is divided into 8 top-level categories | Endpoint Category | Description | | --- | --- | | [/cryptocurrency/\*](https://coinmarketcap.com/api/documentation/v1/#tag/cryptocurrency) | Endpoints that return data around cryptocurrencies such as ordered cryptocurrency lists or price and volume data. | | [/exchange/\*](https://coinmarketcap.com/api/documentation/v1/#tag/exchange) | Endpoints that return data around cryptocurrency exchanges such as ordered exchange lists and market pair data. | | [/global-metrics/\*](https://coinmarketcap.com/api/documentation/v1/#tag/global-metrics) | Endpoints that return aggregate market data such as global market cap and BTC dominance. | | [/tools/\*](https://coinmarketcap.com/api/documentation/v1/#tag/tools) | Useful utilities such as cryptocurrency and fiat price conversions. | | [/blockchain/\*](https://coinmarketcap.com/api/documentation/v1/#tag/blockchain) | Endpoints that return block explorer related data for blockchains. | | [/fiat/\*](https://coinmarketcap.com/api/documentation/v1/#tag/fiat) | Endpoints that return data around fiats currencies including mapping to CMC IDs. | | [/partners/\*](https://coinmarketcap.com/api/documentation/v1/#tag/partners) | Endpoints for convenient access to 3rd party crypto data. | | [/key/\*](https://coinmarketcap.com/api/documentation/v1/#tag/key) | API key administration endpoints to review and manage your usage. | | [/content/\*](https://coinmarketcap.com/api/documentation/v1/#tag/content) | Endpoints that return cryptocurrency-related news, headlines, articles, posts, and comments. | ### Endpoint paths follow a pattern matching the type of data provided | Endpoint Path | Endpoint Type | Description | | --- | --- | --- | | \*/latest | Latest Market Data | Latest market ticker quotes and averages for cryptocurrencies and exchanges. | | \*/historical | Historical Market Data | Intervals of historic market data like OHLCV data or data for use in charting libraries. | | \*/info | Metadata | Cryptocurrency and exchange metadata like block explorer URLs and logos. | | \*/map | ID Maps | Utility endpoints to get a map of resources to CoinMarketCap IDs. | ### Cryptocurrency and exchange endpoints provide 2 different ways of accessing data depending on purpose * **Listing endpoints:** Flexible paginated `*/listings/*` endpoints allow you to sort and filter lists of data like cryptocurrencies by market cap or exchanges by volume. * **Item endpoints:** Convenient ID-based resource endpoints like `*/quotes/*` and `*/market-pairs/*` allow you to bundle several IDs; for example, this allows you to get latest market quotes for a specific set of cryptocurrencies in one call. [](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) Standards and Conventions =============================================================================================================== Each HTTP request must contain the header `Accept: application/json`. You should also send an `Accept-Encoding: deflate, gzip` header to receive data fast and efficiently. ### Endpoint Response Payload Format All endpoints return data in JSON format with the results of your query under `data` if the call is successful. A `Status` object is always included for both successful calls and failures when possible. The `Status` object always includes the current time on the server when the call was executed as `timestamp`, the number of API call credits this call utilized as `credit_count`, and the number of milliseconds it took to process the request as `elapsed`. Any details about errors encountered can be found under the `error_code` and `error_message`. See [Errors and Rate Limits](https://coinmarketcap.com/api/documentation/v1/#section/Errors-and-Rate-Limits) for details on errors. { "data" : { ... }, "status": { "timestamp": "2018-06-06T07:52:27.273Z", "error_code": 400, "error_message": "Invalid value for \"id\"", "elapsed": 0, "credit_count": 0 } } ### Cryptocurrency, Exchange, and Fiat currency identifiers * Cryptocurrencies may be identified in endpoints using either the cryptocurrency's unique CoinMarketCap ID as `id` (eg. `id=1` for Bitcoin) or the cryptocurrency's symbol (eg. `symbol=BTC` for Bitcoin). For a current list of supported cryptocurrencies use our [`/cryptocurrency/map` call](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) . * Exchanges may be identified in endpoints using either the exchange's unique CoinMarketCap ID as `id` (eg. `id=270` for Binance) or the exchange's web slug (eg. `slug=binance` for Binance). For a current list of supported exchanges use our [`/exchange/map` call](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) . * All fiat currency options use the standard [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) currency code (eg. `USD` for the US Dollar). For a current list of supported fiat currencies use our [`/fiat/map`](https://coinmarketcap.com/api/documentation/v1/#operation/getV1FiatMap) endpoint. Unless otherwise stated, endpoints with fiat currency options like our `convert` parameter support these 93 major currency codes: | Currency | Currency Code | CoinMarketCap ID | | --- | --- | --- | | United States Dollar ($) | USD | 2781 | | Albanian Lek (L) | ALL | 3526 | | Algerian Dinar (د.ج) | DZD | 3537 | | Argentine Peso ($) | ARS | 2821 | | Armenian Dram (֏) | AMD | 3527 | | Australian Dollar ($) | AUD | 2782 | | Azerbaijani Manat (₼) | AZN | 3528 | | Bahraini Dinar (.د.ب) | BHD | 3531 | | Bangladeshi Taka (৳) | BDT | 3530 | | Belarusian Ruble (Br) | BYN | 3533 | | Bermudan Dollar ($) | BMD | 3532 | | Bolivian Boliviano (Bs.) | BOB | 2832 | | Bosnia-Herzegovina Convertible Mark (KM) | BAM | 3529 | | Brazilian Real (R$) | BRL | 2783 | | Bulgarian Lev (лв) | BGN | 2814 | | Cambodian Riel (៛) | KHR | 3549 | | Canadian Dollar ($) | CAD | 2784 | | Chilean Peso ($) | CLP | 2786 | | Chinese Yuan (¥) | CNY | 2787 | | Colombian Peso ($) | COP | 2820 | | Costa Rican Colón (₡) | CRC | 3534 | | Croatian Kuna (kn) | HRK | 2815 | | Cuban Peso ($) | CUP | 3535 | | Czech Koruna (Kč) | CZK | 2788 | | Danish Krone (kr) | DKK | 2789 | | Dominican Peso ($) | DOP | 3536 | | Egyptian Pound (£) | EGP | 3538 | | Euro (€) | EUR | 2790 | | Georgian Lari (₾) | GEL | 3539 | | Ghanaian Cedi (₵) | GHS | 3540 | | Guatemalan Quetzal (Q) | GTQ | 3541 | | Honduran Lempira (L) | HNL | 3542 | | Hong Kong Dollar ($) | HKD | 2792 | | Hungarian Forint (Ft) | HUF | 2793 | | Icelandic Króna (kr) | ISK | 2818 | | Indian Rupee (₹) | INR | 2796 | | Indonesian Rupiah (Rp) | IDR | 2794 | | Iranian Rial (﷼) | IRR | 3544 | | Iraqi Dinar (ع.د) | IQD | 3543 | | Israeli New Shekel (₪) | ILS | 2795 | | Jamaican Dollar ($) | JMD | 3545 | | Japanese Yen (¥) | JPY | 2797 | | Jordanian Dinar (د.ا) | JOD | 3546 | | Kazakhstani Tenge (₸) | KZT | 3551 | | Kenyan Shilling (Sh) | KES | 3547 | | Kuwaiti Dinar (د.ك) | KWD | 3550 | | Kyrgystani Som (с) | KGS | 3548 | | Lebanese Pound (ل.ل) | LBP | 3552 | | Macedonian Denar (ден) | MKD | 3556 | | Malaysian Ringgit (RM) | MYR | 2800 | | Mauritian Rupee (₨) | MUR | 2816 | | Mexican Peso ($) | MXN | 2799 | | Moldovan Leu (L) | MDL | 3555 | | Mongolian Tugrik (₮) | MNT | 3558 | | Moroccan Dirham (د.م.) | MAD | 3554 | | Myanma Kyat (Ks) | MMK | 3557 | | Namibian Dollar ($) | NAD | 3559 | | Nepalese Rupee (₨) | NPR | 3561 | | New Taiwan Dollar (NT$) | TWD | 2811 | | New Zealand Dollar ($) | NZD | 2802 | | Nicaraguan Córdoba (C$) | NIO | 3560 | | Nigerian Naira (₦) | NGN | 2819 | | Norwegian Krone (kr) | NOK | 2801 | | Omani Rial (ر.ع.) | OMR | 3562 | | Pakistani Rupee (₨) | PKR | 2804 | | Panamanian Balboa (B/.) | PAB | 3563 | | Peruvian Sol (S/.) | PEN | 2822 | | Philippine Peso (₱) | PHP | 2803 | | Polish Złoty (zł) | PLN | 2805 | | Pound Sterling (£) | GBP | 2791 | | Qatari Rial (ر.ق) | QAR | 3564 | | Romanian Leu (lei) | RON | 2817 | | Russian Ruble (₽) | RUB | 2806 | | Saudi Riyal (ر.س) | SAR | 3566 | | Serbian Dinar (дин.) | RSD | 3565 | | Singapore Dollar (S$) | SGD | 2808 | | South African Rand (R) | ZAR | 2812 | | South Korean Won (₩) | KRW | 2798 | | South Sudanese Pound (£) | SSP | 3567 | | Sovereign Bolivar (Bs.) | VES | 3573 | | Sri Lankan Rupee (Rs) | LKR | 3553 | | Swedish Krona ( kr) | SEK | 2807 | | Swiss Franc (Fr) | CHF | 2785 | | Thai Baht (฿) | THB | 2809 | | Trinidad and Tobago Dollar ($) | TTD | 3569 | | Tunisian Dinar (د.ت) | TND | 3568 | | Turkish Lira (₺) | TRY | 2810 | | Ugandan Shilling (Sh) | UGX | 3570 | | Ukrainian Hryvnia (₴) | UAH | 2824 | | United Arab Emirates Dirham (د.إ) | AED | 2813 | | Uruguayan Peso ($) | UYU | 3571 | | Uzbekistan Som (so'm) | UZS | 3572 | | Vietnamese Dong (₫) | VND | 2823 | Along with these four precious metals: | Precious Metal | Currency Code | CoinMarketCap ID | | --- | --- | --- | | Gold Troy Ounce | XAU | 3575 | | Silver Troy Ounce | XAG | 3574 | | Platinum Ounce | XPT | 3577 | | Palladium Ounce | XPD | 3576 | _**Warning:** **Using CoinMarketCap IDs is always recommended as not all cryptocurrency symbols are unique. They can also change with a cryptocurrency rebrand.** If a symbol is used the API will always default to the cryptocurrency with the highest market cap if there are multiple matches. Our `convert` parameter also defaults to fiat if a cryptocurrency symbol also matches a supported fiat currency. You may use the convenient `/map` endpoints to quickly find the corresponding CoinMarketCap ID for a cryptocurrency or exchange._ ### Bundling API Calls * Many endpoints support ID and crypto/fiat currency conversion bundling. This means you can pass multiple comma-separated values to an endpoint to query or convert several items at once. Check the `id`, `symbol`, `slug`, and `convert` query parameter descriptions in the endpoint documentation to see if this is supported for an endpoint. * Endpoints that support bundling return data as an object map instead of an array. Each key-value pair will use the identifier you passed in as the key. For example, if you passed `symbol=BTC,ETH` to `/v1/cryptocurrency/quotes/latest` you would receive: "data" : { "BTC" : { ... }, "ETH" : { ... } } Or if you passed `id=1,1027` you would receive: "data" : { "1" : { ... }, "1027" : { ... } } Price conversions that are returned inside endpoint responses behave in the same fashion. These are enclosed in a `quote` object. ### Date and Time Formats * All endpoints that require date/time parameters allow timestamps to be passed in either [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (eg. `2018-06-06T01:46:40Z`) or in Unix time (eg. `1528249600`). Timestamps that are passed in ISO 8601 format support basic and extended notations; if a timezone is not included, UTC will be the default. * All timestamps returned in JSON payloads are returned in UTC time using human-readable ISO 8601 format which follows this pattern: `yyyy-mm-ddThh:mm:ss.mmmZ`. The final `.mmm` designates milliseconds. Per the ISO 8601 spec the final `Z` is a constant that represents UTC time. * Data is collected, recorded, and reported in UTC time unless otherwise specified. ### Versioning The CoinMarketCap API is versioned to guarantee new features and updates are non-breaking. The latest version of this API is `/v1/`. [](https://coinmarketcap.com/api/documentation/v1/#section/Errors-and-Rate-Limits) Errors and Rate Limits ========================================================================================================= ### API Request Throttling Use of the CoinMarketCap API is subject to API call rate limiting or "request throttling". This is the number of HTTP calls that can be made simultaneously or within the same minute with your API Key before receiving an HTTP 429 "Too Many Requests" throttling error. This limit scales with the [usage tier](https://pro.coinmarketcap.com/features) and resets every 60 seconds. Please review our [Best Practices](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) for implementation strategies that work well with rate limiting. ### HTTP Status Codes The API uses standard HTTP status codes to indicate the success or failure of an API call. * `400 (Bad Request)` The server could not process the request, likely due to an invalid argument. * `401 (Unauthorized)` Your request lacks valid authentication credentials, likely an issue with your API Key. * `402 (Payment Required)` Your API request was rejected due to it being a paid subscription plan with an overdue balance. Pay the balance in the [Developer Portal billing tab](https://pro.coinmarketcap.com/account/plan) and it will be enabled. * `403 (Forbidden)` Your request was rejected due to a permission issue, likely a restriction on the API Key's associated service plan. Here is a [convenient map](https://coinmarketcap.com/api/features) of service plans to endpoints. * `429 (Too Many Requests)` The API Key's rate limit was exceeded; consider slowing down your API Request frequency if this is an HTTP request throttling error. Consider upgrading your service plan if you have reached your monthly API call credit limit for the day/month. * `500 (Internal Server Error)` An unexpected server issue was encountered. ### Error Response Codes A `Status` object is always included in the JSON response payload for both successful calls and failures when possible. During error scenarios you may reference the `error_code` and `error_message` properties of the Status object. One of the API error codes below will be returned if applicable otherwise the HTTP status code for the general error type is returned. | HTTP Status | Error Code | Error Message | | --- | --- | --- | | 401 | 1001 \[API\_KEY\_INVALID\] | This API Key is invalid. | | 401 | 1002 \[API\_KEY\_MISSING\] | API key missing. | | 402 | 1003 \[API\_KEY\_PLAN\_REQUIRES\_PAYEMENT\] | Your API Key must be activated. Please go to pro.coinmarketcap.com/account/plan. | | 402 | 1004 \[API\_KEY\_PLAN\_PAYMENT\_EXPIRED\] | Your API Key's subscription plan has expired. | | 403 | 1005 \[API\_KEY\_REQUIRED\] | An API Key is required for this call. | | 403 | 1006 \[API\_KEY\_PLAN\_NOT\_AUTHORIZED\] | Your API Key subscription plan doesn't support this endpoint. | | 403 | 1007 \[API\_KEY\_DISABLED\] | This API Key has been disabled. Please contact support. | | 429 | 1008 \[API\_KEY\_PLAN\_MINUTE\_RATE\_LIMIT\_REACHED\] | You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute. | | 429 | 1009 \[API\_KEY\_PLAN\_DAILY\_RATE\_LIMIT\_REACHED\] | You've exceeded your API Key's daily rate limit. | | 429 | 1010 \[API\_KEY\_PLAN\_MONTHLY\_RATE\_LIMIT\_REACHED\] | You've exceeded your API Key's monthly rate limit. | | 429 | 1011 \[IP\_RATE\_LIMIT\_REACHED\] | You've hit an IP rate limit. | [](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) Best Practices ========================================================================================= This section contains a few recommendations on how to efficiently utilize the CoinMarketCap API for your enterprise application, particularly if you already have a large base of users for your application. ### Use CoinMarketCap ID Instead of Cryptocurrency Symbol Utilizing common cryptocurrency symbols to reference cryptocurrencies on the API is easy and convenient but brittle. You should know that many cryptocurrencies have the same symbol, for example, there are currently three cryptocurrencies that commonly refer to themselves by the symbol HOT. Cryptocurrency symbols also often change with cryptocurrency rebrands. When fetching cryptocurrency by a symbol that matches several active cryptocurrencies we return the one with the highest market cap at the time of the query. To ensure you always target the cryptocurrency you expect, use our permanent CoinMarketCap IDs. These IDs are used reliably by numerous mission critical platforms and _never change_. We make fetching a map of all active cryptocurrencies' CoinMarketCap IDs very easy. Just call our [`/cryptocurrency/map`](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) endpoint to receive a list of all active currencies mapped to the unique `id` property. This map also includes other typical identifiying properties like `name`, `symbol` and platform `token_address` that can be cross referenced. In cryptocurrency calls you would then send, for example `id=1027`, instead of `symbol=ETH`. **It's strongly recommended that any production code utilize these IDs for cryptocurrencies, exchanges, and markets to future-proof your code.** ### Use the Right Endpoints for the Job You may have noticed that `/cryptocurrency/listings/latest` and `/cryptocurrency/quotes/latest` return the same crypto data but in different formats. This is because the former is for requesting paginated and ordered lists of _all_ cryptocurrencies while the latter is for selectively requesting only the specific cryptocurrencies you require. Many endpoints follow this pattern, allow the design of these endpoints to work for you! ### Implement a Caching Strategy If Needed There are standard legal data safeguards built into the [Commercial User Terms](https://pro.coinmarketcap.com/user-agreement-commercial) that application developers should keep in mind. These Terms help prevent unauthorized scraping and redistributing of CMC data but are intentionally worded to allow legitimate local caching of market data to support the operation of your application. If your application has a significant user base and you are concerned with staying within the call credit and API throttling limits of your subscription plan consider implementing a data caching strategy. For example instead of making a `/cryptocurrency/quotes/latest` call every time one of your application's users needs to fetch market rates for specific cryptocurrencies, you could pre-fetch and cache the latest market data for every cryptocurrency in your application's local database every 60 seconds. This would only require 1 API call, `/cryptocurrency/listings/latest?limit=5000`, every 60 seconds. Then, anytime one of your application's users need to load a custom list of cryptocurrencies you could simply pull this latest market data from your local cache without the overhead of additional calls. This kind of optimization is practical for customers with large, demanding user bases. ### Code Defensively to Ensure a Robust REST API Integration Whenever implementing any high availability REST API service for mission critical operations it's recommended to [code defensively](https://en.wikipedia.org/wiki/Defensive_programming) . Since the API is versioned, any breaking request or response format change would only be introduced through new versions of each endpoint, _however existing endpoints may still introduce new convenience properties over time_. We suggest these best practices: * You should parse the API response JSON as JSON and not through a regular expression or other means to avoid brittle parsing logic. * Your parsing code should explicitly parse only the response properties you require to guarantee new fields that may be returned in the future are ignored. * You should add robust field validation to your response parsing logic. You can wrap complex field parsing, like dates, in try/catch statements to minimize the impact of unexpected parsing issues (like the unlikely return of a null value). * Implement a "Retry with exponential backoff" coding pattern for your REST API call logic. This means if your HTTP request happens to get rate limited (HTTP 429) or encounters an unexpected server-side condition (HTTP 5xx) your code would automatically recover and try again using an intelligent recovery scheme. You may use one of the many libraries available; for example, [this one](https://github.com/tim-kos/node-retry) for Node or [this one](https://github.com/litl/backoff) for Python. ### Reach Out and Upgrade Your Plan If you're uncertain how to best implement the CoinMarketCap API in your application or your needs outgrow our current self-serve subscription tiers you can reach out to [api@coinmarketcap.com](mailto:api@coinmarketcap.com) . We'll review your needs and budget and may be able to tailor a custom enterprise plan that is right for you. [](https://coinmarketcap.com/api/documentation/v1/#section/Version-History) Version History =========================================================================================== The CoinMarketCap API utilizes [Semantic Versioning](https://semver.org/) in the format `major.minor.patch`. The current `major` version is incorporated into the API request path as `/v1/`. Non-breaking `minor` and `patch` updates to the API are released regularly. These may include new endpoints, data points, and API plan features which are always introduced in a non-breaking manner. _This means you can expect new properties to become available in our existing /v1/ endpoints however any breaking change will be introduced under a new major version of the API with legacy versions supported indefinitely unless otherwise stated_. You can [subscribe to our API Newsletter](https://coinmarketcap.com/#newsletter-signup) to get monthly email updates on CoinMarketCap API enhancements. ### v2.0.10 on Oct 14, 2024 * [/v3/fear-and-greed/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedLatest) and [/v3/fear-and-greed/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedHistorical) now available to get CMC Fear and Greed Index ### v2.0.9 on June 1, 2023 * [/v1/community/trending/topic](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingTopic) now available to get community trending topics. * [/v1/community/trending/token](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingToken) now available to get community trending tokens. ### v2.0.8 on November 25, 2022 * [/v1/exchange/assets](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeAssets) now available to get exchange assets in the form of token holdings. ### v2.0.7 on September 19, 2022 * [/v1/content/posts/top](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsTop) now available to get cryptocurrency-related top posts. * [/v1/content/posts/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsLatest) now available to get cryptocurrency-related latest posts. * [/v1/content/posts/comments](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsComments) now available to get comments of the post. ### v2.0.6 on Augest 18, 2022 * [/v1/content/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentLatest) now available to get news/headlines and Alexandria articles. ### v2.0.5 on Augest 4, 2022 * [/v1/tools/postman](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPostman) now API postman collection is available. ### v2.0.4 on October 11, 2021 * [/v1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes `volume_change_24h`. * [/v2/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) now includes `volume_change_24h`. ### v2.0.3 on October 6, 2021 * [/v1/cryptocurrency/trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) now supports `time_period` as an optional parameter. ### v2.0.2 on September 13, 2021 * [/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) now available to Free tier users. * [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) now available to Free tier users. ### v2.0.1 on September 8, 2021 * [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) now includes `volume_24h`, `depth_negative_two`, `depth_positive_two` and `volume_percentage`. * [/exchange/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) now includes `open_interest`. ### v2.0.0 on August 17, 2021 * By popular request we have added a number of new useful endpoints ! * [/v1/cryptocurrency/categories](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategories) can be used to access a list of categories and their associated coins. You can also filter the list of categories by one or more cryptocurrencies. * [/v1/cryptocurrency/category](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategory) can be used to load only a single category of coins, listing the coins within that category. * [/v1/cryptocurrency/airdrops](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrops) can be used to access a list of CoinMarketCap’s free airdrops. This defaults to a status of `ONGOING` but can be filtered to `UPCOMING` or `ENDED`. You can also query for a list of airdrops by cryptocurrency. * [/v1/cryptocurrency/airdrop](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrop) can be used to load a single airdrop and its associated cryptocurrency. * [/v1/cryptocurrency/trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) can be used to load the most searched for cryptocurrencies within a period of time. This defaults to a `time_period` of the previous `24h`, but can be changed to `30d`, or `7d` for a larger window of time. * [/v1/cryptocurrency/trending/most-visited](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostvisited) can be used to load the most visited cryptocurrencies within a period of time. This defaults to a `time_period` of the previous `24h`, but can be changed to `30d`, or `7d` for a larger window of time. * [/v1/cryptocurrency/trending/gainers-losers](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainerslosers) can be used to load the biggest gainers & losers within a period of time. This defaults to a `time_period` of the previous `24h`, but can be changed to `30d`, or `7d` for a larger window of time. ### v1.28.0 on August 9, 2021 * [/v1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes `market_cap_dominance` and `fully_diluted_market_cap`. * [/v1/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) now includes `market_cap_dominance` and `fully_diluted_market_cap`. ### v1.27.0 on January 27, 2021 * [/v2/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyInfo) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyMarketpairsLatest) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesHistorical) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvHistorical) response format changed to allow for multiple coins per symbol. * [/v2/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV2ToolsPriceconversion) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/ohlcv/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvLatest) response format changed to allow for multiple coins per symbol. * [/v2/cryptocurrency/price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyPriceperformancestatsLatest) response format changed to allow for multiple coins per symbol. ### v1.26.0 on January 21, 2021 * [/v2/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) response format changed to allow for multiple coins per symbol. ### v1.25.0 on April 17, 2020 * [/v1.1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes a more robust `tags` response with slug, name, and category. * [/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) now include `is_active` and `is_fiat` in the response. ### v1.24.0 on Feb 24, 2020 * [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) has been modified to include the high and low timestamps. * [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) now includes `category` and `fee_type` market pair filtering options. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes `category` and `fee_type` market pair filtering options. ### v1.23.0 on Feb 3, 2020 * [/fiat/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1FiatMap) is now available to fetch the latest mapping of supported fiat currencies to CMC IDs. * [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) now includes `matched_id` and `matched_symbol` market pair filtering options. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now provides filter parameters `price_min`, `price_max`, `market_cap_min`, `market_cap_max`, `percent_change_24h_min`, `percent_change_24h_max`, `volume_24h_max`, `circulating_supply_min` and `circulating_supply_max` in addition to the existing `volume_24h_min` filter. ### v1.22.0 on Oct 16, 2019 * [/global-metrics/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesLatest) now additionally returns `total_cryptocurrencies` and `total_exchanges` counts which include inactive projects who's data is still available via API. ### v1.21.0 on Oct 1, 2019 * [/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) now includes `sort` options including `volume_24h`. * [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) fix for a scenario where `first_historical_data` and `last_historical_data` may not be populated. * Additional improvements to alphanumeric sorts. ### v1.20.0 on Sep 25, 2019 * By popular request you may now configure API plan usage notifications and email alerts in the [Developer Portal](https://pro.coinmarketcap.com/account/notifications) . * [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) now includes `sort` options including `cmc_rank`. ### v1.19.0 on Sep 19, 2019 * A new `/blockchain/` category of endpoints is now available with the introduction of our new [/v1/blockchain/statistics/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1BlockchainStatisticsLatest) endpoint. This endpoint can be used to poll blockchain statistics data as seen in our [Blockchain Explorer](https://blockchain.coinmarketcap.com/chain/bitcoin) . * Additional platform error codes are now surfaced during HTTP Status Code 401, 402, 403, and 429 scenarios as documented in [Errors and Rate Limits](https://coinmarketcap.com/api/documentation/v1/#section/Errors-and-Rate-Limits) . * OHLCV endpoints using the `convert` option now match historical UTC open period exchange rates with greater accuracy. * [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) and [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) now include the optional `aux` parameter where listing `status` can be requested in the list of supplemental properties. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) : The accuracy of `percent_change_` conversions was improved when passing non-USD fiat `convert` options. * [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) now support relaxed request validation rules via the `skip_invalid` request parameter. * We also now return a helpful `notice` warning when API key usage is above 95% of daily and monthly API credit usage limits. ### v1.18.0 on Aug 28, 2019 * [/key/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1KeyInfo) has been added as a new endpoint. It may be used programmatically monitor your key usage compared to the rate limit and daily/monthly credit limits available to your API plan as an alternative to using the [Developer Portal Dashboard](https://pro.coinmarketcap.com/account) . * [/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) and [/v1/global-metrics/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesHistorical) have new options to make charting tasks easier and more efficient. Use the new `aux` parameter to cut out response properties you don't need and include the new `search_interval` timestamp to normalize disparate historical records against the same `interval` time periods. * A 4 hour interval option `4h` was added to all historical time series data endpoints. ### v1.17.0 on Aug 22, 2019 * [/cryptocurrency/price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyPriceperformancestatsLatest) has been added as our 21st endpoint! It returns launch price ROI, all-time high / all-time low, and other price stats over several supported time periods. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) now has the ability to filter all active markets for a cryptocurrency to specific base/quote pairs. Want to return only `BTC/USD` and `BTC/USDT` markets? Just pass `?symbol=BTC&matched_symbol=USD,USDT` or `?id=1&matched_id=2781,825`. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) now features `sort` options including `cmc_rank` to reproduce the [methodology](https://coinmarketcap.com/methodology/) based sort on pages like [Bitcoin Markets](https://coinmarketcap.com/currencies/bitcoin/#markets) . * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) can now return any exchange level CMC notices affecting a market via the new `notice` `aux` parameter. * [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) will now continue to return the last updated price data for cryptocurrency that have transitioned to an `inactive` state instead of returning an HTTP 400 error. These active coins that have gone inactive can easily be identified as having a `num_market_pairs` of `0` and a stale `last_updated` date. * [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) now includes a brief text summary for most exchanges as `description`. ### v1.16.0 on Aug 9, 2019 * We've introduced a new [partners](https://coinmarketcap.com/api/documentation/v1/#tag/partners) category of endpoints for convenient access to 3rd party crypto data. [FlipSide Crypto](https://www.flipsidecrypto.com/) 's [Fundamental Crypto Asset Score](https://www.flipsidecrypto.com/fcas-explained) (FCAS) is now available as the first partner integration. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now provides a `volume_24h_min` filter parameter. It can be used when a threshold of volume is required like in our [Biggest Gainers and Losers](https://coinmarketcap.com/gainers-losers/) lists. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) can now return rolling `volume_7d` and `volume_30d` via the supplemental `aux` parameter and sort options by these fields. * `volume_24h_reported`, `volume_7d_reported`, `volume_30d_reported`, and `market_cap_by_total_supply` are also now available through the `aux` parameter with an additional sort option for the latter. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) can now provide market price relative to the quote currency. Just pass `price_quote` to the supplemental `aux` parameter. This can be used to display consistent price data for a cryptocurrency across several markets no matter if it is the base or quote in each pair as seen in our [Bitcoin markets](https://coinmarketcap.com/currencies/bitcoin/#markets) price column. * When requesting a custom `sort` on our list based endpoints, numeric fields like `percent_change_7d` now conveniently return non-applicable `null` values last regardless of sort order. ### v1.15.0 on Jul 10, 2019 * [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) and [/v1/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) now expose a 3rd listing state of `untracked` between `active` and `inactive` as outlined in our [methodology](https://coinmarketcap.com/methodology/) . See endpoint documentation for additional details. * [/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) , [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) , and [/exchange/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) now support fetching multiple cryptocurrencies and exchanges in the same call. * [/global-metrics/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesLatest) now updates more frequently, every minute. It aslo now includes `total_volume_24h_reported`, `altcoin_volume_24h`, `altcoin_volume_24h_reported`, and `altcoin_market_cap`. * [/global-metrics/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesHistorical) also includes these new dimensions along with historical `active_cryptocurrencies`, `active_exchanges`, and `active_market_pairs` counts. * We've also added a new `aux` auxiliary parameter to many endpoints which can be used to customize your request. You may request new supplemental data properties that are not returned by default or slim down your response payload by excluding default `aux` fields you don't need in endpoints like [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) . [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) and [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) can now supply `market_url`, `currency_name`, and `currency_slug` for each market using this new parameter. [/exchange/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) can now include the exchange `date_launched`. ### v1.14.1 on Jun 14, 2019 - DATA: Phase 1 methodology updates Per our [May 1 announcement](https://blog.coinmarketcap.com/2019/05/01/happy-6th-birthday-data-alliance-block-explorers-and-more/) of the Data Accountability & Transparency Alliance ([DATA](https://coinmarketcap.com/data-transparency-alliance/) ), a platform [methodology](https://coinmarketcap.com/methodology/) update was published. No API changes are required but users should take note: * Exchanges that are not compliant with mandatory transparency requirements (Ability to surface live trade and order book data) will be excluded from VWAP price and volume calculations returned from our `/cryptocurrency/` and `/global-metrics/` endpoints going forward. * These exchanges will also return a `volume_24h_adjusted` value of 0 from our `/exchange/` endpoints like the exclusions based on market category and fee type. Stale markets (24h or older) will also be excluded. All exchanges will continue to return `exchange_reported` values as reported. * We welcome you to [learn more about the DATA alliance and become a partner](https://coinmarketcap.com/data-transparency-alliance/) . ### v1.14.0 on Jun 3, 2019 * [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) now include up to 5 block explorer URLs for each cryptocurrency including our brand new [Bitcoin and Ethereum Explorers](https://blockchain.coinmarketcap.com/) . * [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) now provides links to most cryptocurrency white papers and technical documentation! Just reference the `technical_doc` array. * [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) now returns a `notice` property that may highlight a significant event or condition that is impacting the cryptocurrency or how it is displayed. See the endpoint property description for more details. * [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) also includes a `notice` property. This one may highlight a condition that is impacting the availability of an exchange's market data or the use of the exchange. See the endpoint property description for more details. * [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) now includes the official launch date for each exchange as `date_launched`. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) and [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) now include market `category` (Spot, Derivatives, or OTC) and `fee_type` (Percentage, No Fees, Transactional Mining, or Unknown) for every market returned. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) now supports querying by cryptocurrency `slug`. * [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) now includes a `market_cap_strict` sort option to apply a strict numeric sort on this field. ### v1.13.0 on May 17, 2019 * You may now leverage CoinMarketCap IDs for currency `quote` conversions across all endpoints! Just utilize the new `convert_id` parameter instead of the `convert` parameter. Learn more about creating robust integrations with CMC IDs in our [Best Practices](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) . * We've updated requesting cryptocurrencies by `slug` to support legacy names from past cryptocurrency rebrands. For example, a request to `/cryptocurrency/quotes/latest?slug=antshares` successfully returns the cryptocurrency by current slug `neo`. * We've extended the brief text summary included as `description` in [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) to now cover all cryptocurrencies! * We've added the fetch-by-slug option to [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) . * Premium subscription users: On your next billing period we'll conveniently switch to displaying monthly/daily credit usage relative to your monthly billing period instead of calendar month and UTC midnight. Click the `?` on our updated [API Key Usage](https://pro.coinmarketcap.com/account) panel for more details. ### v1.12.1 on May 1, 2019 * To celebrate CoinMarketCap's 6th anniversary we've upgraded the crypto API to make more of our data available at each tier! * Our free Basic tier may now access live price conversions via [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) . * Our Hobbyist tier now supports a month of historical price conversions with [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) using the `time` parameter. We've also made this plan 12% cheaper at $29/mo with a yearly subscription or $35/mo month-to-month. * Our Startup tier can now access a month of cryptocurrency OHLCV data via [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) along with [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) . * Our Standard tier has been upgraded from 1 month to now 3 months of historical market data access across all historical endpoints. * Our Enterprise, Professional, and Standard tiers now get access to a new #18th endpoint [/cryptocurrency/listings/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsHistorical) ! Utilize this endpoint to fetch daily historical crypto rankings from the past. We've made historical ranking snapshots available all the way back to 2013! * All existing accounts and subscribers may take advantage of these updates. If you haven't signed up yet you can check out our updated plans on our [feature comparison page](https://coinmarketcap.com/api/features/) . ### v1.12.0 on Apr 28, 2019 * Our API docs now supply API request examples in 7 languages for every endpoint: cURL, Node.js, Python, PHP, Java, C#, and Go. * Many customer sites format cryptocurrency data page URLs by SEO friendly names like we do here: [coinmarketcap.com/currencies/binance-coin](https://coinmarketcap.com/currencies/binance-coin/) . We've made it much easier for these kinds of pages to dynamically reference data from our API. You may now request cryptocurrencies from our [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) and [/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) endpoints by `slug` as an alternative to `symbol` or `id`. As always, you can retrieve a quick list of every cryptocurrency we support and it's `id`, `symbol`, and `slug` via our [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) endpoint. * We've increased `convert` limits on historical endpoints once more. You can now request historical market data in up to 3 conversion options at a time like we do internally to display line charts [like this](https://coinmarketcap.com/currencies/0x/#charts) . You can now fetch market data converted into your primary cryptocurrency, fiat currency, and a parent platform cryptocurrency (Ethereum in this case) all in one call! ### v1.11.0 on Mar 25, 2019 * We now supply a brief text summary for each cryptocurrency in the `description` field of [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) . The majority of top cryptocurrencies include this field with more coming in the future. * We've made `convert` limits on some endpoints and plans more flexible. Historical endpoints are now allowed 2 price conversion options instead of 1. Professional plan convert limit has doubled from 40 to 80. Enterprise has tripled from 40 to 120. * CoinMarketCap Market ID: We now return `market_id` in /market-pairs/latest endpoints. Like our cryptocurrency and exchange IDs, this ID can reliably be used to uniquely identify each market _permanently_ as this ID never changes. * Market symbol overrides: We now supply an `exchange_symbol` in addition to `currency_symbol` for each market pair returned in our /market-pairs/latest endpoints. This allows you to reference the currency symbol provided by the exchange in case it differs from the CoinMarketCap identified symbol that the majority of markets use. ### v1.10.1 on Jan 30, 2019 * Our API health status dashboard is now public at [http://status.coinmarketcap.com](http://status.coinmarketcap.com/) . * We now conveniently return `market_cap` in our [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) endpoint so you don't have to make a separately query when fetching historic OHLCV data. * We've improved the accuracy of percent\_change\_1h / 24h / 7d calculations when using the `convert` option with our latest cryptocurrency endpoints. * [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) now updates more frequently, every 1 minute. * Contract Address and parent platform metadata changes are reflected on the API much more quickly. ### v1.9.0 on Jan 8, 2019 * Did you know there are currently 684 active USD market pairs tracked by CoinMarketCap? You can now pass any [fiat CoinMarketCap ID](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) to the [/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMarketpairsLatest) `id` parameter to list all active markets across all exchanges for a given fiat currency. * We've added a new dedicated migration FAQ page for users migrating from our old Public API to the new API [here](https://pro.coinmarketcap.com/migrate) . It includes a helpful tutorial link for Excel and Google Sheets users who need help migrating. * Cryptocurrency and exchange symbol and name rebrands are now reflected in the API much more quickly. ### v1.8.0 on Dec 27, 2018 * We now supply the contract address for all cryptocurrencies on token platforms like Ethereum! Look for `token_address` in the `platform` property of our cryptocurrency endpoints like [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) and [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) . * All 96 non-USD fiat conversion rates now update every 1 minute like our USD rates! This includes using the `convert` option for all /latest market data endpoints as well as our [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) endpoint. ### v1.7.0 on Dec 18, 2018 * We've upgraded our fiat (government) currency conversion support from our original 32 to now cover 93 fiat currencies! * We've also introduced currency conversions for four precious metals: Gold, Silver, Platinum, and Palladium! * You may pass all 97 fiat currency options to our [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) endpoint using either the `symbol` or `id` parameter. Using CMC `id` is always the most robust option. CMC IDs are now included in the full list of fiat options located [here](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . * All historical endpoints including our price conversion endpoint with "time" parameter now support historical fiat conversions back to 2013! ### v1.6.0 on Dec 4, 2018 * We've rolled out another top requested feature, giving you access to platform metadata for cryptocurrencies that are tokens built on other cryptocurrencies like Ethereum. Look for the new `platform` property on our cryptocurrency endpoints like [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) and [/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) . * We've also added a **CMC equivalent pages** section to our endpoint docs so you can easily determine which endpoints to use to reproduce functionality on the main coinmarketcap.com website. * Welcome Public API users! With the migration of our legacy Public API into the Professional API we now have 1 unified API at CMC. This API is now known as the CoinMarketCap API and can always be accessed at [coinmarketcap.com/api](https://coinmarketcap.com/api) . ### v1.5.0 on Nov 28, 2018 * [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) now supports hourly OHLCV! Use time\_period="hourly" and don't forget to set the "interval" parameter to "hourly" or one of the new hourly interval options. * [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) now supports historical USD conversions. * We've increased the minute based rate limits for several plans. Standard plan has been upgraded from 30 to 60 calls per minute. Professional from 60 to 90. Enterprise from 90 to 120. * We now include some customer and data partner logos and testimonials on the CoinMarketCap API site. Visit [pro.coinmarketcap.com](http://pro.coinmarketcap.com/) to check out what our enterprise customers are saying and contact us at [api@coinmarketcap.com](mailto:api@coinmarketcap.com) if you'd like to get added to the list! ### v1.4.0 on Nov 20, 2018 * [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) can now provide the latest crypto-to-crypto conversions at 1 minute accuracy with extended decimal precision upwards of 8 decimal places. * [/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPriceconversion) now supports historical crypto-to-crypto conversions leveraging our closest averages to the specified "time" parameter. * All of our historical data endpoints now support historical cryptocurrency conversions using the "convert" parameter. The closest reference price for each "convert" option against each historical datapoint is used for each conversion. * [/global-metrics/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesHistorical) now supports the "convert" parameter. ### v1.3.0 on Nov 9, 2018 * The latest UTC day's OHLCV record is now available sooner. 5-10 minutes after each UTC midnight. * We're now returning a new `vol_24h_adjusted` property on [/exchange/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) and [/exchange/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) and a sort option for the latter so you may now list exchange rankings by CMC adjusted volume as well as exchange reported. * We are now returning a `tags` property with [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) with our first tag `mineable` so you know which currencies are mineable. Additional tags will be introduced in the future. * We've increased the "convert" parameter limit from 32 to 40 for plans that support max conversion limits. ### v1.2.0 on Oct 30, 2018 * Our exchange [listing](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) and [quotes](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) endpoints now update much more frequently! Every 1 minute instead of every 5 minutes. * These latest exchange data endpoints also now return `volume_7d / 30d` and `percent_change_volume_24h / 7d / 30d` along with existing data. * We've updated our documentation for [/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) to reflect that it receives updates every 1 minute, not 5, since June. ### v1.1.4 on Oct 19, 2018 * We've improved our tiered support inboxes by plan type to answer support requests even faster. * You may now opt-in to our API mailing list on signup. If you haven't signed up you can [here](https://coinmarketcap.com/#newsletter-signup) . ### v1.1.3 on Oct 12, 2018 * We've increased the rate limit of our free Basic plan from 10 calls a minute to 30. * We've increased the rate limit of our Hobbyist plan from 15 to 30. ### v1.1.2 on Oct 5, 2018 * We've updated our most popular /cryptocurrency/listings/latest endpoint to cost 1 credit per 200 data points instead of 100 to give customers more flexibility. * By popular request we've introduced a new $33 personal use Hobbyist tier with access to our currency conversion calculator endpoint. * Our existing commercial use Hobbyist tier has been renamed to Startup. Our free Starter tier has been renamed to Basic. ### v1.1.1 on Sept 28, 2018 * We've increased our monthly credit limits for our smaller plans! Existing customers plans have also been updated. * Our free Starter plan has been upgraded from 6 to 10k monthly credits (66% increase). * Our Hobbyist plan has been upgraded from 60k to 120k monthly credits (100% increase). * Our Standard plan has been upgraded from 300 to 500k monthly credits (66% increase). ### v1.1.0 on Sept 14, 2018 * We've introduced our first new endpoint since rollout, active day OHLCV for Standard plan and above with [/v1/cryptocurrency/ohlcv/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvLatest) ### v1.0.4 on Sept 7, 2018 * Subscription customers with billing renewal issues now receive an alert from our API during usage and an unpublished grace period before access is restricted. * API Documentation has been improved including an outline of credit usage cost outlined on each endpoint documentation page. ### v1.0.3 on Aug 24, 2018 * /v1/tools/price-conversion floating point conversion accuracy was improved. * Added ability to query for non-alphanumeric crypto symbols like $PAC * Customers may now update their billing card on file with an active Stripe subscription at pro.coinmarketcap.com/account/plan [](https://coinmarketcap.com/api/documentation/v1/#tag/cryptocurrency) cryptocurrency ===================================================================================== ##### API endpoints for cryptocurrencies. This category currently includes 17 endpoints: * [/v1/cryptocurrency/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) - CoinMarketCap ID map * [/v2/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyInfo) - Metadata * [/v1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) - Latest listings * [/v1/cryptocurrency/listings/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsHistorical) - Historical listings * [/v2/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) - Latest quotes * [/v2/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesHistorical) - Historical quotes * [/v2/cryptocurrency/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyMarketpairsLatest) - Latest market pairs * [/v2/cryptocurrency/ohlcv/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvLatest) - Latest OHLCV * [/v2/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvHistorical) - Historical OHLCV * [/v2/cryptocurrency/price-performance-stats/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyPriceperformancestatsLatest) - Price performance Stats * [/v1/cryptocurrency/categories](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategories) - Categories * [/v1/cryptocurrency/category](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategory) - Category * [/v1/cryptocurrency/airdrops](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrops) - Airdrops * [/v1/cryptocurrency/airdrop](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrop) - Airdrop * [/v1/cryptocurrency/trending/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) - Trending Latest * [/v1/cryptocurrency/trending/most-visited](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostvisited) - Trending Most Visited * [/v1/cryptocurrency/trending/gainers-losers](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainerslosers) - Trending Gainers & Losers [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrop) Airdrop ------------------------------------------------------------------------------------------------ Returns information about a single airdrop available on CoinMarketCap. Includes the cryptocurrency metadata. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request no matter query size. **CMC equivalent pages:** Our free airdrops page [coinmarketcap.com/airdrop/](https://coinmarketcap.com/airdrop/) . ##### Parameters id string Required Airdrop Unique ID. This can be found using the Airdrops API. Responses --------- 200 Successful | | | | --- | --- | | data null | Airdrop%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/airdrop Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/airdrop * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": "60e59b99c8ca1d58514a2322", * "project\_name": "DeRace Airdrop", * "description": "For 7 days starting from August 15, 2021, CoinMarketCap will host an Airdrop event...", * "status": "UPCOMING", * "coin": { * "id": 10744, * "name": "DeRace", * "slug": "derace", * "symbol": "DERC" }, * "start\_date": "2021-06-01T22:11:00.000Z", * "end\_date": "2021-07-01T22:11:00.000Z", * "total\_prize": 20000000000, * "winner\_count": 1000, * "link": "[https://coinmarketcap.com/currencies/derace/airdrop/](https://coinmarketcap.com/currencies/derace/airdrop/) " }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyAirdrops) Airdrops -------------------------------------------------------------------------------------------------- Returns a list of past, present, or future airdrops which have run on CoinMarketCap. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request no matter query size. **CMC equivalent pages:** Our free airdrops page [coinmarketcap.com/airdrop/](https://coinmarketcap.com/airdrop/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. status string "ONGOING" "ENDED" "ONGOING" "UPCOMING" What status of airdrops. id string ^\\d\*$ Filtered airdrops by one cryptocurrency CoinMarketCap IDs. Example: 1 slug string ^\[0-9a-z-\]\*$ Alternatively filter airdrops by a cryptocurrency slug. Example: "bitcoin" symbol string ^\[0-9A-Za-z$@\\-\]\*$ Alternatively filter airdrops one cryptocurrency symbol. Example: "BTC". Responses --------- 200 Successful | | | | --- | --- | | data null | Airdrops%20-%20Airdrop%20Object Required

Array of airdrop object results. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/airdrops Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/airdrops * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": "60e59b99c8ca1d58514a2322",\ \ * "project\_name": "DeRace Airdrop",\ \ * "description": "For 7 days starting from August 15, 2021, CoinMarketCap will host an Airdrop event...",\ \ * "status": "UPCOMING",\ \ * "coin": \ \ {\ \ * "id": 10744,\ \ * "name": "DeRace",\ \ * "slug": "derace",\ \ * "symbol": "DERC"\ \ \ },\ \ * "start\_date": "2021-06-01T22:11:00.000Z",\ \ * "end\_date": "2021-07-01T22:11:00.000Z",\ \ * "total\_prize": 20000000000,\ \ * "winner\_count": 1000,\ \ * "link": "[https://coinmarketcap.com/currencies/derace/airdrop/](https://coinmarketcap.com/currencies/derace/airdrop/)\ "\ \ \ }\ \ \ \], * "status": { * "timestamp": "2021-08-01T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 3, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategories) Categories ------------------------------------------------------------------------------------------------------ Returns information about all coin categories available on CoinMarketCap. Includes a paginated list of cryptocurrency quotes and metadata from each category. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Free * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request + 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our free airdrops page [coinmarketcap.com/cryptocurrency-category/](https://coinmarketcap.com/cryptocurrency-category/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. id string ^\\d+(?:,\\d+)\*$ Filtered categories by one or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2 slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively filter categories by a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively filter categories one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". Responses --------- 200 Successful | | | | --- | --- | | data null | Categories%20-%20Category%20object Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/categories Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/categories * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": "605e2ce9d41eae1066535f7c",\ \ * "name": "A16Z Portfolio",\ \ * "title": "A16Z Portfolio",\ \ * "description": "A16Z Portfolio",\ \ * "num\_tokens": 12,\ \ * "avg\_price\_change": 0.61305157,\ \ * "market\_cap": 29429241867.031097,\ \ * "market\_cap\_change": 3.049044106496,\ \ * "volume": 4103706600.0391645,\ \ * "volume\_change": \-10.538325849854,\ \ * "last\_updated": 1616488708878\ \ \ }\ \ \ \], * "status": { * "timestamp": "2021-08-01T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 3, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyCategory) Category -------------------------------------------------------------------------------------------------- Returns information about a single coin category available on CoinMarketCap. Includes a paginated list of the cryptocurrency quotes and metadata for the category. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Free * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request + 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our Cryptocurrency Category page [coinmarketcap.com/cryptocurrency-category/](https://coinmarketcap.com/cryptocurrency-category/) . ##### Parameters id string Required The Category ID. This can be found using the Categories API. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of coins to return. limit integer \[ 1 .. 1000 \] 100 Optionally specify the number of coins to return. Use this parameter and the "start" parameter to determine your own pagination size. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Category%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/category Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/category * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": "605e2ce9d41eae1066535f7c", * "name": "A16Z Portfolio", * "title": "A16Z Portfolio", * "description": "A16Z Portfolio", * "num\_tokens": 12, * "avg\_price\_change": 0.61305157, * "market\_cap": 29429241867.031097, * "market\_cap\_change": 3.049044106496, * "volume": 4103706600.0391645, * "volume\_change": \-10.538325849854, * "coins": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "last\_updated": 1616488708878 }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) CoinMarketCap ID Map --------------------------------------------------------------------------------------------------------- Returns a mapping of all cryptocurrencies to unique CoinMarketCap `id`s. Per our [Best Practices](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) we recommend utilizing CMC ID instead of cryptocurrency symbols to securely identify cryptocurrencies with our other endpoints and in your own application logic. Each cryptocurrency returned includes typical identifiers such as `name`, `symbol`, and `token_address` for flexible mapping to `id`. By default this endpoint returns cryptocurrencies that have actively tracked markets on supported exchanges. You may receive a map of all inactive cryptocurrencies by passing `listing_status=inactive`. You may also receive a map of registered cryptocurrency projects that are listed but do not yet meet methodology requirements to have tracked markets via `listing_status=untracked`. Please review our [methodology documentation](https://coinmarketcap.com/methodology/) for additional details on listing states. Cryptocurrencies returned include `first_historical_data` and `last_historical_data` timestamps to conveniently reference historical date ranges available to query with historical time-series data endpoints. You may also use the `aux` parameter to only include properties you require to slim down the payload if calling this endpoint frequently. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Basic * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Mapping data is updated only as needed, every 30 seconds. **Plan credit use:** 1 API call credit per request no matter query size. **CMC equivalent pages:** No equivalent, this data is only available via API. ##### Parameters listing\_status string "active" ^(active|inactive|untracked)+(?:,(active|inactive|untracked)+)\*$ Only active cryptocurrencies are returned by default. Pass `inactive` to get a list of cryptocurrencies that are no longer active. Pass `untracked` to get a list of cryptocurrencies that are listed but do not yet meet methodology requirements to have tracked markets available. You may pass one or more comma-separated values. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. sort string "id" "cmc\_rank" "id" What field to sort the list of cryptocurrencies by. symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Optionally pass a comma-separated list of cryptocurrency symbols to return CoinMarketCap IDs for. If this option is passed, other options will be ignored. aux string "platform,first\_historical\_data,last\_historical\_data,is\_active" ^(platform|first\_historical\_data|last\_historical\_data|is\_active|status)+(?:,(platform|first\_historical\_data|last\_historical\_data|is\_active|status)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `platform,first_historical_data,last_historical_data,is_active,status` to include all auxiliary fields. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Map%20-%20Cryotocurrency%20Object Required

Array of cryptocurrency object results. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/map Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/map * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "rank": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "is\_active": 1,\ \ * "first\_historical\_data": "2013-04-28T18:47:21.000Z",\ \ * "last\_historical\_data": "2020-05-05T20:44:01.000Z",\ \ * "platform": null\ \ \ },\ \ * {\ \ * "id": 1839,\ \ * "rank": 3,\ \ * "name": "Binance Coin",\ \ * "symbol": "BNB",\ \ * "slug": "binance-coin",\ \ * "is\_active": 1,\ \ * "first\_historical\_data": "2017-07-25T04:30:05.000Z",\ \ * "last\_historical\_data": "2020-05-05T20:44:02.000Z",\ \ * "platform": \ \ {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "token\_address": "0xB8c77482e45F1F44dE1745F52C74426C631bDD52"\ \ \ }\ \ \ },\ \ * {\ \ * "id": 825,\ \ * "rank": 5,\ \ * "name": "Tether",\ \ * "symbol": "USDT",\ \ * "slug": "tether",\ \ * "is\_active": 1,\ \ * "first\_historical\_data": "2015-02-25T13:34:26.000Z",\ \ * "last\_historical\_data": "2020-05-05T20:44:01.000Z",\ \ * "platform": \ \ {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "token\_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyInfo) Metadata v2 ------------------------------------------------------------------------------------------------- Returns all static metadata available for one or more cryptocurrencies. This information includes details like logo, description, official website URL, social links, and links to a cryptocurrency's technical documentation. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Basic * Startup * Hobbyist * Standard * Professional * Enterprise **Cache / Update frequency:** Static data is updated only as needed, every 30 seconds. **Plan credit use:** 1 call credit per 100 cryptocurrencies returned (rounded up). **CMC equivalent pages:** Cryptocurrency detail page metadata like [coinmarketcap.com/currencies/bitcoin/](https://coinmarketcap.com/currencies/bitcoin/) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "slug" _or_ "symbol" is required for this request. Please note that starting in the v2 endpoint, due to the fact that a symbol is not unique, if you request by symbol each data response will contain an array of objects containing all of the coins that use each requested symbol. The v1 endpoint will still return a single object, the highest ranked coin using that symbol. address string Alternatively pass in a contract address. Example: "0xc40af1e4fecfa05ce6bab79dcd8b373d2e436c4e" skip\_invalid boolean false Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if any invalid cryptocurrencies are requested or a cryptocurrency does not have matching records in the requested timeframe. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. aux string "urls,logo,description,tags,platform,date\_added,notice" ^(urls|logo|description|tags|platform|date\_added|notice|status)+(?:,(urls|logo|description|tags|platform|date\_added|notice|status)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `urls,logo,description,tags,platform,date_added,notice,status` to include all auxiliary fields. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Info%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/info Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/info * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "1": { * "urls": { * "website": \[\ \ * "[https://bitcoin.org/](https://bitcoin.org/)\ "\ \ \ \], * "technical\_doc": \[\ \ * "[https://bitcoin.org/bitcoin.pdf](https://bitcoin.org/bitcoin.pdf)\ "\ \ \ \], * "twitter": \[ \], * "reddit": \[\ \ * "[https://reddit.com/r/bitcoin](https://reddit.com/r/bitcoin)\ "\ \ \ \], * "message\_board": \[\ \ * "[https://bitcointalk.org](https://bitcointalk.org/)\ "\ \ \ \], * "announcement": \[ \], * "chat": \[ \], * "explorer": \[\ \ * "[https://blockchain.coinmarketcap.com/chain/bitcoin](https://blockchain.coinmarketcap.com/chain/bitcoin)\ ",\ \ * "[https://blockchain.info/](https://blockchain.info/)\ ",\ \ * "[https://live.blockcypher.com/btc/](https://live.blockcypher.com/btc/)\ "\ \ \ \], * "source\_code": \[\ \ * "[https://github.com/bitcoin/](https://github.com/bitcoin/)\ "\ \ \ \] }, * "logo": "[https://s2.coinmarketcap.com/static/img/coins/64x64/1.png](https://s2.coinmarketcap.com/static/img/coins/64x64/1.png) ", * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "slug": "bitcoin", * "description": "Bitcoin (BTC) is a consensus network that enables a new payment system and a completely digital currency. Powered by its users, it is a peer to peer payment network that requires no central authority to operate. On October 31st, 2008, an individual or group of individuals operating under the pseudonym "Satoshi Nakamoto" published the Bitcoin Whitepaper and described it as: "a purely peer-to-peer version of electronic cash would allow online payments to be sent directly from one party to another without going through a financial institution."", * "date\_added": "2013-04-28T00:00:00.000Z", * "date\_launched": "2013-04-28T00:00:00.000Z", * "tags": \[\ \ * "mineable"\ \ \ \], * "platform": null, * "category": "coin" }, * "1027": { * "urls": { * "website": \[\ \ * "[https://www.ethereum.org/](https://www.ethereum.org/)\ "\ \ \ \], * "technical\_doc": \[\ \ * "[https://github.com/ethereum/wiki/wiki/White-Paper](https://github.com/ethereum/wiki/wiki/White-Paper)\ "\ \ \ \], * "twitter": \[\ \ * "[https://twitter.com/ethereum](https://twitter.com/ethereum)\ "\ \ \ \], * "reddit": \[\ \ * "[https://reddit.com/r/ethereum](https://reddit.com/r/ethereum)\ "\ \ \ \], * "message\_board": \[\ \ * "[https://forum.ethereum.org/](https://forum.ethereum.org/)\ "\ \ \ \], * "announcement": \[\ \ * "[https://bitcointalk.org/index.php?topic=428589.0](https://bitcointalk.org/index.php?topic=428589.0)\ "\ \ \ \], * "chat": \[\ \ * "[https://gitter.im/orgs/ethereum/rooms](https://gitter.im/orgs/ethereum/rooms)\ "\ \ \ \], * "explorer": \[\ \ * "[https://blockchain.coinmarketcap.com/chain/ethereum](https://blockchain.coinmarketcap.com/chain/ethereum)\ ",\ \ * "[https://etherscan.io/](https://etherscan.io/)\ ",\ \ * "[https://ethplorer.io/](https://ethplorer.io/)\ "\ \ \ \], * "source\_code": \[\ \ * "[https://github.com/ethereum](https://github.com/ethereum)\ "\ \ \ \] }, * "logo": "[https://s2.coinmarketcap.com/static/img/coins/64x64/1027.png](https://s2.coinmarketcap.com/static/img/coins/64x64/1027.png) ", * "id": 1027, * "name": "Ethereum", * "symbol": "ETH", * "slug": "ethereum", * "description": "Ethereum (ETH) is a smart contract platform that enables developers to build decentralized applications (dapps) conceptualized by Vitalik Buterin in 2013. ETH is the native currency for the Ethereum platform and also works as the transaction fees to miners on the Ethereum network. Ethereum is the pioneer for blockchain based smart contracts. When running on the blockchain a smart contract becomes like a self-operating computer program that automatically executes when specific conditions are met. On the blockchain, smart contracts allow for code to be run exactly as programmed without any possibility of downtime, censorship, fraud or third-party interference. It can facilitate the exchange of money, content, property, shares, or anything of value. The Ethereum network went live on July 30th, 2015 with 72 million Ethereum premined.", * "notice": null, * "date\_added": "2015-08-07T00:00:00.000Z", * "date\_launched": "2015-08-07T00:00:00.000Z", * "tags": \[\ \ * "mineable"\ \ \ \], * "platform": null, * "category": "coin", * "self\_reported\_circulating\_supply": null, * "self\_reported\_market\_cap": null, * "self\_reported\_tags": null, * "infinite\_supply": false } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsHistorical) Listings Historical ----------------------------------------------------------------------------------------------------------------------- Returns a ranked and sorted list of all cryptocurrencies for a historical UTC date. **Technical Notes** * This endpoint is identical in format to our [/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) endpoint but is used to retrieve historical daily ranking snapshots from the end of each UTC day. * Daily snapshots reflect market data at the end of each UTC day and may be requested as far back as 2013-04-28 (as supported by your plan's historical limits). * The required "date" parameter can be passed as a Unix timestamp or ISO 8601 date but only the date portion of the timestamp will be referenced. It is recommended to send an ISO date format like "2019-10-10" without time. * This endpoint is for retrieving paginated and sorted lists of all currencies. If you require historical market data on specific cryptocurrencies you should use [/cryptocurrency/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesHistorical) . Cryptocurrencies are listed by cmc\_rank by default. You may optionally sort against any of the following: **cmc\_rank**: CoinMarketCap's market cap rank as outlined in [our methodology](https://coinmarketcap.com/methodology/) . **name**: The cryptocurrency name. **symbol**: The cryptocurrency symbol. **market\_cap**: market cap (latest trade price x circulating supply). **price**: latest average trade price across markets. **circulating\_supply**: approximate number of coins currently in circulation. **total\_supply**: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned). **max\_supply**: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency. **num\_market\_pairs**: number of market pairs across all exchanges trading each currency. **volume\_24h**: 24 hour trading volume for each currency. **percent\_change\_1h**: 1 hour trading price percentage change for each currency. **percent\_change\_24h**: 24 hour trading price percentage change for each currency. **percent\_change\_7d**: 7 day trading price percentage change for each currency. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * Hobbyist (1 month) * Startup (1 month) * Standard (3 month) * Professional (12 months) * Enterprise (Up to 6 years) **Cache / Update frequency:** The last completed UTC day is available 30 minutes after midnight on the next UTC day. **Plan credit use:** 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our historical daily crypto ranking snapshot pages like this one on [February 02, 2014](https://coinmarketcap.com/historical/20140202/) . ##### Parameters date string Required date (Unix or ISO 8601) to reference day of snapshot. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. sort string "cmc\_rank" "cmc\_rank" "name" "symbol" "market\_cap" "price" "circulating\_supply" "total\_supply" "max\_supply" "num\_market\_pairs" "volume\_24h" "percent\_change\_1h" "percent\_change\_24h" "percent\_change\_7d" What field to sort the list of cryptocurrencies by. sort\_dir string "asc" "desc" The direction in which to order cryptocurrencies against the specified sort. cryptocurrency\_type string "all" "all" "coins" "tokens" The type of cryptocurrency to include. aux string "platform,tags,date\_added,circulating\_supply,total\_supply,max\_supply,cmc\_rank,num\_market\_pairs" ^(platform|tags|date\_added|circulating\_supply|total\_supply|max\_supply|cmc\_rank|num\_market\_pairs)+(?:,(platform|tags|date\_added|circulating\_supply|total\_supply|max\_supply|cmc\_rank|num\_market\_pairs)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `platform,tags,date_added,circulating_supply,total_supply,max_supply,cmc_rank,num_market_pairs` to include all auxiliary fields. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Listings%20Latest%20-%20Cryptocurrency%20object Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/listings/historical Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 1,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 17200062,\ \ * "total\_supply": 17200062,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6089,\ \ * "circulating\_supply": 17200062,\ \ * "total\_supply": 17200062,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1678.6501384942708,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2019-04-02T22:44:24.200Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) Listings Latest --------------------------------------------------------------------------------------------------------------- Returns a paginated list of all active cryptocurrencies with latest market data. The default "market\_cap" sort returns cryptocurrency in order of CoinMarketCap's market cap rank (as outlined in [our methodology](https://coinmarketcap.com/methodology/) ) but you may configure this call to order by another market ranking field. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call. You may sort against any of the following: **market\_cap**: CoinMarketCap's market cap rank as outlined in [our methodology](https://coinmarketcap.com/methodology/) . **market\_cap\_strict**: A strict market cap sort (latest trade price x circulating supply). **name**: The cryptocurrency name. **symbol**: The cryptocurrency symbol. **date\_added**: Date cryptocurrency was added to the system. **price**: latest average trade price across markets. **circulating\_supply**: approximate number of coins currently in circulation. **total\_supply**: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned). **max\_supply**: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency. **num\_market\_pairs**: number of market pairs across all exchanges trading each currency. **market\_cap\_by\_total\_supply\_strict**: market cap by total supply. **volume\_24h**: rolling 24 hour adjusted trading volume. **volume\_7d**: rolling 24 hour adjusted trading volume. **volume\_30d**: rolling 24 hour adjusted trading volume. **percent\_change\_1h**: 1 hour trading price percentage change for each currency. **percent\_change\_24h**: 24 hour trading price percentage change for each currency. **percent\_change\_7d**: 7 day trading price percentage change for each currency. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Basic * Hobbyist * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our latest cryptocurrency listing and ranking pages like [coinmarketcap.com/all/views/all/](https://coinmarketcap.com/all/views/all/) , [coinmarketcap.com/tokens/](https://coinmarketcap.com/tokens/) , [coinmarketcap.com/gainers-losers/](https://coinmarketcap.com/gainers-losers/) , [coinmarketcap.com/new/](https://coinmarketcap.com/new/) . _**NOTE:** Use this endpoint if you need a sorted and paginated list of all cryptocurrencies. If you want to query for market data on a few specific cryptocurrencies use [/v1/cryptocurrency/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyQuotesLatest) which is optimized for that purpose. The response data between these endpoints is otherwise the same._ ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. price\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum USD price to filter results by. price\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum USD price to filter results by. market\_cap\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum market cap to filter results by. market\_cap\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum market cap to filter results by. volume\_24h\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum 24 hour USD volume to filter results by. volume\_24h\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum 24 hour USD volume to filter results by. circulating\_supply\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum circulating supply to filter results by. circulating\_supply\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum circulating supply to filter results by. percent\_change\_24h\_min number \>= -100 Optionally specify a threshold of minimum 24 hour percent change to filter results by. percent\_change\_24h\_max number \>= -100 Optionally specify a threshold of maximum 24 hour percent change to filter results by. self\_reported\_circulating\_supply\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum self reported circulating supply to filter results by. self\_reported\_circulating\_supply\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum self reported circulating supply to filter results by. self\_reported\_market\_cap\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum self reported market cap to filter results by. self\_reported\_market\_cap\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum self reported market cap to filter results by. unlocked\_market\_cap\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum unlocked market cap to filter results by. unlocked\_market\_cap\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum unlocked market cap to filter results by. unlocked\_circulating\_supply\_min number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of minimum unlocked circulating supply to filter results by. unlocked\_circulating\_supply\_max number \[ 0 .. 100000000000000000 \] Optionally specify a threshold of maximum unlocked circulating supply to filter results by. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. sort string "market\_cap" "name" "symbol" "date\_added" "market\_cap" "market\_cap\_strict" "price" "circulating\_supply" "total\_supply" "max\_supply" "num\_market\_pairs" "volume\_24h" "percent\_change\_1h" "percent\_change\_24h" "percent\_change\_7d" "market\_cap\_by\_total\_supply\_strict" "volume\_7d" "volume\_30d" What field to sort the list of cryptocurrencies by. sort\_dir string "asc" "desc" The direction in which to order cryptocurrencies against the specified sort. cryptocurrency\_type string "all" "all" "coins" "tokens" The type of cryptocurrency to include. tag string "all" "all" "defi" "filesharing" The tag of cryptocurrency to include. aux string "num\_market\_pairs,cmc\_rank,date\_added,tags,platform,max\_supply,circulating\_supply,total\_supply" ^(num\_market\_pairs|cmc\_rank|date\_added|tags|platform|max\_supply|circulating\_supply|total\_supply|market\_cap\_by\_total\_supply|volume\_24h\_reported|volume\_7d|volume\_7d\_reported|volume\_30d|volume\_30d\_reported|is\_market\_cap\_included\_in\_calc)+(?:,(num\_market\_pairs|cmc\_rank|date\_added|tags|platform|max\_supply|circulating\_supply|total\_supply|market\_cap\_by\_total\_supply|volume\_24h\_reported|volume\_7d|volume\_7d\_reported|volume\_30d|volume\_30d\_reported|is\_market\_cap\_included\_in\_calc)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply,market_cap_by_total_supply,volume_24h_reported,volume_7d,volume_7d_reported,volume_30d,volume_30d_reported,is_market_cap_included_in_calc` to include all auxiliary fields. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Listings%20Latest%20-%20Cryptocurrency%20object%201 Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/listings/latest Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "infinite\_supply": false,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "self\_reported\_circulating\_supply": null,\ \ * "self\_reported\_market\_cap": null,\ \ * "minted\_market\_cap": 1802955697670.94,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 852164659250.2758,\ \ * "market\_cap\_dominance": 51,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "volume\_change\_24h": 0,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "market\_cap\_dominance": 12,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "infinite\_supply": false,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "minted\_market\_cap": 364793475572.53,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "market\_cap\_dominance": 51,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "market\_cap\_dominance": 12,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsNew) Listings New --------------------------------------------------------------------------------------------------------- Returns a paginated list of most recently added cryptocurrencies. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our "new" cryptocurrency page [coinmarketcap.com/new/](https://coinmarketcap.com/new) _**NOTE:** Use this endpoint if you need a sorted and paginated list of all recently added cryptocurrencies._ ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. sort\_dir string "asc" "desc" The direction in which to order cryptocurrencies against the specified sort. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Listings%20Latest%20-%20Cryptocurrency%20object%202 Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/listings/new Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/new * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "minted\_market\_cap": 1802955697670.94,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 852164659250.2758,\ \ * "market\_cap\_dominance": 51,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "volume\_change\_24h": 0,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "market\_cap\_dominance": 12,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "minted\_market\_cap": 364793475572.53,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "market\_cap\_dominance": 51,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "volume\_change\_24h": \-0.152774,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "market\_cap\_dominance": 12,\ \ * "fully\_diluted\_market\_cap": 952835089431.14,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingGainerslosers) Trending Gainers & Losers -------------------------------------------------------------------------------------------------------------------------------- Returns a paginated list of all trending cryptocurrencies, determined and sorted by the largest price gains or losses. You may sort against any of the following: **percent\_change\_24h**: 24 hour trading price percentage change for each currency. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 10 minutes. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our cryptocurrency Gainers & Losers page [coinmarketcap.com/gainers-losers/](https://coinmarketcap.com/gainers-losers/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 1000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. time\_period string "24h" "1h" "24h" "30d" "7d" Adjusts the overall window of time for the biggest gainers and losers. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. sort string "percent\_change\_24h" "percent\_change\_24h" What field to sort the list of cryptocurrencies by. sort\_dir string "asc" "desc" The direction in which to order cryptocurrencies against the specified sort. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20-%20Cryptocurrency%20object Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/trending/gainers-losers Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/gainers-losers * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingLatest) Trending Latest --------------------------------------------------------------------------------------------------------------- Returns a paginated list of all trending cryptocurrency market data, determined and sorted by CoinMarketCap search volume. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 10 minutes. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our cryptocurrency Trending page [coinmarketcap.com/trending-cryptocurrencies/](https://coinmarketcap.com/trending-cryptocurrencies/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 1000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. time\_period string "24h" "24h" "30d" "7d" Adjusts the overall window of time for the latest trending coins. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Trending%20Latest%20-%20Cryptocurrency%20object Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/trending/latest Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "is\_active": true,\ \ * "is\_fiat": 0,\ \ * "self\_reported\_circulating\_supply": null,\ \ * "self\_reported\_market\_cap": null,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyTrendingMostvisited) Trending Most Visited -------------------------------------------------------------------------------------------------------------------------- Returns a paginated list of all trending cryptocurrency market data, determined and sorted by traffic to coin detail pages. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 24 hours. **Plan credit use:** 1 call credit per 200 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** The CoinMarketCap “Most Visited” trending list. [coinmarketcap.com/most-viewed-pages/](https://coinmarketcap.com/most-viewed-pages/) . ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 1000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. time\_period string "24h" "24h" "30d" "7d" Adjusts the overall window of time for most visited currencies. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20-%20Cryptocurrency%20object Required

Array of cryptocurrency objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/cryptocurrency/trending/most-visited Server URL https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/most-visited * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 1,\ \ * "name": "Bitcoin",\ \ * "symbol": "BTC",\ \ * "slug": "bitcoin",\ \ * "cmc\_rank": 5,\ \ * "num\_market\_pairs": 500,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 9283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "BTC": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 1027,\ \ * "name": "Ethereum",\ \ * "symbol": "ETH",\ \ * "slug": "ethereum",\ \ * "num\_market\_pairs": 6360,\ \ * "circulating\_supply": 16950100,\ \ * "total\_supply": 16950100,\ \ * "max\_supply": 21000000,\ \ * "last\_updated": "2018-06-02T22:51:28.209Z",\ \ * "date\_added": "2013-04-28T00:00:00.000Z",\ \ * "tags": \ \ \[\ \ * "mineable"\ \ \ \],\ \ * "platform": null,\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 1283.92,\ \ * "volume\_24h": 7155680000,\ \ * "percent\_change\_1h": \-0.152774,\ \ * "percent\_change\_24h": 0.518894,\ \ * "percent\_change\_7d": 0.986573,\ \ * "market\_cap": 158055024432,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ },\ \ * "ETH": \ \ {\ \ * "price": 1,\ \ * "volume\_24h": 772012,\ \ * "percent\_change\_1h": 0,\ \ * "percent\_change\_24h": 0,\ \ * "percent\_change\_7d": 0,\ \ * "market\_cap": 17024600,\ \ * "last\_updated": "2018-08-09T22:53:32.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyMarketpairsLatest) Market Pairs Latest v2 ------------------------------------------------------------------------------------------------------------------------- Lists all active market pairs that CoinMarketCap tracks for a given cryptocurrency or fiat currency. All markets with this currency as the pair base _or_ pair quote will be returned. 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. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * ~Startup~ * Standard * Professional * Enterprise **Cache / Update frequency:** Every 1 minute. **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 active cryptocurrency markets pages like [coinmarketcap.com/currencies/bitcoin/#markets](https://coinmarketcap.com/currencies/bitcoin/#markets) . ##### Parameters id string A cryptocurrency or fiat currency by CoinMarketCap ID to list market pairs for. Example: "1" slug string ^\[0-9a-z-\]\*$ Alternatively pass a cryptocurrency by slug. Example: "bitcoin" symbol string ^\[0-9A-Za-z$@\\-\]\*$ Alternatively pass a cryptocurrency by symbol. Fiat currencies are not supported by this field. Example: "BTC". A single cryptocurrency "id", "slug", _or_ "symbol" is required. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. sort\_dir string "desc" "asc" "desc" Optionally specify the sort direction of markets returned. sort string "volume\_24h\_strict" "volume\_24h\_strict" "cmc\_rank" "cmc\_rank\_advanced" "effective\_liquidity" "market\_score" "market\_reputation" Optionally specify the sort order of markets returned. By default we return a strict sort on 24 hour reported volume. Pass `cmc_rank` to return a CMC methodology based sort where markets with excluded volumes are returned last. aux string "num\_market\_pairs,category,fee\_type" ^(num\_market\_pairs|category|fee\_type|market\_url|currency\_name|currency\_slug|price\_quote|notice|cmc\_rank|effective\_liquidity|market\_score|market\_reputation)+(?:,(num\_market\_pairs|category|fee\_type|market\_url|currency\_name|currency\_slug|price\_quote|notice|cmc\_rank|effective\_liquidity|market\_score|market\_reputation)+)\*$ 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,notice,cmc_rank,effective_liquidity,market_score,market_reputation` to include all auxiliary fields. matched\_id string ^\\d+(?:,\\d+)\*$ Optionally include one or more fiat or cryptocurrency IDs to filter market pairs by. For example `?id=1&matched_id=2781` would only return BTC markets that matched: "BTC/USD" or "USD/BTC". This parameter cannot be used when `matched_symbol` is used. matched\_symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Optionally include one or more fiat or cryptocurrency symbols to filter market pairs by. For example `?symbol=BTC&matched_symbol=USD` would only return BTC markets that matched: "BTC/USD" or "USD/BTC". This parameter cannot be used when `matched_id` is used. category string "all" "all" "spot" "derivatives" "otc" "perpetual" The category of trading this market falls under. Spot markets are the most common but options include derivatives and OTC. fee\_type string "all" "all" "percentage" "no-fees" "transactional-mining" "unknown" The fee type the exchange enforces for this market. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Market%20Pairs%20Latest%20-%20Results%20object Required

Results of your query returned as an object. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/market-pairs/latest Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/market-pairs/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "num\_market\_pairs": 7526, * "market\_pairs": \[\ \ * {\ \ * "exchange": \ \ {\ \ * "id": 157,\ \ * "name": "BitMEX",\ \ * "slug": "bitmex"\ \ \ },\ \ * "market\_id": 4902,\ \ * "market\_pair": "BTC/USD",\ \ * "category": "derivatives",\ \ * "fee\_type": "no-fees",\ \ * "market\_pair\_base": \ \ {\ \ * "currency\_id": 1,\ \ * "currency\_symbol": "BTC",\ \ * "exchange\_symbol": "XBT",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "market\_pair\_quote": \ \ {\ \ * "currency\_id": 2781,\ \ * "currency\_symbol": "USD",\ \ * "exchange\_symbol": "USD",\ \ * "currency\_type": "fiat"\ \ \ },\ \ * "quote": \ \ {\ \ * "exchange\_reported": \ \ {\ \ * "price": 7839,\ \ * "volume\_24h\_base": 434215.85308502,\ \ * "volume\_24h\_quote": 3403818072.33347,\ \ * "last\_updated": "2019-05-24T02:39:00.000Z"\ \ \ },\ \ * "USD": \ \ {\ \ * "price": 7839,\ \ * "volume\_24h": 3403818072.33347,\ \ * "last\_updated": "2019-05-24T02:39:00.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "exchange": \ \ {\ \ * "id": 108,\ \ * "name": "Negocie Coins",\ \ * "slug": "negocie-coins"\ \ \ },\ \ * "market\_id": 3377,\ \ * "market\_pair": "BTC/BRL",\ \ * "category": "spot",\ \ * "fee\_type": "percentage",\ \ * "market\_pair\_base": \ \ {\ \ * "currency\_id": 1,\ \ * "currency\_symbol": "BTC",\ \ * "exchange\_symbol": "BTC",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "market\_pair\_quote": \ \ {\ \ * "currency\_id": 2783,\ \ * "currency\_symbol": "BRL",\ \ * "exchange\_symbol": "BRL",\ \ * "currency\_type": "fiat"\ \ \ },\ \ * "quote": \ \ {\ \ * "exchange\_reported": \ \ {\ \ * "price": 33002.11,\ \ * "volume\_24h\_base": 336699.03559957,\ \ * "volume\_24h\_quote": 11111778609.7509,\ \ * "last\_updated": "2019-05-24T02:39:00.000Z"\ \ \ },\ \ * "USD": \ \ {\ \ * "price": 8165.02539531659,\ \ * "volume\_24h": 2749156176.2491,\ \ * "last\_updated": "2019-05-24T02:39:00.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvHistorical) OHLCV Historical v2 -------------------------------------------------------------------------------------------------------------------- Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any cryptocurrency using time interval parameters. Currently daily and hourly OHLCV periods are supported. Volume is not currently supported for hourly OHLCV intervals before 2020-09-22. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **Technical Notes** * Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time for this "time\_period". * One OHLCV quote will be returned for every "time\_period" between your "time\_start" (exclusive) and "time\_end" (inclusive). * If a "time\_start" is not supplied, the "time\_period" will be calculated in reverse from "time\_end" using the "count" parameter which defaults to 10 results. * If "time\_end" is not supplied, it defaults to the current time. * If you don't need every "time\_period" between your dates you may adjust the frequency that "time\_period" is sampled using the "interval" parameter. For example with "time\_period" set to "daily" you may set "interval" to "2d" to get the daily OHLCV for every other day. You could set "interval" to "monthly" to get the first daily OHLCV for each month, or set it to "yearly" to get the daily OHLCV value against the same date every year. **Implementation Tips** * If querying for a specific OHLCV date your "time\_start" should specify a timestamp of 1 interval prior as "time\_start" is an exclusive time parameter (as opposed to "time\_end" which is inclusive to the search). This means that when you pass a "time\_start" results will be returned for the _next_ complete "time\_period". For example, if you are querying for a daily OHLCV datapoint for 2018-11-30 your "time\_start" should be "2018-11-29". * If only specifying a "count" parameter to return latest OHLCV periods, your "count" should be 1 number higher than the number of results you expect to receive. "Count" defines the number of "time\_period" intervals queried, _not_ the number of results to return, and this includes the currently active time period which is incomplete when working backwards from current time. For example, if you want the last daily OHLCV value available simply pass "count=2" to skip the incomplete active time period. * This endpoint supports requesting multiple cryptocurrencies 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 "time\_period" and "interval" parameters. For "time\_period" these return aggregate OHLCV data from the beginning to end of each interval period. Apply these time intervals to "interval" to adjust how frequently "time\_period" is sampled. The first are calendar year and time constants in UTC time: **"hourly"** - Hour intervals in UTC. **"daily"** - Calendar day intervals for each UTC day. **"weekly"** - Calendar week intervals for each calendar week. **"monthly"** - Calendar month intervals for each calendar month. **"yearly"** - Calendar year intervals for each calendar year. The second are relative time intervals. **"h"**: Get the first quote available every "h" hours (3600 second intervals). Supported hour intervals are: "1h", "2h", "3h", "4h", "6h", "12h". **"d"**: Time periods that repeat every "d" days (86400 second intervals). Supported day intervals are: "1d", "2d", "3d", "7d", "14d", "15d", "30d", "60d", "90d", "365d". Please note that "time\_period" currently supports the "daily" and "hourly" options. "interval" supports all interval options. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * Startup (1 month) * Standard (3 months) * Professional (12 months) * Enterprise (Up to 6 years) **Cache / Update frequency:** Latest Daily OHLCV record is available ~5 to ~10 minutes after each midnight UTC. The latest hourly OHLCV record is available 5 minutes after each UTC hour. **Plan credit use:** 1 call credit per 100 OHLCV data points returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Our historical cryptocurrency data pages like [coinmarketcap.com/currencies/bitcoin/historical-data/](https://coinmarketcap.com/currencies/bitcoin/historical-data/) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,1027" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "slug" _or_ "symbol" is required for this request. time\_period string "daily" "daily" "hourly" Time period to return OHLCV data for. The default is "daily". If hourly, the open will be 01:00 and the close will be 01:59. If daily, the open will be 00:00:00 for the day and close will be 23:59:99 for the same day. See the main endpoint description for details. time\_start string Timestamp (Unix or ISO 8601) to start returning OHLCV time periods for. Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time. time\_end string Timestamp (Unix or ISO 8601) to stop returning OHLCV time periods for (inclusive). Optional, if not passed we'll default to the current time. Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time. count number \[ 1 .. 10000 \] 10 Optionally limit the number of time periods to return results for. The default is 10 items. The current query limit is 10000 items. interval string "daily" "hourly" "daily" "weekly" "monthly" "yearly" "1h" "2h" "3h" "4h" "6h" "12h" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d" Optionally adjust the interval that "time\_period" is sampled. For example with interval=monthly&time\_period=daily you will see a daily OHLCV record for January, February, March and so on. See main endpoint description for available options. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ By default market quotes are returned in USD. Optionally calculate market quotes in up to 3 fiat currencies or cryptocurrencies. convert\_id string ^\\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. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if any invalid cryptocurrencies are requested or a cryptocurrency does not have matching records in the requested timeframe. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20OHLCV%20Historical%20-%20Results%20object Required

Results of your query returned as an object. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/ohlcv/historical Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/ohlcv/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "quotes": \[\ \ * {\ \ * "time\_open": "2019-01-02T00:00:00.000Z",\ \ * "time\_close": "2019-01-02T23:59:59.999Z",\ \ * "time\_high": "2019-01-02T03:53:00.000Z",\ \ * "time\_low": "2019-01-02T02:43:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "open": 3849.21640853,\ \ * "high": 3947.9812729,\ \ * "low": 3817.40949569,\ \ * "close": 3943.40933686,\ \ * "volume": 5244856835.70851,\ \ * "market\_cap": 68849856731.6738,\ \ * "timestamp": "2019-01-02T23:59:59.999Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "time\_open": "2019-01-03T00:00:00.000Z",\ \ * "time\_close": "2019-01-03T23:59:59.999Z",\ \ * "time\_high": "2019-01-02T03:53:00.000Z",\ \ * "time\_low": "2019-01-02T02:43:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "open": 3931.04863841,\ \ * "high": 3935.68513083,\ \ * "low": 3826.22287069,\ \ * "close": 3836.74131867,\ \ * "volume": 4530215218.84018,\ \ * "market\_cap": 66994920902.7202,\ \ * "timestamp": "2019-01-03T23:59:59.999Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyOhlcvLatest) OHLCV Latest v2 ------------------------------------------------------------------------------------------------------------ Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more cryptocurrencies for the current UTC day. Since the current UTC day is still active these values are updated frequently. You can find the final calculated OHLCV values for the last completed UTC day along with all historic days using /cryptocurrency/ohlcv/historical. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 10 minutes. Additional OHLCV intervals and 1 minute updates will be available in the future. **Plan credit use:** 1 call credit per 100 OHLCV values 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. ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2 symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "symbol" is required. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if any invalid cryptocurrencies are requested or a cryptocurrency does not have matching records in the requested timeframe. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20OHLCV%20Latest%20-%20Cryptocurrency%20Results%20map Required

A map of cryptocurrency objects by ID or symbol (as passed in query parameters). | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/ohlcv/latest Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/ohlcv/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "1": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "last\_updated": "2018-09-10T18:54:00.000Z", * "time\_open": "2018-09-10T00:00:00.000Z", * "time\_close": null, * "time\_high": "2018-09-10T00:00:00.000Z", * "time\_low": "2018-09-10T00:00:00.000Z", * "quote": { * "USD": { * "open": 6301.57, * "high": 6374.98, * "low": 6292.76, * "close": 6308.76, * "volume": 3786450000, * "last\_updated": "2018-09-10T18:54:00.000Z" } } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyPriceperformancestatsLatest) Price Performance Stats v2 --------------------------------------------------------------------------------------------------------------------------------------- Returns price performance statistics for one or more cryptocurrencies including launch price ROI and all-time high / all-time low. Stats are returned for an `all_time` period by default. UTC `yesterday` and a number of _rolling time periods_ may be requested using the `time_period` parameter. Utilize the `convert` parameter to translate values into multiple fiats or cryptocurrencies using historical rates. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * Startup * Standard * Professional * Enterprise **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** The statistics module displayed on cryptocurrency pages like [Bitcoin](https://coinmarketcap.com/currencies/bitcoin/) . _**NOTE:** You may also use [/cryptocurrency/ohlcv/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvHistorical) for traditional OHLCV data at historical daily and hourly intervals. You may also use [/v1/cryptocurrency/ohlcv/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyOhlcvLatest) for OHLCV data for the current UTC day._ ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2 slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "slug" _or_ "symbol" is required for this request. time\_period string "all\_time" ^(all\_time|yesterday|24h|7d|30d|90d|365d)+(?:,(all\_time|yesterday|24h|7d|30d|90d|365d)+)\*$ Specify one or more comma-delimited time periods to return stats for. `all_time` is the default. Pass `all_time,yesterday,24h,7d,30d,90d,365d` to return all supported time periods. All rolling periods have a rolling close time of the current request time. For example `24h` would have a close time of now and an open time of 24 hours before now. _Please note: `yesterday` is a UTC period and currently does not currently support `high` and `low` timestamps._ convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Optionally calculate 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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\d+(?:,\\d+)\*$ Optionally calculate 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. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Price%20Performance%20Stats%20Latest%20-%20Cryptocurrency%20Results%20map Required

An object map of cryptocurrency objects by ID, slug, or symbol (as used in query parameters). | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/price-performance-stats/latest Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/price-performance-stats/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "1": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "slug": "bitcoin", * "last\_updated": "2019-08-22T01:51:32.000Z", * "periods": { * "all\_time": { * "open\_timestamp": "2013-04-28T00:00:00.000Z", * "high\_timestamp": "2017-12-17T12:19:14.000Z", * "low\_timestamp": "2013-07-05T18:56:01.000Z", * "close\_timestamp": "2019-08-22T01:52:18.613Z", * "quote": { * "USD": { * "open": 135.3000030517578, * "open\_timestamp": "2013-04-28T00:00:00.000Z", * "high": 20088.99609375, * "high\_timestamp": "2017-12-17T12:19:14.000Z", * "low": 65.5260009765625, * "low\_timestamp": "2013-07-05T18:56:01.000Z", * "close": 65.5260009765625, * "close\_timestamp": "2019-08-22T01:52:18.618Z", * "percent\_change": 7223.718930042746, * "price\_change": 9773.691932798241 } } } } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesHistorical) Quotes Historical v2 ---------------------------------------------------------------------------------------------------------------------- Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **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. **Implementation Tips** * Want to get the last quote of each UTC day? Don't use "interval=daily" as that returns the first quote. Instead use "interval=24h" to repeat a specific timestamp search every 24 hours and pass ex. "time\_start=2019-01-04T23:59:00.000Z" to query for the last record of each UTC day. * This endpoint supports requesting multiple cryptocurrencies 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * Hobbyist (1 month) * Startup (1 month) * Standard (3 month) * Professional (12 months) * Enterprise (Up to 6 years) **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:** Our historical cryptocurrency charts like [coinmarketcap.com/currencies/bitcoin/#charts](https://coinmarketcap.com/currencies/bitcoin/#charts) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "symbol" is required for this request. time\_start string Timestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time\_end". time\_end string Timestamp (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. count number \[ 1 .. 10000 \] 10 The 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. interval string "5m" "yearly" "monthly" "weekly" "daily" "hourly" "5m" "10m" "15m" "30m" "45m" "1h" "2h" "3h" "4h" "6h" "12h" "24h" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d" Interval of time to return data points for. See details in endpoint description. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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 string (^\\d+(?:,\\d+)\*$|(\\d,)\*PLATFORM\_ID+(?:,\\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 string "price,volume,market\_cap,circulating\_supply,total\_supply,quote\_timestamp,is\_active,is\_fiat" ^(price|volume|market\_cap|circulating\_supply|total\_supply|quote\_timestamp|is\_active|is\_fiat|search\_interval)+(?:,(price|volume|market\_cap|circulating\_supply|total\_supply|quote\_timestamp|is\_active|is\_fiat|search\_interval)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `price,volume,market_cap,circulating_supply,total_supply,quote_timestamp,is_active,is_fiat,search_interval` to include all auxiliary fields. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Quotes%20Historical%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/quotes/historical Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "is\_active": 1, * "is\_fiat": 0, * "quotes": \[\ \ * {\ \ * "timestamp": "2018-06-22T19:29:37.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 6242.29,\ \ * "volume\_24h": 4681670000,\ \ * "market\_cap": 106800038746.48,\ \ * "circulating\_supply": 4681670000,\ \ * "total\_supply": 4681670000,\ \ * "timestamp": "2018-06-22T19:29:37.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "timestamp": "2018-06-22T19:34:33.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 6242.82,\ \ * "volume\_24h": 4682330000,\ \ * "market\_cap": 106809106575.84,\ \ * "circulating\_supply": 4681670000,\ \ * "total\_supply": 4681670000,\ \ * "timestamp": "2018-06-22T19:34:33.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV2CryptocurrencyQuotesLatest) Quotes Latest v2 -------------------------------------------------------------------------------------------------------------- Returns the latest market quote for 1 or more cryptocurrencies. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call. **Please note**: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * Basic * Startup * Hobbyist * Standard * Professional * Enterprise **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. **CMC equivalent pages:** Latest market data pages for specific cryptocurrencies like [coinmarketcap.com/currencies/bitcoin/](https://coinmarketcap.com/currencies/bitcoin/) . _**NOTE:** Use this endpoint to request the latest quote for specific cryptocurrencies. If you need to request all cryptocurrencies use [/v1/cryptocurrency/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest) which is optimized for that purpose. The response data between these endpoints is otherwise the same._ ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2 slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "slug" _or_ "symbol" is required for this request. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string (^\\d+(?:,\\d+)\*$|(\\d,)\*PLATFORM\_ID+(?:,\\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 string "num\_market\_pairs,cmc\_rank,date\_added,tags,platform,max\_supply,circulating\_supply,total\_supply,is\_active,is\_fiat" ^(num\_market\_pairs|cmc\_rank|date\_added|tags|platform|max\_supply|circulating\_supply|total\_supply|market\_cap\_by\_total\_supply|volume\_24h\_reported|volume\_7d|volume\_7d\_reported|volume\_30d|volume\_30d\_reported|is\_active|is\_fiat)+(?:,(num\_market\_pairs|cmc\_rank|date\_added|tags|platform|max\_supply|circulating\_supply|total\_supply|market\_cap\_by\_total\_supply|volume\_24h\_reported|volume\_7d|volume\_7d\_reported|volume\_30d|volume\_30d\_reported|is\_active|is\_fiat)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply,market_cap_by_total_supply,volume_24h_reported,volume_7d,volume_7d_reported,volume_30d,volume_30d_reported,is_active,is_fiat` to include all auxiliary fields. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Quotes%20Latest%20-%20Cryptocurrency%20Results%20map Required

A map of cryptocurrency objects by ID, symbol, or slug (as used in query parameters). | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v2/cryptocurrency/quotes/latest Server URL https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "1": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "slug": "bitcoin", * "is\_active": 1, * "is\_fiat": 0, * "circulating\_supply": 17199862, * "total\_supply": 17199862, * "max\_supply": 21000000, * "date\_added": "2013-04-28T00:00:00.000Z", * "num\_market\_pairs": 331, * "cmc\_rank": 1, * "last\_updated": "2018-08-09T21:56:28.000Z", * "tags": \[\ \ * "mineable"\ \ \ \], * "platform": null, * "self\_reported\_circulating\_supply": null, * "self\_reported\_market\_cap": null, * "minted\_market\_cap": 1802955697670.94, * "quote": { * "USD": { * "price": 6602.60701122, * "volume\_24h": 4314444687.5194, * "volume\_change\_24h": \-0.152774, * "percent\_change\_1h": 0.988615, * "percent\_change\_24h": 4.37185, * "percent\_change\_7d": \-12.1352, * "percent\_change\_30d": \-12.1352, * "market\_cap": 852164659250.2758, * "market\_cap\_dominance": 51, * "fully\_diluted\_market\_cap": 952835089431.14, * "last\_updated": "2018-08-09T21:56:28.000Z" } } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV3CryptocurrencyQuotesHistorical) Quotes Historical v3 ---------------------------------------------------------------------------------------------------------------------- Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters. **Please note**: This documentation relates to our updated V3 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found [here](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) . **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. **Implementation Tips** * Want to get the last quote of each UTC day? Don't use "interval=daily" as that returns the first quote. Instead use "interval=24h" to repeat a specific timestamp search every 24 hours and pass ex. "time\_start=2019-01-04T23:59:00.000Z" to query for the last record of each UTC day. * This endpoint supports requesting multiple cryptocurrencies 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * Hobbyist (1 month) * Startup (1 month) * Standard (3 month) * Professional (12 months) * Enterprise (Up to 6 years) **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:** Our historical cryptocurrency charts like [coinmarketcap.com/currencies/bitcoin/#charts](https://coinmarketcap.com/currencies/bitcoin/#charts) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2" symbol string ^\[0-9A-Za-z$@\\-,\]+(?:,\[0-9A-Za-z$@\\-\]+)\*$ Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" _or_ "symbol" is required for this request. time\_start string Timestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time\_end". time\_end string Timestamp (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. count number \[ 1 .. 10000 \] 10 The 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. interval string "5m" "yearly" "monthly" "weekly" "daily" "hourly" "5m" "10m" "15m" "30m" "45m" "1h" "2h" "3h" "4h" "6h" "12h" "24h" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d" Interval of time to return data points for. See details in endpoint description. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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 string (^\\d+(?:,\\d+)\*$|(\\d,)\*PLATFORM\_ID+(?:,\\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 string "price,volume,market\_cap,circulating\_supply,total\_supply,quote\_timestamp,is\_active,is\_fiat" ^(price|volume|market\_cap|circulating\_supply|total\_supply|quote\_timestamp|is\_active|is\_fiat|search\_interval)+(?:,(price|volume|market\_cap|circulating\_supply|total\_supply|quote\_timestamp|is\_active|is\_fiat|search\_interval)+)\*$ Optionally specify a comma-separated list of supplemental data fields to return. Pass `price,volume,market_cap,circulating_supply,total_supply,quote_timestamp,is_active,is_fiat,search_interval` to include all auxiliary fields. skip\_invalid boolean true Pass `true` to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned. Responses --------- 200 Successful | | | | --- | --- | | data null | Cryptocurrency%20Quotes%20Historical%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v3/cryptocurrency/quotes/historical Server URL https://pro-api.coinmarketcap.com/v3/cryptocurrency/quotes/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 1, * "name": "Bitcoin", * "symbol": "BTC", * "is\_active": 1, * "is\_fiat": 0, * "quotes": \[\ \ * {\ \ * "timestamp": "2018-06-22T19:29:37.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 6242.29,\ \ * "volume\_24h": 4681670000,\ \ * "market\_cap": 106800038746.48,\ \ * "circulating\_supply": 4681670000,\ \ * "total\_supply": 4681670000,\ \ * "timestamp": "2018-06-22T19:29:37.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "timestamp": "2018-06-22T19:34:33.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "price": 6242.82,\ \ * "volume\_24h": 4682330000,\ \ * "market\_cap": 106809106575.84,\ \ * "circulating\_supply": 4681670000,\ \ * "total\_supply": 4681670000,\ \ * "timestamp": "2018-06-22T19:34:33.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#tag/DexScan) DexScan ======================================================================= ##### The on-chain data API is currently undergoing an upgrade. Out of the original eight endpoints, only the following two will remain available. We sincerely apologize if you are using any of the soon-to-be deprecated endpoints. * [/v4/dex/spot-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV4DexSpotpairsLatest) - Latest listings of pairs * [/v4/dex/pairs/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV4DexPairsQuotesLatest) - Latest quotes The upgraded APIs will be available to serve you shortly. If you have any questions, please feel free to contact our customer service team. Thank you. [](https://coinmarketcap.com/api/documentation/v1/#operation/getLatestPairsQuotes) Quotes Latest ------------------------------------------------------------------------------------------------ Returns the latest market quote for 1 or more spot pairs. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call. ##### Parameters contract\_address string One or more comma-separated contract addresses. network\_id string One or more CoinMarketCap cryptocurrency network ids network\_slug string Alternatively, one network names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens). aux string Default:`""` Valid values: `"pool_created"` `"percent_pooled_base_asset"` `"num_transactions_24h"` `"pool_base_asset"` `"pool_quote_asset"` `"24h_volume_quote_asset"` `"total_supply_quote_asset"` `"total_supply_base_asset"` `"holders"` `"buy_tax"` `"sell_tax"` `"security_scan"` `"24h_no_of_buys"` `"24h_no_of_sells"` `"24h_buy_volume"` `"24h_sell_volume"` Optionally specify a comma-separated list of supplemental data fields to return. convert\_id string 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. skip\_invalid string Pass true to relax request validation rules. When requesting records on multiple spot pairs an error is returned if no match is found for 1 or more requested spot pairs. If set to true, invalid lookups will be skipped allowing valid spot pairs to still be returned. reverse\_order string Pass true to invert the order of a spot pair. For example, a trading pair is set up as Token B/Token A in the contract and is commonly referred to as Token A/Token B. Using reverse\_order would change the order to reflect the true Token B/Token A pairing as it exists in the pool. Responses --------- 200 OK | | | | --- | --- | | 24h\_no\_of\_buys null | integer

Number of asset buys in the past 24 hours | | | | | 24h\_no\_of\_sells null | integer

Number of asset sells in the past 24 hours | | | | | 24h\_volume\_quote\_asset null | number

24 hours volume of the quote asset | | | | | base\_asset\_contract\_address null | string

The contract addres of this base asset in the spot pair. | | | | | base\_asset\_id null | string

The id of this base asset in the spot pair. | | | | | base\_asset\_name null | string

The name of this base asset in the spot pair. | | | | | base\_asset\_symbol null | string

The symbol of this base asset in the spot pair. | | | | | base\_asset\_ucid null | string

The ucid of this base asset in the spot pair. | | | | | buy\_tax null | number

Buy tax on the asset | | | | | contract\_address null | string

The unique contract address for this spot pair. | | | | | created\_at null | string

Timestamp (ISO 8601) when we started tracking this asset. | | | | | date\_launched null | string

Timestamp (ISO 8601) of the launch date for this exchange. | | | | | dex\_id null | string

The id of this dex the spot pair is on. | | | | | dex\_slug null | string

The name of this dex the spot pair is on. | | | | | holders null | integer

Number of holders of the asset | | | | | last\_updated null | string

Timestamp (ISO 8601) of the last time this record was updated. | | | | | name null | string

The name of this spot pair. | | | | | network\_id null | string

The id of the network the spot pair is on. | | | | | network\_slug null | string

The slug of the network the spot pair is on. | | | | | num\_transactions\_24h null | integer

Number of transactions in past 24 hours | | | | | percent\_pooled\_base\_asset null | number

Percentage of the base asset in the pool | | | | | pool\_base\_asset null | number

Base asset in the pool | | | | | pool\_created null | string

When the pool of the asset was created | | | | | pool\_quote\_asset null | number

Quote asset in the pool | | | | | quote null | DexQuoteDTO

A map of market quotes in different currency conversions. The default map included is USD. | | | | | quote\_asset\_contract\_address null | string

The contract addresss of this quote asset in the spot pair. | | | | | quote\_asset\_id null | string

The id of this quote asset in the spot pair. | | | | | quote\_asset\_name null | string

The name of this quote asset in the spot pair. | | | | | quote\_asset\_symbol null | string

The symbol of this quote asset in the spot pair. | | | | | quote\_asset\_ucid null | string

The ucid of this quote asset in the spot pair. | | | | | security\_scan null | SecurityScanResult

Security scan by Go+.

All infomation and data relating to contract detection are based on public third party information. CoinMarketCap does not confirm or verify the accuracy or timeliness of such information and data.

CoinMarketCap shall have no responsibility or liability for the accuracy of data, nor 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.

Only returned if passed in aux. | | | | | sell\_tax null | number

Sell tax on the asset | | | | | total\_supply\_base\_asset null | number

Total supply of the quote asset | | | | | total\_supply\_quote\_asset null | number

Total supply of the quote asset | | | | 400 Bad Request ##### get /v4/dex/pairs/quotes/latest Server URL https://pro-api.coinmarketcap.com/v4/dex/pairs/quotes/latest * 200 OK Copy Expand all Collapse all \[\ \ * {\ \ * "24h\_no\_of\_buys": 0,\ \ * "24h\_no\_of\_sells": 0,\ \ * "24h\_volume\_quote\_asset": 0,\ \ * "base\_asset\_contract\_address": "string",\ \ * "base\_asset\_id": "string",\ \ * "base\_asset\_name": "string",\ \ * "base\_asset\_symbol": "string",\ \ * "base\_asset\_ucid": "string",\ \ * "buy\_tax": 0,\ \ * "contract\_address": "string",\ \ * "created\_at": "2025-12-23T17:31:50Z",\ \ * "date\_launched": "2025-12-23T17:31:50Z",\ \ * "dex\_id": "string",\ \ * "dex\_slug": "string",\ \ * "holders": 0,\ \ * "last\_updated": "2025-12-23T17:31:50Z",\ \ * "name": "string",\ \ * "network\_id": "string",\ \ * "network\_slug": "string",\ \ * "num\_transactions\_24h": 0,\ \ * "percent\_pooled\_base\_asset": 0,\ \ * "pool\_base\_asset": 0,\ \ * "pool\_created": "2025-12-23T17:31:50Z",\ \ * "pool\_quote\_asset": 0,\ \ * "quote": \ \ \[\ \ * {\ \ * "24h\_buy\_volume": 0,\ \ * "24h\_sell\_volume": 0,\ \ * "convert\_id": "string",\ \ * "fully\_diluted\_value": 0,\ \ * "last\_updated": "string",\ \ * "liquidity": 0,\ \ * "percent\_change\_price\_1h": 0,\ \ * "percent\_change\_price\_24h": 0,\ \ * "price": 0,\ \ * "price\_by\_quote\_asset": 0,\ \ * "volume\_24h": 0\ \ \ }\ \ \ \],\ \ * "quote\_asset\_contract\_address": "string",\ \ * "quote\_asset\_id": "string",\ \ * "quote\_asset\_name": "string",\ \ * "quote\_asset\_symbol": "string",\ \ * "quote\_asset\_ucid": "string",\ \ * "security\_scan": \ \ \[\ \ * {\ \ * "aggregated": \ \ {\ \ * "contract\_verified": true,\ \ * "honeypot": true\ \ \ },\ \ * "third\_party": \ \ {\ \ * "airdrop\_scam": true,\ \ * "anti\_whale": true,\ \ * "anti\_whale\_modifiable": true,\ \ * "blacklisted": true,\ \ * "can\_take\_back\_ownership": true,\ \ * "cannot\_buy": true,\ \ * "cannot\_sell\_all": true,\ \ * "external\_call": true,\ \ * "hidden\_owner": true,\ \ * "honeypot": true,\ \ * "in\_dex": true,\ \ * "mintable": true,\ \ * "open\_source": true,\ \ * "owner\_change\_balance": true,\ \ * "personal\_slippage\_modifiable": true,\ \ * "proxy": true,\ \ * "self\_destruct": true,\ \ * "slippage\_modifiable": true,\ \ * "trading\_cool\_down": true,\ \ * "transfer\_pausable": true,\ \ * "true\_token": true,\ \ * "trust\_list": true,\ \ * "whitelisted": true\ \ \ }\ \ \ }\ \ \ \],\ \ * "sell\_tax": 0,\ \ * "total\_supply\_base\_asset": 0,\ \ * "total\_supply\_quote\_asset": 0\ \ \ }\ \ \ \] [](https://coinmarketcap.com/api/documentation/v1/#operation/getSpotPairsLatest) Pairs Listings Latest ------------------------------------------------------------------------------------------------------ Returns a paginated list of all active dex spot pairs with latest market data. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call. ##### Parameters network\_id string One or more comma-separated CoinMarketCap cryptocurrency network ids. network\_slug string Alternatively, one or more comma-separated network names in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required. dex\_id string One or more comma-separated CoinMarketCap dex exchange ids dex\_slug string Alternatively, one or more comma-separated dex exchange names in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required. base\_asset\_id string One or more comma-separated CoinMarketCap cryptocurrency ids. base\_asset\_symbol string Alternatively, one or more comma-separated network symbol in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens).At least one id or slug is required. base\_asset\_contract\_address string Alternatively, one base asset contract address in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens).At least one id or slug is required. base\_asset\_ucid string One or more comma-separated CoinMarketCap cryptocurrency IDs. quote\_asset\_id string One or more comma-separated CoinMarketCap cryptocurrency ids. quote\_asset\_symbol string Alternatively, one or more comma-separated network symbol in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required. quote\_asset\_contract\_address string Alternatively, one quote asset contract address in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required. quote\_asset\_ucid string One or more comma-separated CoinMarketCap cryptocurrency IDs. scroll\_id string After your initial query, the API responds with the initial set of results and a scroll\_ids. To retrieve the next set of results, provide this scroll\_id of the last JSON with your follow-up request. scroll\_id is an alternative to traditional pagination techniques. limit string Optionally specify the number of results to return. Use this parameter and the start parameter to determine your own pagination size. liquidity\_min string Optionally specify a threshold of minimum liquidity to filter results by. liquidity\_max string Optionally specify a threshold of maximum liquidity to filter results by. volume\_24h\_min string Optionally specify a threshold of minimum 24 hour USD volume to filter results by. volume\_24h\_max string Optionally specify a threshold of maximum 24 hour USD volume to filter results by. no\_of\_transactions\_24h\_min string Optionally specify a threshold of minimum 24h no. of transactions to filter results by. no\_of\_transactions\_24h\_max string Optionally specify a threshold of maximum 24h no. of transactions to filter results by. percent\_change\_24h\_min string Optionally specify a threshold of minimum 24 hour percent change to filter results by. percent\_change\_24h\_max string Optionally specify a threshold of maximum 24 hour percent change to filter results by. sort string Default:`"volume_24h"` Valid values: `"volume_24h"` `"liquidity"` `"no_of_transactions_24h"` `"percent_change_24h"` // todo Sort the list of dex spot pairs by. sort\_dir string Default:`"desc"` Valid values: `"desc"` `"asc"` The direction in which to order dex spot pairs against the specified sort. aux string Default:`""` Valid values: `"pool_created"` `"percent_pooled_base_asset"` `"num_transactions_24h"` `"pool_base_asset"` `"pool_quote_asset"` `"24h_volume_quote_asset"` `"total_supply_quote_asset"` `"total_supply_base_asset"` `"holders"` `"buy_tax"` `"sell_tax"` `"security_scan"` `"24h_no_of_buys"` `"24h_no_of_sells"` `"24h_buy_volume"` `"24h_sell_volume"` Optionally specify a comma-separated list of supplemental data fields to return. reverse\_order string Pass true to invert the order of a spot pair. For example, a trading pair is set up as Token B/Token A in the contract and is commonly referred to as Token A/Token B. Using reverse\_order would change the order to reflect the true Token B/Token A pairing as it exists in the pool. convert\_id string 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. Responses --------- 200 OK | | | | --- | --- | | 24h\_no\_of\_buys null | integer

Number of asset buys in the past 24 hours | | | | | 24h\_no\_of\_sells null | integer

Number of asset sells in the past 24 hours | | | | | 24h\_volume\_quote\_asset null | number

24 hours volume of the quote asset | | | | | base\_asset\_contract\_address null | string

The contract addres of this base asset in the spot pair. | | | | | base\_asset\_id null | string

The id of this base asset in the spot pair. | | | | | base\_asset\_name null | string

The name of this base asset in the spot pair. | | | | | base\_asset\_symbol null | string

The symbol of this base asset in the spot pair. | | | | | base\_asset\_ucid null | string

The ucid of this base asset in the spot pair. | | | | | buy\_tax null | number

Buy tax on the asset | | | | | contract\_address null | string

The unique contract address for this spot pair. | | | | | created\_at null | string

Timestamp (ISO 8601) when we started tracking this asset. | | | | | date\_launched null | string

Timestamp (ISO 8601) of the launch date for this exchange. | | | | | dex\_id null | string

The id of this dex the spot pair is on. | | | | | dex\_slug null | string

The name of this dex the spot pair is on. | | | | | holders null | integer

Number of holders of the asset | | | | | last\_updated null | string

Timestamp (ISO 8601) of the last time this record was updated. | | | | | name null | string

The name of this spot pair. | | | | | network\_id null | string

The id of the network the spot pair is on. | | | | | network\_slug null | string

The slug of the network the spot pair is on. | | | | | num\_transactions\_24h null | integer

Number of transactions in past 24 hours | | | | | percent\_pooled\_base\_asset null | number

Percentage of the base asset in the pool | | | | | pool\_base\_asset null | number

Base asset in the pool | | | | | pool\_created null | string

When the pool of the asset was created | | | | | pool\_quote\_asset null | number

Quote asset in the pool | | | | | quote null | DexQuoteDTO

A map of market quotes in different currency conversions. The default map included is USD. | | | | | quote\_asset\_contract\_address null | string

The contract addresss of this quote asset in the spot pair. | | | | | quote\_asset\_id null | string

The id of this quote asset in the spot pair. | | | | | quote\_asset\_name null | string

The name of this quote asset in the spot pair. | | | | | quote\_asset\_symbol null | string

The symbol of this quote asset in the spot pair. | | | | | quote\_asset\_ucid null | string

The ucid of this quote asset in the spot pair. | | | | | scroll\_id null | string

A unique identifier used to fetch the next batch of results from the next API related API call, if applicable. scroll\_id is an alternative to traditional pagingation techniques. | | | | | security\_scan null | SecurityScanResult

Security scan by Go+.

All infomation and data relating to contract detection are based on public third party information. CoinMarketCap does not confirm or verify the accuracy or timeliness of such information and data.

CoinMarketCap shall have no responsibility or liability for the accuracy of data, nor 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.

Only returned if passed in aux. | | | | | sell\_tax null | number

Sell tax on the asset | | | | | total\_supply\_base\_asset null | number

Total supply of the quote asset | | | | | total\_supply\_quote\_asset null | number

Total supply of the quote asset | | | | 400 Bad Request ##### get /v4/dex/spot-pairs/latest Server URL https://pro-api.coinmarketcap.com/v4/dex/spot-pairs/latest * 200 OK Copy Expand all Collapse all \[\ \ * {\ \ * "24h\_no\_of\_buys": 0,\ \ * "24h\_no\_of\_sells": 0,\ \ * "24h\_volume\_quote\_asset": 0,\ \ * "base\_asset\_contract\_address": "string",\ \ * "base\_asset\_id": "string",\ \ * "base\_asset\_name": "string",\ \ * "base\_asset\_symbol": "string",\ \ * "base\_asset\_ucid": "string",\ \ * "buy\_tax": 0,\ \ * "contract\_address": "string",\ \ * "created\_at": "2025-12-23T17:31:50Z",\ \ * "date\_launched": "2025-12-23T17:31:50Z",\ \ * "dex\_id": "string",\ \ * "dex\_slug": "string",\ \ * "holders": 0,\ \ * "last\_updated": "2025-12-23T17:31:50Z",\ \ * "name": "string",\ \ * "network\_id": "string",\ \ * "network\_slug": "string",\ \ * "num\_transactions\_24h": 0,\ \ * "percent\_pooled\_base\_asset": 0,\ \ * "pool\_base\_asset": 0,\ \ * "pool\_created": "2025-12-23T17:31:50Z",\ \ * "pool\_quote\_asset": 0,\ \ * "quote": \ \ \[\ \ * {\ \ * "24h\_buy\_volume": 0,\ \ * "24h\_sell\_volume": 0,\ \ * "convert\_id": "string",\ \ * "fully\_diluted\_value": 0,\ \ * "last\_updated": "string",\ \ * "liquidity": 0,\ \ * "percent\_change\_price\_1h": 0,\ \ * "percent\_change\_price\_24h": 0,\ \ * "price": 0,\ \ * "price\_by\_quote\_asset": 0,\ \ * "volume\_24h": 0\ \ \ }\ \ \ \],\ \ * "quote\_asset\_contract\_address": "string",\ \ * "quote\_asset\_id": "string",\ \ * "quote\_asset\_name": "string",\ \ * "quote\_asset\_symbol": "string",\ \ * "quote\_asset\_ucid": "string",\ \ * "scroll\_id": "string",\ \ * "security\_scan": \ \ \[\ \ * {\ \ * "aggregated": \ \ {\ \ * "contract\_verified": true,\ \ * "honeypot": true\ \ \ },\ \ * "third\_party": \ \ {\ \ * "airdrop\_scam": true,\ \ * "anti\_whale": true,\ \ * "anti\_whale\_modifiable": true,\ \ * "blacklisted": true,\ \ * "can\_take\_back\_ownership": true,\ \ * "cannot\_buy": true,\ \ * "cannot\_sell\_all": true,\ \ * "external\_call": true,\ \ * "hidden\_owner": true,\ \ * "honeypot": true,\ \ * "in\_dex": true,\ \ * "mintable": true,\ \ * "open\_source": true,\ \ * "owner\_change\_balance": true,\ \ * "personal\_slippage\_modifiable": true,\ \ * "proxy": true,\ \ * "self\_destruct": true,\ \ * "slippage\_modifiable": true,\ \ * "trading\_cool\_down": true,\ \ * "transfer\_pausable": true,\ \ * "true\_token": true,\ \ * "trust\_list": true,\ \ * "whitelisted": true\ \ \ }\ \ \ }\ \ \ \],\ \ * "sell\_tax": 0,\ \ * "total\_supply\_base\_asset": 0,\ \ * "total\_supply\_quote\_asset": 0\ \ \ }\ \ \ \] [](https://coinmarketcap.com/api/documentation/v1/#tag/exchange) exchange ========================================================================= ##### API endpoints for cryptocurrency exchanges. This category currently includes 7 endpoints: * [/v1/exchange/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) - CoinMarketCap ID map * [/v1/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) - Metadata * [/v1/exchange/listings/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) - Latest listings * [/v1/exchange/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) - Latest quotes * [/v1/exchange/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesHistorical) - Historical quotes * [/v1/exchange/market-pairs/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) - Latest market pairs * [/v1/exchange/assets](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeAssets) - Exchange Assets [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeAssets) 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](https://coinmarketcap.com/api/features) :** * 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/](https://coinmarketcap.com/exchanges/binance/) ##### Parameters id string ^\\d\*$ A CoinMarketCap exchange ID. Example: 270 Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Assets%20Wallets%20-%20Response%20Model | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/assets Server URL https://pro-api.coinmarketcap.com/v1/exchange/assets * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "status": { * "timestamp": "2022-11-24T08:23:22.028Z", * "error\_code": 0, * "error\_message": null, * "elapsed": 1828, * "credit\_count": 0, * "notice": null }, * "data": \[\ \ * {\ \ * "wallet\_address": "0x5a52e96bacdabb82fd05763e25335261b270efcb",\ \ * "balance": 45000000,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 5117,\ \ * "price\_usd": 0.10241799413549,\ \ * "symbol": "OGN",\ \ * "name": "Origin Protocol"\ \ \ }\ \ \ },\ \ * {\ \ * "wallet\_address": "0xf977814e90da44bfa03b6295a0616a897441acec",\ \ * "balance": 400000000,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 5824,\ \ * "price\_usd": 0.00251174724338,\ \ * "symbol": "SLP",\ \ * "name": "Smooth Love Potion"\ \ \ }\ \ \ },\ \ * {\ \ * "wallet\_address": "0x5a52e96bacdabb82fd05763e25335261b270efcb",\ \ * "balance": 5588175,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 3928,\ \ * "price\_usd": 0.04813245442357,\ \ * "symbol": "IDEX",\ \ * "name": "IDEX"\ \ \ }\ \ \ },\ \ * {\ \ * "wallet\_address": "0x5a52e96bacdabb82fd05763e25335261b270efcb",\ \ * "balance": 125000,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 1552,\ \ * "price\_usd": 20.46545919550142,\ \ * "symbol": "MLN",\ \ * "name": "Enzyme"\ \ \ }\ \ \ },\ \ * {\ \ * "wallet\_address": "0x21a31ee1afc51d94c2efccaa2092ad1028285549",\ \ * "balance": 27241191.98,\ \ * "platform": \ \ {\ \ * "crypto\_id": 1027,\ \ * "symbol": "ETH",\ \ * "name": "Ethereum"\ \ \ },\ \ * "currency": \ \ {\ \ * "crypto\_id": 14806,\ \ * "price\_usd": 0.02390427295165,\ \ * "symbol": "PEOPLE",\ \ * "name": "ConstitutionDAO"\ \ \ }\ \ \ }\ \ \ \] } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) 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](https://coinmarketcap.com/api/features) :** * 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/](https://coinmarketcap.com/exchanges/binance/) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap cryptocurrency exchange ids. Example: "1,2" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ 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 string "urls,logo,description,date\_launched,notice" ^(urls|logo|description|date\_launched|notice|status)+(?:,(urls|logo|description|date\_launched|notice|status)+)\*$ 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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchanges%20Info%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/info Server URL https://pro-api.coinmarketcap.com/v1/exchange/info * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "270": { * "id": 270, * "name": "Binance", * "slug": "binance", * "logo": "[https://s2.coinmarketcap.com/static/img/exchanges/64x64/270.png](https://s2.coinmarketcap.com/static/img/exchanges/64x64/270.png) ", * "description": "Launched in Jul-2017, Binance is a centralized exchange based in Malta.", * "date\_launched": "2017-07-14T00:00:00.000Z", * "notice": null, * "countries": \[ \], * "fiats": \[\ \ * "AED",\ \ * "USD"\ \ \ \], * "tags": null, * "type": "", * "maker\_fee": 0.02, * "taker\_fee": 0.04, * "weekly\_visits": 5123451, * "spot\_volume\_usd": 66926283498.60113, * "spot\_volume\_last\_updated": "2021-05-06T01:20:15.451Z", * "urls": { * "website": \[\ \ * "[https://www.binance.com/](https://www.binance.com/)\ "\ \ \ \], * "twitter": \[\ \ * "[https://twitter.com/binance](https://twitter.com/binance)\ "\ \ \ \], * "blog": \[ \], * "chat": \[\ \ * "[https://t.me/binanceexchange](https://t.me/binanceexchange)\ "\ \ \ \], * "fee": \[\ \ * "[https://www.binance.com/fees.html](https://www.binance.com/fees.html)\ "\ \ \ \] } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) 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](https://coinmarketcap.com/methodology/) for additional details on listing states. **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/features) :** * 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. ##### Parameters listing\_status string "active" ^(active|inactive|untracked)+(?:,(active|inactive|untracked)+)\*$ 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 string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ 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. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. sort string "id" "volume\_24h" "id" What field to sort the list of exchanges by. aux string "first\_historical\_data,last\_historical\_data,is\_active" ^(first\_historical\_data|last\_historical\_data|is\_active|status)+(?:,(first\_historical\_data|last\_historical\_data|is\_active|status)+)\*$ 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 string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Map%20-%20Exchange%20Object Required

Array of exchange object results. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/map Server URL https://pro-api.coinmarketcap.com/v1/exchange/map * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 270,\ \ * "name": "Binance",\ \ * "slug": "binance",\ \ * "is\_active": 1,\ \ * "status": "active",\ \ * "first\_historical\_data": "2018-04-26T00:45:00.000Z",\ \ * "last\_historical\_data": "2019-06-02T21:25:00.000Z"\ \ \ }\ \ \ \], * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeListingsLatest) 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * ~Startup~ * 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/](https://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._ ##### Parameters start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. sort string "volume\_24h" "name" "volume\_24h" "volume\_24h\_adjusted" "exchange\_score" What field to sort the list of exchanges by. sort\_dir string "asc" "desc" The direction in which to order exchanges against the specified sort. market\_type string "all" "fees" "no\_fees" "all" The type of exchange markets to include in rankings. This field is deprecated. Please use "all" for accurate sorting. category string "all" "all" "spot" "derivatives" "dex" "lending" The category for this exchange. aux string "num\_market\_pairs,traffic\_score,rank,exchange\_score,effective\_liquidity\_24h" ^(num\_market\_pairs|traffic\_score|rank|exchange\_score|effective\_liquidity\_24h|date\_launched|fiats)+(?:,(num\_market\_pairs|traffic\_score|rank|exchange\_score|effective\_liquidity\_24h|date\_launched|fiats)+)\*$ 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 string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Listings%20Latest%20-%20Exchange%20object Required

Array of exchange objects matching the list options. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/listings/latest Server URL https://pro-api.coinmarketcap.com/v1/exchange/listings/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": \[\ \ * {\ \ * "id": 270,\ \ * "name": "Binance",\ \ * "slug": "binance",\ \ * "num\_market\_pairs": 1214,\ \ * "fiats": \ \ \[\ \ * "AED",\ \ * "USD"\ \ \ \],\ \ * "traffic\_score": 1000,\ \ * "rank": 1,\ \ * "exchange\_score": null,\ \ * "liquidity\_score": 9.8028,\ \ * "last\_updated": "2018-11-08T22:18:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 769291636.239632,\ \ * "volume\_24h\_adjusted": 769291636.239632,\ \ * "volume\_7d": 3666423776,\ \ * "volume\_30d": 21338299776,\ \ * "percent\_change\_volume\_24h": \-11.6153,\ \ * "percent\_change\_volume\_7d": 67.2055,\ \ * "percent\_change\_volume\_30d": 0.00169339,\ \ * "effective\_liquidity\_24h": 629.9774,\ \ * "derivative\_volume\_usd": 62828618628.85901,\ \ * "spot\_volume\_usd": 39682580614.8572\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "id": 294,\ \ * "name": "OKEx",\ \ * "slug": "okex",\ \ * "num\_market\_pairs": 385,\ \ * "fiats": \ \ \[\ \ * "AED",\ \ * "USD"\ \ \ \],\ \ * "traffic\_score": 845.1565,\ \ * "rank": 1,\ \ * "exchange\_score": null,\ \ * "liquidity\_score": 9.8028,\ \ * "last\_updated": "2018-11-08T22:18:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 677439315.721563,\ \ * "volume\_24h\_adjusted": 677439315.721563,\ \ * "volume\_7d": 3506137120,\ \ * "volume\_30d": 14418225072,\ \ * "percent\_change\_volume\_24h": \-13.9256,\ \ * "percent\_change\_volume\_7d": 60.0461,\ \ * "percent\_change\_volume\_30d": 67.2225,\ \ * "effective\_liquidity\_24h": 629.9774,\ \ * "derivative\_volume\_usd": 62828618628.85901,\ \ * "spot\_volume\_usd": 39682580614.8572\ \ \ }\ \ \ }\ \ \ }\ \ \ \], * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMarketpairsLatest) 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * ~Startup~ * 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/](https://coinmarketcap.com/exchanges/binance/) . ##### Parameters id string ^\\d\*$ A CoinMarketCap exchange ID. Example: "1" slug string ^\[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. start integer \>= 1 1 Optionally offset the start (1-based index) of the paginated list of items to return. limit integer \[ 1 .. 5000 \] 100 Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size. aux string "num\_market\_pairs,category,fee\_type" ^(num\_market\_pairs|category|fee\_type|market\_url|currency\_name|currency\_slug|price\_quote|effective\_liquidity|market\_score|market\_reputation)+(?:,(num\_market\_pairs|category|fee\_type|market\_url|currency\_name|currency\_slug|price\_quote|effective\_liquidity|market\_score|market\_reputation)+)\*$ 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 string ^\\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 string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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. category string "all" "all" "spot" "derivatives" "otc" "futures" "perpetual" The category of trading this market falls under. Spot markets are the most common but options include derivatives and OTC. fee\_type string "all" "all" "percentage" "no-fees" "transactional-mining" "unknown" The fee type the exchange enforces for this market. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Market%20Pairs%20Latest%20-%20Results%20object Required

Results of your query returned as an object. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/market-pairs/latest Server URL https://pro-api.coinmarketcap.com/v1/exchange/market-pairs/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 270, * "name": "Binance", * "slug": "binance", * "num\_market\_pairs": 473, * "volume\_24h": 769291636.239632, * "market\_pairs": \[\ \ * {\ \ * "market\_id": 9933,\ \ * "market\_pair": "BTC/USDT",\ \ * "category": "spot",\ \ * "fee\_type": "percentage",\ \ * "outlier\_detected": 0,\ \ * "exclusions": null,\ \ * "market\_pair\_base": \ \ {\ \ * "currency\_id": 1,\ \ * "currency\_symbol": "BTC",\ \ * "exchange\_symbol": "BTC",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "market\_pair\_quote": \ \ {\ \ * "currency\_id": 825,\ \ * "currency\_symbol": "USDT",\ \ * "exchange\_symbol": "USDT",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "quote": \ \ {\ \ * "exchange\_reported": \ \ {\ \ * "price": 7901.83,\ \ * "volume\_24h\_base": 47251.3345550653,\ \ * "volume\_24h\_quote": 373372012.927251,\ \ * "volume\_percentage": 19.4346563602467,\ \ * "last\_updated": "2019-05-24T01:40:10.000Z"\ \ \ },\ \ * "USD": \ \ {\ \ * "price": 7933.66233493434,\ \ * "volume\_24h": 374876133.234903,\ \ * "depth\_negative\_two": 40654.68019906,\ \ * "depth\_positive\_two": 17352.9964811,\ \ * "last\_updated": "2019-05-24T01:40:10.000Z"\ \ \ }\ \ \ }\ \ \ },\ \ * {\ \ * "market\_id": 36329,\ \ * "market\_pair": "MATIC/BTC",\ \ * "category": "spot",\ \ * "fee\_type": "percentage",\ \ * "outlier\_detected": 0,\ \ * "exclusions": null,\ \ * "market\_pair\_base": \ \ {\ \ * "currency\_id": 3890,\ \ * "currency\_symbol": "MATIC",\ \ * "exchange\_symbol": "MATIC",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "market\_pair\_quote": \ \ {\ \ * "currency\_id": 1,\ \ * "currency\_symbol": "BTC",\ \ * "exchange\_symbol": "BTC",\ \ * "currency\_type": "cryptocurrency"\ \ \ },\ \ * "quote": \ \ {\ \ * "exchange\_reported": \ \ {\ \ * "price": 0.0000034,\ \ * "volume\_24h\_base": 8773968381.05,\ \ * "volume\_24h\_quote": 29831.49249557,\ \ * "volume\_percentage": 19.4346563602467,\ \ * "last\_updated": "2019-05-24T01:41:16.000Z"\ \ \ },\ \ * "USD": \ \ {\ \ * "price": 0.0269295015799739,\ \ * "volume\_24h": 236278595.380127,\ \ * "depth\_negative\_two": 40654.68019906,\ \ * "depth\_positive\_two": 17352.9964811,\ \ * "last\_updated": "2019-05-24T01:41:16.000Z"\ \ \ }\ \ \ }\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesHistorical) 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](https://coinmarketcap.com/api/features) :** * ~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/](https://coinmarketcap.com/rankings/exchanges/) . ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated exchange CoinMarketCap ids. Example: "24,270" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ 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\_start string Timestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time\_end". time\_end string Timestamp (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. count number \[ 1 .. 10000 \] 10 The 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. interval string "5m" "yearly" "monthly" "weekly" "daily" "hourly" "5m" "10m" "15m" "30m" "45m" "1h" "2h" "3h" "4h" "6h" "12h" "24h" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d" Interval of time to return data points for. See details in endpoint description. convert string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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 string ^\\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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Historical%20Quotes%20-%20Results%20map Required

Results of your query returned as an object map. | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/quotes/historical Server URL https://pro-api.coinmarketcap.com/v1/exchange/quotes/historical * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "id": 270, * "name": "Binance", * "slug": "binance", * "quotes": \[\ \ * {\ \ * "timestamp": "2018-06-03T00:00:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 1632390000,\ \ * "timestamp": "2018-06-03T00:00:00.000Z"\ \ \ }\ \ \ },\ \ * "num\_market\_pairs": 338\ \ \ },\ \ * {\ \ * "timestamp": "2018-06-10T00:00:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 1034720000,\ \ * "timestamp": "2018-06-10T00:00:00.000Z"\ \ \ }\ \ \ },\ \ * "num\_market\_pairs": 349\ \ \ },\ \ * {\ \ * "timestamp": "2018-06-17T00:00:00.000Z",\ \ * "quote": \ \ {\ \ * "USD": \ \ {\ \ * "volume\_24h": 883885000,\ \ * "timestamp": "2018-06-17T00:00:00.000Z"\ \ \ }\ \ \ },\ \ * "num\_market\_pairs": 357\ \ \ }\ \ \ \] }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeQuotesLatest) 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](https://coinmarketcap.com/api/features) :** * ~Basic~ * ~Hobbyist~ * ~Startup~ * 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/](https://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._ ##### Parameters id string ^\\d+(?:,\\d+)\*$ One or more comma-separated CoinMarketCap exchange IDs. Example: "1,2" slug string ^\[0-9a-z-\]+(?:,\[0-9a-z-\]+)\*$ 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 string ^\[0-9A-Za-z$@\\-,\]+(?:,\[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](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . Each conversion is returned in its own "quote" object. convert\_id string ^\\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 string "num\_market\_pairs,traffic\_score,rank,exchange\_score,liquidity\_score,effective\_liquidity\_24h" ^(num\_market\_pairs|traffic\_score|rank|exchange\_score|liquidity\_score|effective\_liquidity\_24h)+(?:,(num\_market\_pairs|traffic\_score|rank|exchange\_score|liquidity\_score|effective\_liquidity\_24h)+)\*$ 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. Responses --------- 200 Successful | | | | --- | --- | | data null | Exchange%20Quotes%20Latest%20-%20Exchange%20Results%20map Required

A map of exchange objects by ID or slugs (as used in query parameters). | | | | | status null | API%20Status%20Object

Standardized status object for API calls. | | | | 400 Bad Request 401 Unauthorized 403 Forbidden 429 Too Many Requests 500 Internal Server Error ##### get /v1/exchange/quotes/latest Server URL https://pro-api.coinmarketcap.com/v1/exchange/quotes/latest * 200 Successful * 400 Bad Request * 401 Unauthorized * 403 Forbidden * 429 Too Many Requests * 500 Internal Server Error Copy Expand all Collapse all { * "data": { * "270": { * "id": 270, * "name": "Binance", * "slug": "binance", * "num\_coins": 132, * "num\_market\_pairs": 385, * "last\_updated": "2018-11-08T22:11:00.000Z", * "traffic\_score": 1000, * "rank": 1, * "exchange\_score": null, * "liquidity\_score": 9.8028, * "quote": { * "USD": { * "volume\_24h": 768478308.529847, * "volume\_24h\_adjusted": 768478308.529847, * "volume\_7d": 3666423776, * "volume\_30d": 21338299776, * "percent\_change\_volume\_24h": \-11.8232, * "percent\_change\_volume\_7d": 67.0306, * "percent\_change\_volume\_30d": \-0.0821558, * "effective\_liquidity\_24h": 629.9774 } } } }, * "status": { * "timestamp": "2025-12-22T01:00:04.967Z", * "error\_code": 0, * "error\_message": "", * "elapsed": 10, * "credit\_count": 1, * "notice": "" } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 400, * "error\_message": "Invalid value for \\"id\\"", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1002, * "error\_message": "API key missing.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1006, * "error\_message": "Your API Key subscription plan doesn't support this endpoint.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 1008, * "error\_message": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute.", * "elapsed": 10, * "credit\_count": 0 } } Copy Expand all Collapse all { * "status": { * "timestamp": "2018-06-02T22:51:28.209Z", * "error\_code": 500, * "error\_message": "An internal server error occurred", * "elapsed": 10, * "credit\_count": 0 } } [](https://coinmarketcap.com/api/documentation/v1/#tag/global-metrics) global-metrics ===================================================================================== ##### API endpoints for global aggregate market data. This category currently includes 2 endpoints: * [/v1/global-metrics/quotes/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesLatest) - Latest global metrics * [/v1/global-metrics/quotes/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV1GlobalmetricsQuotesHistorical) - Historical global metrics [](https://coinmarketcap.com/api/documentation/v1/#tag/CMC20-Index) CMC20 Index =============================================================================== ##### API endpoints for CoinMarketCap20 Index. This category currently includes 2 endpoints: * [/v3/index/cmc20-latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC20Latest) - Latest CoinMarketCap 20 Index * [/v3/index/cmc20-historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC20Historical) - Historical CoinMarketCap 20 Index Your Product shall prominently provide attribution to CoinMarketCap as follows: "Data provided by [CoinMarketCap.com](http://coinmarketcap.com/) " and shall include a hyperlink to such website. For more details on the commercial agreement, visit [https://pro.coinmarketcap.com/user-agreement-commercial/](https://pro.coinmarketcap.com/user-agreement-commercial/) or contact us at [https://support.coinmarketcap.com/hc/en-us/requests/new?ticket\_form\_id=360001156492](https://support.coinmarketcap.com/hc/en-us/requests/new?ticket_form_id=360001156492) . [](https://coinmarketcap.com/api/documentation/v1/#tag/CMC100-Index) CMC100 Index ================================================================================= ##### API endpoints for CoinMarketCap100 Index. This category currently includes 2 endpoints: * [/v3/index/cmc100-latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC100Latest) - Latest CoinMarketCap 100 Index * [/v3/index/cmc100-historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3IndexCMC100Historical) - Historical CoinMarketCap 100 Index Your Product shall prominently provide attribution to CoinMarketCap as follows: "Data provided by [CoinMarketCap.com](http://coinmarketcap.com/) " and shall include a hyperlink to such website. For more details on the commercial agreement, visit [https://pro.coinmarketcap.com/user-agreement-commercial/](https://pro.coinmarketcap.com/user-agreement-commercial/) or contact us at [https://support.coinmarketcap.com/hc/en-us/requests/new?ticket\_form\_id=360001156492](https://support.coinmarketcap.com/hc/en-us/requests/new?ticket_form_id=360001156492) . [](https://coinmarketcap.com/api/documentation/v1/#tag/fear-and-greed) fear-and-greed ===================================================================================== ##### API endpoints for cryptocurrencies. This category currently includes 2 endpoints: * [/v3/fear-and-greed/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedLatest) - Latest CMC Crypto Fear and Greed Index * [/v3/fear-and-greed/historical](https://coinmarketcap.com/api/documentation/v1/#operation/getV3FearandgreedHistorical) - Historical CMC Crypto Fear and Greed Index CMC Crypto Fear and Greed APIs are free to use for personal and commercial purposes. Any commercial product using the API should prominently feature the following text: "Data provided by [CoinMarketCap.com](http://coinmarketcap.com/) " with a hyperlink to [https://coinmarketcap.com/](https://coinmarketcap.com/) . For more details on the commercial agreement, visit [https://pro.coinmarketcap.com/user-agreement-commercial/](https://pro.coinmarketcap.com/user-agreement-commercial/) or contact us at [https://support.coinmarketcap.com/hc/en-us/requests/new?ticket\_form\_id=360001156492](https://support.coinmarketcap.com/hc/en-us/requests/new?ticket_form_id=360001156492) . [](https://coinmarketcap.com/api/documentation/v1/#tag/fiat) fiat ================================================================= ##### API endpoints for fiat currencies. This category currently includes 1 endpoint: * [/v1/fiat/map](https://coinmarketcap.com/api/documentation/v1/#operation/getV1FiatMap) - CoinMarketCap ID map [](https://coinmarketcap.com/api/documentation/v1/#tag/tools) tools =================================================================== ##### API endpoints for convenience utilities. This category currently includes 1 endpoint: * [/v2/tools/price-conversion](https://coinmarketcap.com/api/documentation/v1/#operation/getV2ToolsPriceconversion) - Price conversion tool * [/v1/tools/postman](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ToolsPostman) - Postman tool [](https://coinmarketcap.com/api/documentation/v1/#tag/blockchain) blockchain ============================================================================= ##### API endpoints for blockchain data. This category currently includes 1 endpoint: * [/v1/blockchain/statistics/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1BlockchainStatisticsLatest) - Latest statistics [](https://coinmarketcap.com/api/documentation/v1/#tag/content) content ======================================================================= ##### API endpoints for content data. This category currently includes 4 endpoints: * [/v1/content/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentLatest) - Content latest * [/v1/content/posts/top](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsTop) - Content top posts * [/v1/content/posts/latest](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsLatest) - Content latest posts * [/v1/content/posts/comments](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ContentPostsComments) - Content post comments [](https://coinmarketcap.com/api/documentation/v1/#tag/community) community =========================================================================== ##### API endpoints for community data. This category currently includes 2 endpoints: * [/v1/community/trending/topic](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingTopic) - Community Trending Topics * [/v1/community/trending/token](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CommunityTrendingToken) - Community Trending Tokens [](https://coinmarketcap.com/api/documentation/v1/#tag/key) key =============================================================== ##### API endpoints for managing your API key. This category currently includes 1 endpoint: * [/v1/key/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1KeyInfo) - Key Info [](https://coinmarketcap.com/api/documentation/v1/#tag/deprecated) deprecated ============================================================================= ##### Deprecated (V1) Endpoints These endpoints have been replaced with their V2 versions, and are no longer being actively supported. We strongly suggest migrating to V2 endpoints, and this documentation only exists for legacy purposes. --- # The World's Number 1 Cryptocurrency Market Data API 🎉 The Wait is Over: CMC Releases 5 New APIs to Complete DEX Suite. [Learn more](https://coinmarketcap.com/academy/article/the-wait-is-over-cmc-releases-5-new-apis-to-complete-dex-suite) API [Documentation](https://coinmarketcap.com/api/documentation/v1/) [Pricing](https://coinmarketcap.com/api/pricing/) [Standard API](https://coinmarketcap.com/api/pricing/) [DEX API](https://coinmarketcap.com/api/pricing/#dex) [FAQ](https://coinmarketcap.com/api/faq/) Sign Up Log in The Ultimate Cryptocurrency API From the Industry Authority =========================================================== Get the most comprehensive cryptocurrency and DEX data, trusted by everyone from individual developers to the largest finance and crypto institutions. Get Started For Free No credit card required See Pricing No credit card required ![](https://s2.coinmarketcap.com/static/cloud/img/portal/cmcHomepageLogoMobile.png?_=7da7485) Trusted by the World's Leading Companies ---------------------------------------- ![](https://s2.coinmarketcap.com/static/cloud/img/portal/ourCustomersMobile.png?_=7da7485) The Most Advanced Data Source In Crypto --------------------------------------- 14 years Of historical data 2.4 million+ Tracked assets 790+ Exchanges 1 billion+ Calls per month 40+ Endpoints We Have The Data For Your Needs ------------------------------- ### Standard API: Your Crypto Data Powerhouse Get instant access to live prices, market caps, and historical data. Perfect for developers, analysts, and traders who demand the best. Real-Time Prices: Access up-to-the-minute crypto prices. Extensive Historical Data: Analyze trends and make informed predictions. Easy API Integration: Fast (and free) setup for immediate access to data. See Pricing ### Dex API: Your Edge in DeFi Empower your DeFi projects with our DEX API. From real-time transaction data to historical insights, gain access to everything needed for a successful decentralized trading strategy. Instant On-Chain Data: Snipe the best trades with real-time data. All Major DEXs Covered: Access comprehensive data from top exchanges. Live Trade Feed: Catch every swap as it happens. See Pricing Find The Right Solution For You ------------------------------- ![](https://s2.coinmarketcap.com/static/cloud/img/portal/pricingPlansCut.png?_=7da7485) Pricing Plans for Every Budget From hobbyists to large businesses, find the perfect plan that fits your needs and budget. See Pricing Plans ![](https://s2.coinmarketcap.com/static/cloud/img/portal/exploreDocumentation.png?_=7da7485) Get Started Quickly and Easily Our detailed documentation ensures an easy set-up and smooth integration process, guiding you step-by-step from setup to execution. Explore Documentation ![](https://s2.coinmarketcap.com/static/cloud/img/portal/seeCaseStudies.png?_=7da7485) Case Studies from Our Clients Discover how our clients achieved success with our API, transforming ideas into impactful solutions. See Case Studies Unlock Our Data, Your Way ------------------------- ### Backtest Your Strategies Run simulations and backtest your trading or investing strategies. Use our data to help create and refine profitable crypto trading models. All time historical data available on our Enterprise plan ensures that you have full visibility of all cryptocurrency data since 2010. ### Hunt for Profitable Trading Opportunities Uncover mispricing and arbitrage opportunities by comparing crypto asset price data on both centralized and decentralized exchanges, across multiple blockchains, and against multiple fiat currencies. ### Beat the Competition Explore how other exchanges and coins are performing. With deep insight into current and past pricing, volume and exchange info, you can make the right decisions to stay ahead of the game. ### Build the Most Accurate Charts Show your users the most accurate data on the market with our API. Whether you're building a wallet, a portfolio management tool, a new media offering, or more, we have the most advanced and updated data on the market for your product. Frequently Asked Questions -------------------------- ### How to start with the CoinMarketCap API integration? Getting started with the CoinMarketCap API is simple. First, sign up for an API key [here](https://pro.coinmarketcap.com/signup/) . Once you have your key, you can access comprehensive documentation that provides step-by-step guides, code samples, and best practices for integrating the API into your application. Whether you're building a trading bot, a portfolio management tool, or a market analysis platform, our resources will help you integrate quickly and efficiently. ### What kind of data can I access with the CoinMarketCap API? The CoinMarketCap API provides access to a wide range of cryptocurrency and exchange data, including:   • **Latest Cryptocurrency Pricing:** Get real-time prices, market capitalization, and 24-hour volume data.   • **Historical Data:** Access OHLCV (Open, High, Low, Close, Volume) data for historical analysis.   • **Market Pairs Quotes:** Retrieve data on trading pairs across multiple exchanges.   • **Trending Data:** Stay updated on the latest gainers, losers, and most visited coins.   • **Global Metrics:** Analyze metrics like total market cap, BTC dominance, and more.   • **Exchange Data:** Monitor exchange-specific information such as asset holdings and trading volumes.   • **Content Data:** Educational and factual content related to the cryptocurrency market. With varying levels of access depending on your subscription plan, you can tailor the data to suit your specific needs. ### Can I use the API for commercial projects? Yes, the CoinMarketCap API is designed to support both personal and commercial projects. For commercial use, the **Enterprise** plan offers the most comprehensive access, including custom call limits, high-resolution historical data, and commercial licensing options. ### What support is available if I encounter issues? CoinMarketCap provides multiple levels of support depending on your plan:   • **Standard Support:** Email support is available for all users, ensuring you receive timely assistance with your queries.   • **Priority Support:** Users on the Enterprise plan benefit from priority support, including faster response times and access to dedicated support channels.   • **Comprehensive Documentation:** In addition to direct support, our extensive API documentation includes troubleshooting guides, FAQs, and code samples to help you resolve common issues on your own. No matter your plan, we’re here to ensure your experience with our API is smooth and successful. ### What coins and tokens can I track using CMC’s API? CMC’s Crypto API service tracks thousands of coins and tokens, but we have found that the majority of our customers are interested in the most liquid and highly traded crypto assets. This means that if you want blockchain data, altcoin or a DeFi API, we have it. It also means that if you want to track any major asset, you can. These major cryptos include Bitcoin, Ethereum, Dogecoin, Litecoin, Ripple / XRP, Bitcoin Cash, Cronos, Tron, Chainlink, Solana, Cardano, Dash, BNB, Fantom and Tezos. Show more --- # Frequently Asked Questions for Crypto Market API API [Documentation](https://coinmarketcap.com/api/documentation/v1/) [Pricing](https://coinmarketcap.com/api/pricing/) [Standard API](https://coinmarketcap.com/api/pricing/) [DEX API](https://coinmarketcap.com/api/pricing/#dex) [FAQ](https://coinmarketcap.com/api/faq/) Sign Up Log in Frequently Asked Questions ========================== This API specific FAQ outlines answers to common questions about the CoinMarketCap API product. For questions around CoinMarketCap's general data gathering and reporting conventions, please check out the [CoinMarketCap FAQ.](https://www.coinmarketcap.com/) General FAQ What is the CoinMarketCap API for? The CoinMarketCap API is our enterprise-grade cryptocurrency API for all crypto data use cases from personal, academic, to commercial. The API is a suite of high-performance RESTful JSON endpoints that allow application developers, data scientists, and enterprise business platforms to tap into the latest raw and derived cryptocurrency and exchange market data as well as years of historical data. This is the same data that powers [coinmarketcap.com](https://www.coinmarketcap.com/) which has been opened up for your use cases. What can I expect from the Developer Portal? The CoinMarketCap Developer portal is the central account management portal for your API Key and optional subscription plan while using the API. Outside of viewing the [API Documentation](https://coinmarketcap.com/api/documentation/v1) and [FAQ](https://coinmarketcap.com/api/faq/) , you can self-provision your API Key, change and upgrade your plan, manage billing, view your monthly usage, audit your API request logs, and manage account level configuration like notifications. Do you have a free version of the CoinMarketCap API? CoinMarketCap is committed to always providing the crypto community with a robust free API through our free Basic tier. Even on free Basic our users can benefits from enterprise grade infrastructure, documentation, and flexibility. If your needs outgrow our free offering check out our commercial use and enterprise offerings. Data FAQ What cryptocurrencies and exchanges are available with the CoinMarketCap API? The API surfaces all current and historical cryptocurrency and exchange data available on [coinmarketcap.com](https://www.coinmarketcap.com/) since it originally went live in 2013. See the general [CoinMarketCap FAQ](https://coinmarketcap.com/faq/) for listing criteria and considerations. How frequently do the market data endpoints update? Most endpoints update every 1 minute. The update frequency for each endpoint is outlined in the endpoint's description in our [API Documentation.](https://coinmarketcap.com/api/documentation/v1/) Do you support pricing data in my local currency? The API supports displaying market pricing data in 93 different fiat currencies as well as 4 precious metals so we likely do. You can view the full list of supported currencies in our API documentation [here](https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions) . This list can be fetched programmatically using our [fiat map endpoint.](https://coinmarketcap.com/api/documentation/v1/#operation/getV1FiatMap) I need a large volume of historical market data. What's the best way to get that? All of our historical market data is available over API and that is the preferred delivery method for many of our customers. How far back does your historical cryptocurrency and exchange data go? Our historical cryptocurrency data goes back to 2013. You can list all active and inactive cryptocurrencies using our [cryptocurrency map endpoint](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyMap) . You can list all active and inactive exchanges using our [exchange map endpoint.](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeMap) Each cryptocurrency and exchange returned from these endpoints include a "first\_historical\_data" timestamp letting you know how far our historical records go back. Are cryptocurrency and exchange logo image assets available via API? Yes, our [/cryptocurrency/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyInfo) and [/exchange/info](https://coinmarketcap.com/api/documentation/v1/#operation/getV1ExchangeInfo) metadata endpoints include hosted logo assets in PNG format. 64px is the default size returned but you may replace "64x64" in the image path with these alternative sizes: 16, 32, 64, 128, 200. Pricing Plans When should I consider an Enterprise plan? You should consider an enterprise plan if you need higher API call credit and rate limits, access to more historical data, a custom license outside of our [standard commercial agreement](https://pro.coinmarketcap.com/user-agreement-commercial/) and/or a Service Level Agreement. How can I tell if a pricing tier has the data I need? You can check the expanded feature matrix on the [API Plan Feature Comparison](https://coinmarketcap.com/api/pricing) page. The [API documentation](https://coinmarketcap.com/api/documentation/v1/#section/Authentication) also outlines what plans support what API endpoints, just look under the description field for any particular endpoint. If you're still unsure, feel free to reach out to us using this request form. How do API Call Credits and soft/hard caps work? As the API offers enterprise level pagination, usage is tracked not by amount of API calls, but by number of data points returned. This is typically 1 "call credit" per 100 data points returned unless otherwise specified in endpoint documentation. A more detailed outline of this system can be found in our [API documentation.](https://coinmarketcap.com/api/documentation/v1/#section/Authentication) Our [plan features](https://coinmarketcap.com/api/pricing) page outlines the maximum number of call credits that can be consumed each day and month at each tier. These are outlined as soft caps and hard caps. Soft caps are suggested limits that can give you some room before you reach your hard limit for the period. Period limits reset either at the end of each UTC day and month, or in-sync with a paid plan's monthly subscription cycle. You can click the "?" on your [API Credit Usage](https://pro.coinmarketcap.com/account) panel for these details specific to your API key. How do Rate Limits work? This is the number of HTTP calls that can be made simultaneously or within the same minute with your API Key before receiving an HTTP 429 "Too Many Requests" API throttling error. This limit increases with the [usage tier](https://coinmarketcap.com/api/pricing) and resets every 60 seconds. Please review our [best practices](https://coinmarketcap.com/api/documentation/v1/#section/Best-Practices) for implementation strategies that work well with rate limiting. API Warning & Errors What cryptocurrencies and exchanges are available with the CoinMarketCap API? Yes! For your convenience we notify you by email when your API key reaches above 95% of monthly credit usage limits. You may disable these notifications or configure additional alerts via your account [notifications page.](https://pro.coinmarketcap.com/login?returnUrl=%2Faccount%2Fnotifications) I received an email alert that I used 100% of my daily credit limit. What should I do? We plan to remove the daily limit and only use the monthly limit. Period limits reset either at the end of each UTC day and month, or in-sync with a paid plan's monthly subscription cycle. You can click the "?" icon on your [API Credit Usage panel](https://pro.coinmarketcap.com/account) for details specific to your plan. If hitting your monthly credit limit prematurely concerns you, you can [upgrade your plan](https://pro.coinmarketcap.com/account/plan) for more credits, otherwise you may ignore or even [disable](https://pro.coinmarketcap.com/account/notifications) this warning. Supported plans may also enable Overage Billing, see below. How can I turn on/off overage billing? Enable overage billing to prevent your API requests from being blocked if you happen to exceed your plan's monthly API credit usage limits. At the end of each billing period, we'll include an overage charge for any credit usage above your standard monthly limit using your plan's [standard cost-per-credit rate.](https://coinmarketcap.com/api/pricing) Enable or disable this feature by toggling the "Enable overage billing" checkbox under "Subscription Details" on the [Plan & Billing tab.](https://pro.coinmarketcap.com/account/plan) _Overage billing is currently only supported by monthly credit card subscriptions._ Why did I receive a Access-Control-Allow-Origin error while trying to use the API? This CORS error means you are trying to make HTTP requests directly to the API from JavaScript in the client-side of your application which is not supported. This restriction is to protect your API Key as anyone viewing your application could open their browser's Developer Tools to view your HTTP requests and steal your API Key. You should prevent your API Key from being visible on your client-side by proxying your requests through your own backend script. Why did I get a notice about redacted market details on an exchange endpoint? As a premier data authority for exchange market data, we are actively working with every exchange to ensure their data is not only available to us, but also available to you over the new API service. You may see this notice when market data for an exchange is in our system but not yet available over the API. There are only a handful left to confirm and this notice may all but disappear over the upcoming weeks. In the meantime a -1 response means the exchange's data is not yet available over API. Feature Requests & Support Where can I monitor for any API service disruptions or issues? Service disruptions are rare but reported on our public [API health dashboard.](https://status.coinmarketcap.com/) You may subscribe to updates using the button on that page. How quickly can I expect responses to support requests? Customers on paid plans can expect to receive answers within 24 hours. When will your new planned features be released? Will I automatically benefit? We roll out new enhancements to the API monthly. Customers who are already subscribed to a plan automatically gain access to these new features. You can also reference our [Version History](https://coinmarketcap.com/api/documentation/v1/#section/Version-History) which is updated with every release. I'm already an API subscriber. How do I upgrade, downgrade, or cancel my subscription? We'd be happy to assist with any account servicing needs. Please reach out to us using this [request form.](https://support.coinmarketcap.com/hc/en-us/requests/new?ticket_form_id=360001156492) I have a question, issue, or feature request that isn't covered in the API Documentation or this FAQ. Where should I direct it? We'd love to get your question answered and added to the API Documentation or this FAQ. You can reach out to us using this [request form](https://support.coinmarketcap.com/hc/en-us/requests/new?ticket_form_id=360001156492) and we'll get back to you as soon as we can. Do you have more questions? Contact Us --- # CoinMarketCap API Pricing Plans API [Documentation](https://coinmarketcap.com/api/documentation/v1/) [Pricing](https://coinmarketcap.com/api/pricing/) [Standard API](https://coinmarketcap.com/api/pricing/) [DEX API](https://coinmarketcap.com/api/pricing/#dex) [FAQ](https://coinmarketcap.com/api/faq/) Sign Up Log in * ** Standard API ** Standard API * ** DEX API New ** DEX API New Standard API Pricing ==================== Start integrating for free or choose a plan which best suits your needs Monthly Yearly Save up to 20% Basic Basic personal use Free No subscription required Get Your Free API Key * 11 data endpoints * 10K call credits/mo * No historical data * Personal use Hobbyist Personal projects $29/mo $420$348/year Get Started * 15 data endpoints * 110K call credits/mo * 12 months of historical data * Personal use Startup For commercial use $79/mo $1140$948/year Get Started * 23 data endpoints * 300K call credits/mo * 24 months of historical data * Commercial use\*  Recommended Standard Suitable for most use cases $299/mo $4500$3588/year Get Started * 28 data endpoints * 1.2M call credits/mo * 60 months of historical data * Commercial use\*  Professional Best for scaling crypto projects $699/mo $10500$8388/year Get Started * All data endpoints * 3M call credits/mo * All time historical data * Commercial use\*  Enterprise Do you need more data or features? Customize a pricing plan that scales to your business' needs Contact Us * All data endpoints * Custom call limits * All time historical data in full resolution * Custom license Trusted by The World’s Leading Companies ![](https://s2.coinmarketcap.com/static/cloud/img/portal/companyBg.png?_=7da7485) Compare Editions And Top Features Basic Free Get Free API Key Hobbyist $29/mo Get Started Startup $79/mo Get Started Recommended Standard $299/mo Get Started Professional $699/mo Get Started Enterprise Inquire for pricing Contact Us Rest API Monthly API credits Support License Rate Limit Update frequency Currency conversions 11 data endpoints & exchange asset reserve endpoints 10,000 Basic email Personal use 30 requests per minute Every 1 minute \*\* Limit 1 per call 15 latest market data endpoints, exchange asset reserve & limited historical market data endpoints 110,000 Basic email Personal use 30 requests per minute Every 1 minute \*\* Limit 8 per call 23 latest market data endpoints, exchange asset reserve & limited historical market data endpoints 300,000 Email Commercial use \* 30 requests per minute Every 1 minute \*\* Limit 40 per call 28 latest market data endpoints, exchange asset reserve & historical market data endpoints 1,200,000 Email Commercial use \* 60 requests per minute Every 1 minute \*\* Limit 40 per call 35 latest market data endpoints, exchange asset reserve & historical market data endpoints 3,000,000 Priority email Commercial use \* 90 requests per minute Every 1 minute \*\* Limit 80 per call 35 latest market data endpoints, exchange asset reserve & historical market data endpoints 30,000,000 Priority email Custom license 120+ requests per minute Every 1 minute \*\* Limit 120 per call Cryptocurrency Data Rankings Information Pricing Latest Pricing Historical \* \* \* \* \* OHLCV Pricing Latest OHLCV Pricing Historical \*\* \*\* \*\* \*\* Market Pairs Quotes Latest Price Performance Statistics Trending (Latest, Gainers & Losers, and Most Visited) Listing Latest Listings Historical (1 month) (1 month) (3 months) (12 months) (Up to 14 years) Listings New Categories Exchange Data Rankings Exchange Assets Information Volume Latest Volume Historical \* \* \* \* \* Market Pair Quotes Global Metrics Data Quotes Latest Quotes Historical \* \* \* \* \* Content Data Trending Topics Trending Token Community Posts Community Posts Comments Top Posts News + Articles Historical data 1 month (5 min interval), 12 months (daily interval) \* = 1 month (5 min interval),24 months (daily interval) \*\* = 1 month (1 hour interval),24 months (daily interval) \* = 3 months (5 min interval),60 months (daily interval) \* = 3 months (1 hour interval),60 months (daily interval) \* = 12 months (5 min interval),All-time (daily interval) \*\* = 12 months (1 hour interval),All-time (daily interval) \* = All-time historical data (5 min and daily interval) \*\* = All-time historical data (1 hour and daily interval) Enterprise Features SLA 99.9%/mo QIntegration assistance Dedicated infrastructure \* For 1 product only, up to 100k users. No data redistribution permitted. See [Terms of Use](https://pro.coinmarketcap.com/user-agreement-commercial/) for more details. \*\* Most endpoints update every 1 minute. See [API Documentation](https://coinmarketcap.com/api/documentation/v1/) for specific update frequency published for each endpoint. Frequently Asked Questions (FAQ) -------------------------------- ### Are there any upfront costs or hidden fees? No, there are no upfront costs or hidden fees associated with any of our pricing plans. The prices listed on our pricing page are transparent and all-inclusive, covering the full range of features and data access outlined in each plan. You can rest assured that there will be no surprises or additional charges beyond the subscription cost. ### Are there any discounts available for yearly subscriptions? Yes, we offer significant discounts for yearly subscriptions compared to monthly billing. By choosing an annual plan, you can save up to 20% on your subscription, making it a cost-effective option for those planning to use our API long-term. This discount is automatically applied when you select the yearly billing option during checkout. ### Can I switch plans or cancel my subscription at any time? Absolutely! We understand that your needs may change, so we offer the flexibility to upgrade, downgrade, or cancel your subscription at any time. You can manage your subscription directly through your account dashboard, ensuring you have complete control over your plan. ### Does the Basic plan really offer free access? Yes, the **Basic** plan provides truly free access with no subscription required. It includes essential market data such as rankings, latest pricing, and listings, making it perfect for personal use or for those who want to test the API before committing to a paid plan. There’s no time limit, and you can upgrade to a paid plan anytime if you need more advanced features. ### What does 'commercial use approved' mean in the pricing plans? Commercial use approved means that the API plan you've selected grants you the right to integrate CoinMarketCap data into commercial products, services, or applications that you intend to distribute, sell, or use in a business context. Our Startup, Standard, Professional, and Enterprise plans include commercial use rights, allowing you to confidently embed our data into your business offerings. These plans ensure compliance with our licensing terms, providing the legal framework necessary to support your commercial activities. However, it's crucial to understand that while you can use the data within your own products, this license is limited, non-exclusive, and non-transferable. You are not allowed to redistribute or resell the data as a standalone service, such as through your own API or as part of a data distribution product. The data must be an integrated component of a larger product offering, designed for end users who utilize your product for personal, non-commercial purposes. For more details, please refer to our Commercial Terms of Use: [https://pro.coinmarketcap.com/user-agreement-commercial/](https://pro.coinmarketcap.com/user-agreement-commercial/) . ### How long are your contracts? Our contracts are flexible and designed to meet your needs. We offer both **monthly** and **yearly** subscription options. If you choose a monthly plan, your contract renews every month, giving you the flexibility to cancel or switch plans at the end of each billing cycle. If you opt for a yearly plan, your contract will last for 12 months, but you benefit from significant savings of up to 20% compared to the monthly rate. Regardless of the plan you choose, there are no long-term commitments, so you have the freedom to manage your subscription as needed. ### Can I upgrade at any time? Yes, you can upgrade your plan at any time. Whether you find that your data needs have grown or you're ready to access more advanced features, upgrading is quick and easy. Simply log into your account dashboard, choose the plan you'd like to upgrade to, and the change will take effect immediately. Any unused portion of your current plan will be prorated towards the new plan, ensuring that you only pay the difference. This flexibility ensures that your API access can scale with your needs, without any disruption to your service. --- # Unknown ![](https://s2.coinmarketcap.com/static/cloud/img/404.png?_=7514f89) Oops! Looks like something went wrong. Please try again later. [Download App](https://coinmarketcap.com/mobile) [Back to Homepage](https://coinmarketcap.com/) ---