Deprecated (V1) Endpoints
These endpoints have been replaced by their V2/V3 versions and are no longer actively supported. We strongly recommend migrating to the latest versions.
- /v1/cryptocurrency/info - Metadata v1
- /v1/tools/price-conversion - Price Conversion v1
- /v1/cryptocurrency/market-pairs/latest - Market Pairs Latest v1
- /v1/cryptocurrency/ohlcv/historical - OHLCV Historical v1
- /v1/cryptocurrency/ohlcv/latest - OHLCV Latest v1
- /v1/cryptocurrency/price-performance-stats/latest - Price Performance Stats v1
- /v1/cryptocurrency/quotes/historical - Quotes Historical v1
- /v1/cryptocurrency/quotes/latest - Quotes Latest v1
- /v1/partners/flipside-crypto/fcas/listings/latest - FCAS Listings Latest
- /v1/partners/flipside-crypto/fcas/quotes/latest - FCAS Quotes Latest
Legacy cryptocurrency quotes (V2)
Prefer /v3/cryptocurrency/quotes/latest and /v3/cryptocurrency/quotes/historical.
- /v2/cryptocurrency/quotes/latest - Quotes Latest v2
- /v2/cryptocurrency/quotes/historical - Quotes Historical v2
Metadata v1 (deprecated)
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.
This endpoint is available on the following API plans:
- 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/.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2"
slug^[0-9a-z-]+(?:,[0-9a…Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"
symbol^[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.
addressAlternatively pass in a contract address. Example: "0xc40af1e4fecfa05ce6bab79dcd8b373d2e436c4e"
skip_invalidPass 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^(urls|logo|descript…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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Metadata v1 (deprecated) › Responses
Successful
Results of your query returned as an object map.
Standardized status object for API calls.
Price Conversion v1 (deprecated)
Convert an amount of one cryptocurrency or fiat currency into one or more different currencies utilizing the latest market rate for each currency. You may optionally pass a historical timestamp as time to convert values based on historical rates (as your API plan supports).
Technical Notes
- Latest market rate conversions are accurate to 1 minute of specificity. Historical conversions are accurate to 1 minute of specificity outside of non-USD fiat conversions which have 5 minute specificity.
- You may reference a current list of all supported cryptocurrencies via the cryptocurrency/map endpoint. This endpoint also returns the supported date ranges for historical conversions via the
first_historical_dataandlast_historical_dataproperties. - Conversions are supported in 93 different fiat currencies and 4 precious metals as outlined here. Historical fiat conversions are supported as far back as 2013-04-28.
- A
last_updatedtimestamp is included for both your source currency and each conversion currency. This is the timestamp of the closest market rate record referenced for each currency during the conversion.
This endpoint is available on the following API plans:
- Basic (Latest market price conversions)
- Hobbyist (Latest market price conversions + 1 month historical)
- Startup (Latest market price conversions + 1 month historical)
- Standard (Latest market price conversions + 3 months historical)
- Professional (Latest market price conversions + 12 months historical)
- Enterprise (Latest market price conversions + up to 6 years historical)
Cache / Update frequency: Every 60 seconds for the lastest cryptocurrency and fiat currency rates.
Plan credit use: 1 call credit per call and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our cryptocurrency conversion page at coinmarketcap.com/converter/.
query Parameters
amountAn amount of currency to convert. Example: 10.43
id^\d*$The CoinMarketCap currency ID of the base cryptocurrency or fiat to convert from. Example: "1"
symbol^[0-9A-Za-z$@\-]*$Alternatively the currency symbol of the base cryptocurrency or fiat to convert from. Example: "BTC". One "id" or "symbol" is required. Please note that starting in the v2 endpoint, due to the fact that a symbol is not unique, if you request by symbol each quote 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.
timeOptional timestamp (Unix or ISO 8601) to reference historical pricing during conversion. If not passed, the current time will be used. If passed, we'll reference the closest historic values available for this conversion.
convert^[0-9A-Za-z$@\-,]+(?…Pass up to 120 comma-separated fiat or cryptocurrency symbols to convert the source amount to.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Price Conversion v1 (deprecated) › Responses
Successful
Results object for your API call.
Standardized status object for API calls.
Market Pairs Latest v1 (deprecated)
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.
This endpoint is available on the following API plans:
BasicHobbyistStartup- Standard
- Professional
- Enterprise
Cache / Update frequency: Every 1 minute.
Plan credit use: 1 call credit per 100 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.
query Parameters
idA cryptocurrency or fiat currency by CoinMarketCap ID to list market pairs for. Example: "1"
slug^[0-9a-z-]*$Alternatively pass a cryptocurrency by slug. Example: "bitcoin"
symbol^[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.
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
sort_dirOptionally specify the sort direction of markets returned.
sortOptionally 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^(num_market_pairs|c…Optionally specify a comma-separated list of supplemental data fields to return. Pass num_market_pairs,category,fee_type,market_url,currency_name,currency_slug,price_quote,notice,cmc_rank,effective_liquidity,market_score,market_reputation to include all auxiliary fields.
matched_id^\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^[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.
categoryThe category of trading this market falls under. Spot markets are the most common but options include derivatives and OTC.
fee_typeThe fee type the exchange enforces for this market.
convert^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Market Pairs Latest v1 (deprecated) › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
OHLCV Historical v1 (deprecated)
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.
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:
BasicHobbyist- 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/.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,1027"
slug^[0-9a-z-]+(?:,[0-9a…Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"
symbol^[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_periodTime 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_startTimestamp (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_endTimestamp (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.
countOptionally limit the number of time periods to return results for. The default is 10 items. The current query limit is 10000 items.
intervalOptionally 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^[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^\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_invalidPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
OHLCV Historical v1 (deprecated) › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
OHLCV Latest v1 (deprecated)
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.
This endpoint is available on the following API plans:
BasicHobbyist- 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.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2
symbol^[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^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
skip_invalidPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
OHLCV Latest v1 (deprecated) › Responses
Successful
A map of cryptocurrency objects by ID or symbol (as passed in query parameters).
Standardized status object for API calls.
Price Performance Stats v1 (deprecated)
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.
This endpoint is available on the following API plans:
BasicHobbyist- 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.
NOTE: You may also use /cryptocurrency/ohlcv/historical for traditional OHLCV data at historical daily and hourly intervals. You may also use /v1/cryptocurrency/ohlcv/latest for OHLCV data for the current UTC day.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2
slug^[0-9a-z-]+(?:,[0-9a…Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"
symbol^[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^(all_time|yesterday…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^[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. Each conversion is returned in its own "quote" object.
convert_id^\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_invalidPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Price Performance Stats v1 (deprecated) › Responses
Successful
An object map of cryptocurrency objects by ID, slug, or symbol (as used in query parameters).
Standardized status object for API calls.
Quotes Historical v1 (deprecated)
Returns an interval of historic market quotes for any cryptocurrency 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.
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:
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.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2"
symbol^[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_startTimestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time_end".
time_endTimestamp (Unix or ISO 8601) to stop returning quotes for (inclusive). Optional, if not passed, we'll default to the current time. If no "time_start" is passed, we return quotes in reverse order starting from this time.
countThe number of interval periods to return results for. Optional, required if both "time_start" and "time_end" aren't supplied. The default is 10 items. The current query limit is 10000.
intervalInterval of time to return data points for. See details in endpoint description.
convert^[0-9A-Za-z$@\-,]+(?…By default market quotes are returned in USD. Optionally calculate market quotes in up to 3 other fiat currencies or cryptocurrencies.
convert_id(^\d+(?:,\d+)*$|(\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^(price|volume|marke…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_invalidPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Quotes Historical v1 (deprecated) › Responses
Successful
Results of your query returned as an object map.
Standardized status object for API calls.
Quotes Latest v1 (deprecated)
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.
This endpoint is available on the following API plans:
- 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/.
NOTE: Use this endpoint to request the latest quote for specific cryptocurrencies. If you need to request all cryptocurrencies use /v1/cryptocurrency/listings/latest which is optimized for that purpose. The response data between these endpoints is otherwise the same.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2
slug^[0-9a-z-]+(?:,[0-9a…Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"
symbol^[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^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
convert_id(^\d+(?:,\d+)*$|(\d,…Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
aux^(num_market_pairs|c…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_invalidPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Quotes Latest v1 (deprecated) › Responses
Successful
A map of cryptocurrency objects by ID, symbol, or slug (as used in query parameters).
Standardized status object for API calls.
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 the deprecated section.
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:
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.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2"
symbol^[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_startTimestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time_end".
time_endTimestamp (Unix or ISO 8601) to stop returning quotes for (inclusive). Optional, if not passed, we'll default to the current time. If no "time_start" is passed, we return quotes in reverse order starting from this time.
countThe number of interval periods to return results for. Optional, required if both "time_start" and "time_end" aren't supplied. The default is 10 items. The current query limit is 10000.
intervalInterval of time to return data points for. See details in endpoint description.
convert^[0-9A-Za-z$@\-,]+(?…By default market quotes are returned in USD. Optionally calculate market quotes in up to 3 other fiat currencies or cryptocurrencies.
convert_id(^\d+(?:,\d+)*$|(\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^(price|volume|marke…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_invalidPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Quotes Historical v2 › Responses
Successful
Results of your query returned as an object map.
Standardized status object for API calls.
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 the deprecated section.
This endpoint is available on the following API plans:
- 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/.
NOTE: Use this endpoint to request the latest quote for specific cryptocurrencies. If you need to request all cryptocurrencies use /v1/cryptocurrency/listings/latest which is optimized for that purpose. The response data between these endpoints is otherwise the same.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2
slug^[0-9a-z-]+(?:,[0-9a…Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"
symbol^[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^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
convert_id(^\d+(?:,\d+)*$|(\d,…Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
aux^(num_market_pairs|c…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_invalidPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Quotes Latest v2 › Responses
Successful
A map of cryptocurrency objects by ID, symbol, or slug (as used in query parameters).
Standardized status object for API calls.
FCAS Listings Latest (deprecated)
Returns a paginated list of FCAS scores for all cryptocurrencies currently supported by FCAS. FCAS ratings are on a 0-1000 point scale with a corresponding letter grade and is updated once a day at UTC midnight.
FCAS stands for Fundamental Crypto Asset Score, a single, consistently comparable value for measuring cryptocurrency project health. FCAS measures User Activity, Developer Behavior and Market Maturity and is provided by FlipSide Crypto. Find out more about FCAS methodology. Users interested in FCAS historical data including sub-component scoring may inquire through our CSV Data Delivery request form.
Disclaimer: Ratings that are calculated by third party organizations and are not influenced or endorsed by CoinMarketCap in any way.
This endpoint is available on the following API plans:
- Basic
- Hobbyist
- Startup
- Standard
- Professional
- Enterprise
Cache / Update frequency: Once a day at UTC midnight.
Plan credit use: 1 call credit per 100 FCAS scores returned (rounded up).
CMC equivalent pages: The FCAS ratings available under our cryptocurrency ratings tab like coinmarketcap.com/currencies/bitcoin/#ratings.
NOTE: Use this endpoint to request the latest FCAS score for all supported cryptocurrencies at the same time. If you require FCAS for only specific cryptocurrencies use /v1/partners/flipside-crypto/fcas/quotes/latest which is optimized for that purpose. The response data between these endpoints is otherwise the same.
query Parameters
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
aux^(point_change_24h|p…Optionally specify a comma-separated list of supplemental data fields to return. Pass point_change_24h,percent_change_24h to include all auxiliary fields.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
FCAS Listings Latest (deprecated) › Responses
Successful
Array of cryptocurrency objects matching the list options.
Standardized status object for API calls.
FCAS Quotes Latest (deprecated)
Returns the latest FCAS score for 1 or more cryptocurrencies. FCAS ratings are on a 0-1000 point scale with a corresponding letter grade and is updated once a day at UTC midnight.
FCAS stands for Fundamental Crypto Asset Score, a single, consistently comparable value for measuring cryptocurrency project health. FCAS measures User Activity, Developer Behavior and Market Maturity and is provided by FlipSide Crypto. Find out more about FCAS methodology. Users interested in FCAS historical data including sub-component scoring may inquire through our CSV Data Delivery request form.
Disclaimer: Ratings that are calculated by third party organizations and are not influenced or endorsed by CoinMarketCap in any way.
This endpoint is available on the following API plans:
- Basic
- Hobbyist
- Startup
- Standard
- Professional
- Enterprise
Cache / Update frequency: Once a day at UTC midnight.
Plan credit use: 1 call credit per 100 FCAS scores returned (rounded up).
CMC equivalent pages: The FCAS ratings available under our cryptocurrency ratings tab like coinmarketcap.com/currencies/bitcoin/#ratings.
NOTE: Use this endpoint to request the latest FCAS score for specific cryptocurrencies. If you require FCAS for all supported cryptocurrencies use /v1/partners/flipside-crypto/fcas/listings/latest which is optimized for that purpose. The response data between these endpoints is otherwise the same.
query Parameters
id^\d+(?:,\d+)*$One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2
slug^[0-9a-z-]+(?:,[0-9a…Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"
symbol^[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.
aux^(point_change_24h|p…Optionally specify a comma-separated list of supplemental data fields to return. Pass point_change_24h,percent_change_24h to include all auxiliary fields.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
FCAS Quotes Latest (deprecated) › Responses
Successful
A map of cryptocurrency objects by ID or symbol (as used in query parameters).
Standardized status object for API calls.
Trades Latest
Returns up to the latest 100 trades for 1 spot pair. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.
query Parameters
contract_addressOne or more comma-separated contract addresses.
network_idOne CoinMarketCap cryptocurrency network id.
network_slugAlternatively, one network names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens).
auxDefault:""
Valid values: "transaction_hash" "blockchain_explorer_link"
Optionally specify a comma-separated list of supplemental data fields to return.
convert_idOptionally calculate market quotes in up to 30 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency IDs. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found in our API document. Each conversion is returned in its own "trade" object.
skip_invalidPass 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_orderPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Trades Latest › Responses
OK
A map of market quotes in different currency conversions. The default map included is USD.
contract_addressThe unique contract address for this spot pair.
nameThe name of this spot pair.
base_asset_idThe id of this base asset in the spot pair.
base_asset_ucidThe ucid of this base asset in the spot pair.
base_asset_nameThe name of this base asset in the spot pair.
base_asset_symbolThe symbol of this base asset in the spot pair.
base_asset_contract_addressThe contract addres of this base asset in the spot pair.
quote_asset_idThe id of this quote asset in the spot pair.
quote_asset_ucidThe ucid of this quote asset in the spot pair.
quote_asset_nameThe name of this quote asset in the spot pair.
quote_asset_symbolThe symbol of this quote asset in the spot pair.
quote_asset_contract_addressThe contract addresss of this quote asset in the spot pair.
dex_idThe id of this dex the spot pair is on.
dex_slugThe name of this dex the spot pair is on.
network_idThe id of the network the spot pair is on.
network_slugThe slug of the network the spot pair is on.
last_updatedTimestamp (ISO 8601) of the last time this record was updated.
created_atTimestamp (ISO 8601) when we started tracking this asset.
num_transactions_24hNumber of transactions in past 24 hours
holdersNumber of holders of the asset
24h_no_of_buysNumber of asset buys in the past 24 hours
24h_no_of_sellsNumber of asset sells in the past 24 hours
pool_createdWhen the pool of the asset was created
buy_taxBuy tax on the asset
sell_taxSell tax on the asset
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.
pool_base_assetBase asset in the pool
pool_quote_assetQuote asset in the pool
percent_pooled_base_assetPercentage of the base asset in the pool
24h_volume_quote_asset24 hours volume of the quote asset
total_supply_quote_assetTotal supply of the quote asset
total_supply_base_assetTotal supply of the quote asset
date_launchedTimestamp (ISO 8601) of the launch date for this exchange.
OHLCV Latest
Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more spot pairs 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 /dex/pairs/ohlcv/historical.
query Parameters
contract_addressOne or more comma-separated contract addresses.
network_idOne or more CoinMarketCap cryptocurrency network ids
network_slugAlternatively, one network names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens).
auxDefault:""
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_idOptionally 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_invalidPass 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_orderPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
OHLCV Latest › Responses
OK
A map of market quotes in different currency conversions. The default map included is USD.
contract_addressThe unique contract address for this spot pair.
nameThe name of this spot pair.
base_asset_idThe id of this base asset in the spot pair.
base_asset_ucidThe ucid of this base asset in the spot pair.
base_asset_nameThe name of this base asset in the spot pair.
base_asset_symbolThe symbol of this base asset in the spot pair.
base_asset_contract_addressThe contract addres of this base asset in the spot pair.
quote_asset_idThe id of this quote asset in the spot pair.
quote_asset_ucidThe ucid of this quote asset in the spot pair.
quote_asset_nameThe name of this quote asset in the spot pair.
quote_asset_symbolThe symbol of this quote asset in the spot pair.
quote_asset_contract_addressThe contract addresss of this quote asset in the spot pair.
dex_idThe id of this dex the spot pair is on.
dex_slugThe name of this dex the spot pair is on.
network_idThe id of the network the spot pair is on.
network_slugThe slug of the network the spot pair is on.
last_updatedTimestamp (ISO 8601) of the last time this record was updated.
created_atTimestamp (ISO 8601) when we started tracking this asset.
num_transactions_24hNumber of transactions in past 24 hours
holdersNumber of holders of the asset
24h_no_of_buysNumber of asset buys in the past 24 hours
24h_no_of_sellsNumber of asset sells in the past 24 hours
pool_createdWhen the pool of the asset was created
buy_taxBuy tax on the asset
sell_taxSell tax on the asset
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.
pool_base_assetBase asset in the pool
pool_quote_assetQuote asset in the pool
percent_pooled_base_assetPercentage of the base asset in the pool
24h_volume_quote_asset24 hours volume of the quote asset
total_supply_quote_assetTotal supply of the quote asset
total_supply_base_assetTotal supply of the quote asset
date_launchedTimestamp (ISO 8601) of the launch date for this exchange.
time_openTimestamp (ISO 8601) of the start of this OHLCV period.
time_closeTimestamp (ISO 8601) of the end of this OHLCV period. Always null as the current day is incomplete. See last_updated for the last UTC time included in the current OHLCV calculation.
OHLCV Historical
Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any spot pairs using time interval parameters.
query Parameters
contract_addressOne contract address. Example:"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640". If network/dex/base asset/quote asset information is passed, contract address cannot be passed. Note: contract_address is case sensitive for all non-EVM chains and not case sensitive for all EVM chains. EVM chains contract address addresses begin with 0x, and are followed by 40 alphanumeric characters(numerals and letters)
network_idOne or more CoinMarketCap cryptocurrency network ids
network_slugAlternatively, one network names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens).
time_periodDefault:"daily"
Valid values: "daily" "hourly" "1m" "5m" "15m" "4h"
Time period to return OHLCV data for. 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_startTimestamp (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_endTimestamp (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.
countOptionally limit the number of time periods to return results for. The default is 10 items. The current query limit is 500 items.
intervalDefault:"daily"
Valid values: "1m" "5m" "15m" "30m" "1h" "4h" "8h" "12h" "daily" "weekly" "monthly"
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.
auxDefault:""
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_idOptionally 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_invalidPass 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_orderPass 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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
OHLCV Historical › Responses
OK
Collection of historical OHLCV quotes for the DEX pair
contract_addressThe unique contract address for this spot pair.
nameThe name of this spot pair.
base_asset_idThe id of this base asset in the spot pair.
base_asset_ucidThe ucid of this base asset in the spot pair.
base_asset_nameThe name of this base asset in the spot pair.
base_asset_symbolThe symbol of this base asset in the spot pair.
base_asset_contract_addressThe contract addres of this base asset in the spot pair.
quote_asset_idThe id of this quote asset in the spot pair.
quote_asset_ucidThe ucid of this quote asset in the spot pair.
quote_asset_nameThe name of this quote asset in the spot pair.
quote_asset_symbolThe symbol of this quote asset in the spot pair.
quote_asset_contract_addressThe contract addresss of this quote asset in the spot pair.
dex_idThe id of this dex the spot pair is on.
dex_slugThe name of this dex the spot pair is on.
network_idThe id of the network the spot pair is on.
network_slugThe slug of the network the spot pair is on.
last_updatedTimestamp (ISO 8601) of the last time this record was updated.
created_atTimestamp (ISO 8601) when we started tracking this asset.
num_transactions_24hNumber of transactions in past 24 hours
holdersNumber of holders of the asset
24h_no_of_buysNumber of asset buys in the past 24 hours
24h_no_of_sellsNumber of asset sells in the past 24 hours
pool_createdWhen the pool of the asset was created
buy_taxBuy tax on the asset
sell_taxSell tax on the asset
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.
pool_base_assetBase asset in the pool
pool_quote_assetQuote asset in the pool
percent_pooled_base_assetPercentage of the base asset in the pool
24h_volume_quote_asset24 hours volume of the quote asset
total_supply_quote_assetTotal supply of the quote asset
total_supply_base_assetTotal supply of the quote asset
date_launchedTimestamp (ISO 8601) of the launch date for this exchange.
CoinMarketCap ID Map
Returns a list of all networks to unique CoinMarketCap ids.Per our Best Practices we recommend utilizing CMC ID instead of network symbols to securely identify networks with our other endpoints and in your own application logic. Each network returned includes typical identifiers such as name, symbol, and token_address for flexible mapping to id.
query Parameters
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
sortDefault:"id"
Valid values: "id" "name"
What field to sort the list of networks by.
sort_dirDefault:"desc"
Valid values: "desc" "asc"
The direction in which to order networks against the specified sort.
auxDefault:""
Valid values: "alternativeName" "cryptocurrencyId" "cryptocurrenySlug" "wrappedTokenId" "wrappedTokenSlug" "tokenExplorerUrl" "poolExplorerUrl" "transactionHashUrl"
Optionally specify a comma-separated list of supplemental data fields to return.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
CoinMarketCap ID Map › Responses
OK
idThe unique CoinMarketCap ID for this network.
nameThe name of this network.
alternativeNameThe alternate name for this network.
cryptocurrencyIdThe unique CoinMarketCap identifier for the cryptocurrency associated with this network.
cryptocurrencySlugThe slug(URL-friendly name) for the associated cryptocurrency
wrappedTokenIdThe unique identifier for the wrapped token on this network.
wrappedTokenSlugThe slug(URL-friendly name) for the wrapped token on this network.
tokenExplorerUrlThe URL for exploring tokens on this network.
poolExplorerUrlThe URL for exploring liquidity pools on this network.
transactionHashUrlThe URL for exploring transaction hashes on this network.
network_slugThe slug of the network the spot pair is on.
DEX Listings Latest
Returns a paginated list of all decentralised 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.
query Parameters
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
sortDefault:"volume_24h"
Valid values: "name" "volume_24h" "market_share" "num_markets"
What field to sort the list of exchanges by.
sort_dirDefault:"desc"
Valid values: "desc" "asc"
The direction in which to order exchanges against the specified sort.
typeDefault:"all"
Valid values: "all" "orderbook" "swap" "aggregator"
The category for this exchange.
auxDefault:""
Valid values: "date_launched"
Optionally specify a comma-separated list of supplemental data fields to return.
convert_idOptionally calculate market quotes in up to 30 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency IDs. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found in our API document. Each conversion is returned in its own "quote" object.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
DEX Listings Latest › Responses
OK
idThe unique CoinMarketCap ID for this exchange.
nameThe name of this exchange.
slugThe web URL friendly shorthand version of this exchange name.
logoLink to a CoinMarketCap hosted logo png for this exchange. 64px is default size returned. Replace "64x64" in the image path with these alternative sizes: 16, 32, 64, 128, 200
statusCurrent status of the DEX. Can be "active" or "inactive".
descriptionA CoinMarketCap supplied brief description of this DEX pair. This field will return null if a description is not available.
noticeA Markdown formatted message outlining a condition that is impacting the availability of the exchange's market data or the secure use of the exchange, otherwise null. This may include a maintenance event on the exchange's end or CoinMarketCap's end, an alert about reported issues with withdrawls from this exchange, or another condition that may be impacting the exchange and it's markets. If present, this notice is also displayed in an alert banner at the top of the exchange's page on coinmarketcap.com.
An object containing various resource URLs for this exchange.
typeThe type of DEX this exchange is, such as, Orderbook, Swap, and Aggregator.
A map of market quotes in different currency conversions. The default map included is USD.
date_launchedTimestamp (ISO 8601) of the date this exchange launched. This field is only returned if requested through the aux request parameter.
num_market_pairsThe number of trading pairs actively tracked on this exchange.
last_updatedTimestamp (ISO 8601) of the last time this record was updated.
market_sharePercentage of DEX market share based on volume.
DEX Metadata
Returns all static metadata for one or more decentralised exchanges. This information includes details like launch date, logo, official website URL, social links, and market fee documentation URL.
query Parameters
idOne or more comma-separated CoinMarketCap cryptocurrency exchange ids.
auxDefault:""
Valid values: "urls" "logo" "description" "date_launched" "notice"
Optionally specify a comma-separated list of supplemental data fields to return.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
DEX Metadata › Responses
OK
idThe unique CoinMarketCap ID for this exchange.
nameThe name of this exchange.
slugThe web URL friendly shorthand version of this exchange name.
logoLink to a CoinMarketCap hosted logo png for this exchange. 64px is default size returned. Replace "64x64" in the image path with these alternative sizes: 16, 32, 64, 128, 200
statusCurrent status of the DEX. Can be "active" or "inactive".
descriptionA CoinMarketCap supplied brief description of this DEX pair. This field will return null if a description is not available.
noticeA Markdown formatted message outlining a condition that is impacting the availability of the exchange's market data or the secure use of the exchange, otherwise null. This may include a maintenance event on the exchange's end or CoinMarketCap's end, an alert about reported issues with withdrawls from this exchange, or another condition that may be impacting the exchange and it's markets. If present, this notice is also displayed in an alert banner at the top of the exchange's page on coinmarketcap.com.
An object containing various resource URLs for this exchange.
date_launchedTimestamp (ISO 8601) of the date this exchange launched. This field is only returned if requested through the aux request parameter.