Endpoints for global aggregate market data. This category includes 4 endpoints:
- /v1/global-metrics/quotes/latest - Quotes Latest
- /v1/global-metrics/quotes/historical - Quotes Historical
- /v3/fear-and-greed/latest - CMC Crypto Fear and Greed Latest
- /v3/fear-and-greed/historical - CMC Crypto Fear and Greed Historical
CMC Crypto Fear and Greed Historical
Returns a paginated list of all CMC Crypto Fear and Greed values at 12am UTC time.
This endpoint is available on the following API plans:
- Basic
- Startup
- Hobbyist
- Standard
- Professional
- Enterprise
Cache / Update frequency: Every 15 seconds.
Plan credit use: 1 API call credit per request no matter query size.
CMC equivalent pages: Our CMC Crypto Fear and Greed Index card on https://coinmarketcap.com/charts/.
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.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
CMC Crypto Fear and Greed Historical › Responses
Successful
Fear and Greed Historical.
Standardized status object for API calls.
CMC Crypto Fear and Greed Latest
Returns the lastest CMC Crypto Fear and Greed value.
This endpoint is available on the following API plans:
- Basic
- Startup
- Hobbyist
- Standard
- Professional
- Enterprise
Cache / Update frequency: Every 15 minutes.
Plan credit use: 1 call credit per request.
CMC equivalent pages: Our CMC Crypto Fear and Greed Index card on https://coinmarketcap.com/charts/.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
CMC Crypto Fear and Greed Latest › Responses
Successful
The latest CMC Fear and Greed value.
Standardized status object for API calls.
Quotes Historical
Returns an interval of historical global cryptocurrency market metrics 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.
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).
CMC equivalent pages: Our Total Market Capitalization global chart coinmarketcap.com/charts/.
query Parameters
time_startTimestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time_end".
time_endTimestamp (Unix or ISO 8601) to stop returning quotes for (inclusive). Optional, if not passed, we'll default to the current time. If no "time_start" is passed, we return quotes in reverse order starting from this time.
countThe number of interval periods to return results for. Optional, required if both "time_start" and "time_end" aren't supplied. The default is 10 items. The current query limit is 10000.
intervalInterval of time to return data points for. See details in endpoint description.
convert^[0-9A-Za-z$@\-,]+(?…By default market quotes are returned in USD. Optionally calculate market quotes in up to 3 other fiat currencies or cryptocurrencies.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
aux^(btc_dominance|eth_…Optionally specify a comma-separated list of supplemental data fields to return. Pass btc_dominance,eth_dominance,active_cryptocurrencies,active_exchanges,active_market_pairs,total_volume_24h,total_volume_24h_reported,altcoin_market_cap,altcoin_volume_24h,altcoin_volume_24h_reported,search_interval to include all auxiliary fields.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Quotes Historical › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Quotes Latest
Returns the latest global cryptocurrency market metrics. 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
- Hobbyist
- Startup
- Standard
- Professional
- Enterprise
Cache / Update frequency: Every 5 minute.
Plan credit use: 1 call credit per call and 1 call credit per convert option beyond the first.
CMC equivalent pages: The latest aggregate global market stats ticker across all CMC pages like coinmarketcap.com.
query Parameters
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
Quotes Latest › Responses
Successful
Results object for your API call.
Standardized status object for API calls.