{
"openapi": "3.1.1",
"info": {
"title": "CoinMarketCap Keyless Public API",
"version": "3.0.3",
"description": "The CoinMarketCap endpoints you can call with no API key. Send requests to https://pro-api.coinmarketcap.com/public-api and do not send the X-CMC_PRO_API_KEY header. Keyless requests share an IP-based rate limit. For higher limits and the full Pro and DEX catalog, use the full spec with a free API key: https://coinmarketcap.com/api/documentation/openapi.json. Guide: https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api",
"contact": {
"email": "api@coinmarketcap.com"
},
"termsOfService": "https://coinmarketcap.com/terms/"
},
"tags": [
{
"name": "Cryptocurrency"
},
{
"name": "Exchange"
},
{
"name": "Global Metrics"
},
{
"name": "CMC Index"
},
{
"name": "Token"
},
{
"name": "Platform"
},
{
"name": "Holder"
},
{
"name": "OHLCV"
},
{
"name": "Tools"
}
],
"paths": {
"/v1/cryptocurrency/map": {
"get": {
"summary": "Cryptocurrency ID Map",
"operationId": "getV1CryptocurrencyMap",
"x-keyless": true,
"description": "Returns a mapping of all cryptocurrencies to unique CoinMarketCap `id`s. Per our [Best practices](/guides/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`. \n \n 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 for additional details on listing states. \n \n 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. \n\n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Builder\n - Startup\n - Growth\n - Professional\n - Enterprise\n\n **No credit is needed when querying this endpoint.**\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/cryptocurrency/map`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Mapping data is updated only as needed, every 30 seconds. \n**CMC equivalent pages:** No equivalent, this data is only available via API.",
"parameters": [
{
"description": "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.",
"name": "listing_status",
"in": "query",
"schema": {
"type": "string",
"pattern": "^(active|inactive|untracked)+(?:,(active|inactive|untracked)+)*$",
"default": "active"
}
},
{
"description": "Optionally offset the start (1-based index) of the paginated list of items to return.",
"name": "start",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"default": 1
}
},
{
"description": "Optionally specify the number of results to return. Use this parameter and the \"start\" parameter to determine your own pagination size.",
"name": "limit",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
{
"description": "What field to sort the list of cryptocurrencies by.",
"name": "sort",
"in": "query",
"schema": {
"type": "string",
"enum": [
"cmc_rank",
"id"
],
"default": "id"
}
},
{
"description": "Optionally pass a comma-separated list of cryptocurrency symbols to return CoinMarketCap IDs for. If this option is passed, other options will be ignored.",
"name": "symbol",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-,]+(?:,[0-9A-Za-z$@\\-]+)*$"
}
},
{
"description": "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.",
"name": "aux",
"in": "query",
"schema": {
"type": "string",
"pattern": "^(platform|first_historical_data|last_historical_data|is_active|status)+(?:,(platform|first_historical_data|last_historical_data|is_active|status)+)*$",
"default": "platform,first_historical_data,last_historical_data,is_active"
}
}
],
"tags": [
"Cryptocurrency"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Cryptocurrency_Map_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v3/cryptocurrency/listings/latest": {
"get": {
"tags": [
"Cryptocurrency"
],
"summary": "Listings Latest",
"description": "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.\n\n\nYou may sort against any of the following: \n**market_cap**: CoinMarketCap's market cap rank as outlined in [our methodology](https://coinmarketcap.com/methodology/). \n**market_cap_strict**: A strict market cap sort (latest trade price x circulating supply). \n**name**: The cryptocurrency name. \n**symbol**: The cryptocurrency symbol. \n**date_added**: Date cryptocurrency was added to the system. \n**price**: latest average trade price across markets. \n**circulating_supply**: approximate number of coins currently in circulation. \n**total_supply**: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned). \n**max_supply**: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency. \n**num_market_pairs**: number of market pairs across all exchanges trading each currency. \n**market_cap_by_total_supply_strict**: market cap by total supply. \n**volume_24h**: rolling 24 hour adjusted trading volume. \n**volume_7d**: rolling 24 hour adjusted trading volume. \n**volume_30d**: rolling 24 hour adjusted trading volume. \n**percent_change_1h**: 1 hour trading price percentage change for each currency. \n**percent_change_24h**: 24 hour trading price percentage change for each currency. \n**percent_change_7d**: 7 day trading price percentage change for each currency. \n\n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Builder\n - Startup\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v3/cryptocurrency/listings/latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 60 seconds. \n**Plan credit use:** 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per \\`convert\\` option beyond the first.\n**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/). \n \n***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 `/v3/cryptocurrency/quotes/latest` which is optimized for that purpose. The response data between these endpoints is otherwise the same.* ",
"operationId": "getV3CryptocurrencyListingsLatest",
"x-keyless": true,
"parameters": [
{
"name": "start",
"in": "query",
"description": "Optionally offset the start (1-based index) of the paginated list of items to return.",
"required": false,
"example": "50",
"schema": {
"type": "string",
"default": "1"
}
},
{
"name": "limit",
"in": "query",
"description": "Optionally specify the number of results to return. Use this parameter and the \\\"start\\\" parameter to determine your own pagination size.",
"required": false,
"example": "100",
"schema": {
"type": "string",
"default": "100"
}
},
{
"name": "price_min",
"in": "query",
"description": "Optionally specify a threshold of minimum USD price to filter results by.",
"required": false,
"example": "50000",
"schema": {
"type": "string"
}
},
{
"name": "price_max",
"in": "query",
"description": "Optionally specify a threshold of maximum USD price to filter results by.",
"required": false,
"example": "50000",
"schema": {
"type": "string"
}
},
{
"name": "market_cap_min",
"in": "query",
"description": "Optionally specify a threshold of minimum market cap to filter results by.",
"required": false,
"example": "50000",
"schema": {
"type": "string"
}
},
{
"name": "market_cap_max",
"in": "query",
"description": "Optionally specify a threshold of maximum market cap to filter results by.",
"required": false,
"example": "50000",
"schema": {
"type": "string"
}
},
{
"name": "volume_24h_min",
"in": "query",
"description": "Optionally specify a threshold of minimum 24 hour USD volume to filter results by.",
"required": false,
"example": "50000",
"schema": {
"type": "string"
}
},
{
"name": "volume_24h_max",
"in": "query",
"description": "Optionally specify a threshold of maximum 24 hour USD volume to filter results by.",
"required": false,
"example": "50000",
"schema": {
"type": "string"
}
},
{
"name": "circulating_supply_min",
"in": "query",
"description": "Optionally specify a threshold of minimum circulating supply to filter results by.",
"required": false,
"example": "50000",
"schema": {
"type": "string"
}
},
{
"name": "circulating_supply_max",
"in": "query",
"description": "Optionally specify a threshold of maximum circulating supply to filter results by.",
"required": false,
"example": "50000",
"schema": {
"type": "string"
}
},
{
"name": "percent_change_24h_min",
"in": "query",
"description": "Optionally specify a threshold of minimum 24 hour percent change to filter results by.",
"required": false,
"example": "-10",
"schema": {
"type": "string"
}
},
{
"name": "percent_change_24h_max",
"in": "query",
"description": "Optionally specify a threshold of maximum 24 hour percent change to filter results by.",
"required": false,
"example": "15",
"schema": {
"type": "string"
}
},
{
"name": "convert",
"in": "query",
"description": "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. Each conversion is returned in its own \"quote\" object.",
"required": false,
"example": "USD,BTC",
"schema": {
"type": "string"
}
},
{
"name": "convert_id",
"in": "query",
"description": "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.",
"required": false,
"example": "1,1027",
"schema": {
"type": "string"
}
},
{
"name": "sort",
"in": "query",
"description": "What field to sort the list of cryptocurrencies by.",
"required": false,
"example": "market_cap",
"schema": {
"type": "string",
"default": "market_cap"
}
},
{
"name": "sort_dir",
"in": "query",
"description": "The direction in which to order cryptocurrencies against the specified sort.",
"required": false,
"example": "desc",
"schema": {
"type": "string",
"default": "desc"
}
},
{
"name": "cryptocurrency_type",
"in": "query",
"description": "The type of cryptocurrency to include.",
"required": false,
"example": "all",
"schema": {
"type": "string",
"default": "all"
}
},
{
"name": "tag",
"in": "query",
"description": "The tag of cryptocurrency to include.",
"required": false,
"example": "all",
"schema": {
"type": "string",
"default": "all"
}
},
{
"name": "aux",
"in": "query",
"description": "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.",
"required": false,
"example": "num_market_pairs,cmc_rank,date_added",
"schema": {
"type": "string",
"default": "num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CryptoListingDTO"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"example": {
"data": [
{
"tags": [
"mineable"
],
"id": 1,
"name": "Bitcoin",
"symbol": "BTC",
"slug": "bitcoin",
"infinite_supply": false,
"circulating_supply": 20044984,
"total_supply": 20044984,
"max_supply": 21000000,
"date_added": "2010-07-13T00:00:00.000Z",
"num_market_pairs": 12660,
"cmc_rank": 1,
"last_updated": "2026-06-19T14:02:00.000Z",
"tvl_ratio": null,
"platform": null,
"self_reported_circulating_supply": null,
"self_reported_market_cap": null,
"minted_market_cap": 1265258535378.41,
"quote": [
{
"id": 2781,
"symbol": "USD",
"price": 63120.95511667226,
"volume_24h": 29127614493.57435608,
"volume_change_24h": -8.4273,
"cex_volume_24h": 29080164577.90644455,
"dex_volume_24h": 47449915.66790789,
"percent_change_1h": 0.61500999,
"percent_change_24h": -1.19783194,
"percent_change_7d": -0.28271701,
"percent_change_30d": -18.14292343,
"percent_change_60d": -16.03754846,
"percent_change_90d": -10.78181948,
"market_cap": 1265258535378.41358494384,
"market_cap_dominance": 58.2494,
"fully_diluted_market_cap": 1325540057450.12,
"minted_market_cap": 1265258535378.41,
"tvl": null,
"last_updated": "2026-06-19T14:02:00.000Z"
}
]
},
{
"tags": [
"stablecoin"
],
"id": 825,
"name": "Tether USDt",
"symbol": "USDT",
"slug": "tether",
"infinite_supply": true,
"circulating_supply": 186471454928.25273965,
"total_supply": 193153431960.50647024,
"max_supply": null,
"date_added": "2015-02-25T00:00:00.000Z",
"num_market_pairs": 186448,
"cmc_rank": 3,
"last_updated": "2026-06-19T14:01:00.000Z",
"tvl_ratio": null,
"platform": {
"id": 1027,
"slug": "ethereum",
"name": "Ethereum",
"symbol": "ETH",
"token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
},
"self_reported_circulating_supply": null,
"self_reported_market_cap": null,
"minted_market_cap": 192954912191.18,
"quote": [
{
"id": 2781,
"symbol": "USD",
"price": 0.9989722172300717,
"volume_24h": 62071695050.04424286,
"volume_change_24h": -12.0707,
"cex_volume_24h": 60510731381.50478363,
"dex_volume_24h": 1560963668.53940129,
"percent_change_1h": -0.0150212,
"percent_change_24h": 0.02100214,
"percent_change_7d": 0.00457887,
"percent_change_30d": -0.00471566,
"percent_change_60d": -0.14441328,
"percent_change_90d": -0.08226185,
"market_cap": 186279802779.794019901300789891,
"market_cap_dominance": 8.5763,
"fully_diluted_market_cap": 192954912191.18,
"minted_market_cap": 192954912191.18,
"tvl": null,
"last_updated": "2026-06-19T14:01:00.000Z"
}
]
},
{
"tags": [
"stablecoin"
],
"id": 3408,
"name": "USDC",
"symbol": "USDC",
"slug": "usd-coin",
"infinite_supply": false,
"circulating_supply": 74934715491.34196091,
"total_supply": 74934715491.34196091,
"max_supply": null,
"date_added": "2018-10-08T00:00:00.000Z",
"num_market_pairs": 40513,
"cmc_rank": 5,
"last_updated": "2026-06-19T14:01:00.000Z",
"tvl_ratio": null,
"platform": {
"id": 1027,
"slug": "ethereum",
"name": "Ethereum",
"symbol": "ETH",
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
},
"self_reported_circulating_supply": 60901219650.23,
"self_reported_market_cap": 60891043102.079188390595587485,
"minted_market_cap": 74922193956.56,
"quote": [
{
"id": 2781,
"symbol": "USD",
"price": 0.9998329007496195,
"volume_24h": 9375210843.24513054,
"volume_change_24h": -22.0589,
"cex_volume_24h": 7294870263.14053154,
"dex_volume_24h": 2080340580.10459399,
"percent_change_1h": 0.00101421,
"percent_change_24h": 0.01332693,
"percent_change_7d": 0.00411852,
"percent_change_30d": 0.0208214,
"percent_change_60d": -0.00167445,
"percent_change_90d": -0.00818018,
"market_cap": 74922193956.555881627593954066,
"market_cap_dominance": 3.4492,
"fully_diluted_market_cap": 74922193956.56,
"minted_market_cap": 74922193956.56,
"tvl": null,
"last_updated": "2026-06-19T14:01:00.000Z"
}
]
},
{
"tags": [
"ethereum-ecosystem"
],
"id": 5176,
"name": "Tether Gold",
"symbol": "XAUt",
"slug": "tether-gold",
"infinite_supply": false,
"circulating_supply": 612823.659532,
"total_supply": 707747.089,
"max_supply": null,
"date_added": "2020-02-07T00:00:00.000Z",
"num_market_pairs": 401,
"cmc_rank": 33,
"last_updated": "2026-06-19T14:01:00.000Z",
"tvl_ratio": 0.85231497,
"platform": {
"id": 1027,
"slug": "ethereum",
"name": "Ethereum",
"symbol": "ETH",
"token_address": "0x68749665FF8D2d112Fa859AA293F07A622782F38"
},
"self_reported_circulating_supply": 48450,
"self_reported_market_cap": 200583379.141852878,
"minted_market_cap": 2930078486.88,
"quote": [
{
"id": 2781,
"symbol": "USD",
"price": 4140.00782542524,
"volume_24h": 192201727.25124744,
"volume_change_24h": -34.2878,
"cex_volume_24h": 181966210.11893946,
"dex_volume_24h": 10235517.13230798,
"percent_change_1h": -0.57455114,
"percent_change_24h": -2.25096351,
"percent_change_7d": -0.78415585,
"percent_change_30d": -7.59755401,
"percent_change_60d": -13.72518949,
"percent_change_90d": -7.84994801,
"market_cap": 2537094746.06821297087938768,
"market_cap_dominance": 0.1168,
"fully_diluted_market_cap": 2930078486.88,
"minted_market_cap": 2930078486.88,
"tvl": 2976710281,
"last_updated": "2026-06-19T14:01:00.000Z"
}
]
}
],
"status": {
"timestamp": "2026-06-19T14:03:33.664Z",
"error_code": 0,
"error_message": "",
"elapsed": 8,
"credit_count": 1
}
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v3/cryptocurrency/quotes/latest": {
"get": {
"tags": [
"Cryptocurrency"
],
"summary": "Quotes Latest",
"description": "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.\n\n**Please note**: This documentation relates to our updated V3 endpoint, which may be incompatible with our V2 versions. Documentation for deprecated endpoints can be found [the deprecated section](/pro-api-reference/deprecated).\n\n\n**This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n- Basic\n- Startup\n- Builder\n- Growth\n- Professional\n- Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v3/cryptocurrency/quotes/latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 60 seconds. \n**Plan credit use:** 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per \\`convert\\` option beyond the first. \n**CMC equivalent pages:** Latest market data pages for specific cryptocurrencies like [coinmarketcap.com/currencies/bitcoin/](https://coinmarketcap.com/currencies/bitcoin/). \n \n***NOTE:** Use this endpoint to request the latest quote for specific cryptocurrencies. If you need to request all cryptocurrencies use `/v3/cryptocurrency/listings/latest` which is optimized for that purpose. The response data between these endpoints is otherwise the same.*",
"operationId": "getV3CryptocurrencyQuotesLatest",
"x-keyless": true,
"parameters": [
{
"name": "id",
"in": "query",
"description": "One or more comma-separated cryptocurrency CoinMarketCap IDs.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "slug",
"in": "query",
"description": "Alternatively pass a comma-separated list of cryptocurrency slugs.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "symbol",
"in": "query",
"description": "Alternatively pass one or more comma-separated cryptocurrency symbols.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "convert",
"in": "query",
"description": "Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "convert_id",
"in": "query",
"description": "Optionally calculate market quotes by CoinMarketCap ID instead of symbol.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "aux",
"in": "query",
"description": "Optionally specify a comma-separated list of supplemental data fields to return.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "skip_invalid",
"in": "query",
"description": "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.",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V3_Cryptocurrency_Quotes_Latest_-_Response_Model"
}
}
}
}
}
}
},
"/v2/cryptocurrency/info": {
"get": {
"summary": "Metadata",
"operationId": "getV2CryptocurrencyInfo",
"x-keyless": true,
"description": "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.\n\n**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](/pro-api-reference/deprecated).\n\n\n**This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n- Basic\n- Startup\n- Builder\n- Growth\n- Professional\n- Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v2/cryptocurrency/info`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Static data is updated only as needed, every 30 seconds. \n**Plan credit use:** 1 call credit per 250 cryptocurrencies returned (rounded up). \n**CMC equivalent pages:** Cryptocurrency detail page metadata like [coinmarketcap.com/currencies/bitcoin/](https://coinmarketcap.com/currencies/bitcoin/). ",
"parameters": [
{
"description": "One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: \"1,2\"",
"name": "id",
"in": "query",
"schema": {
"type": "string",
"pattern": "^\\d+(?:,\\d+)*$"
}
},
{
"description": "Alternatively pass a comma-separated list of cryptocurrency slugs. Example: \"bitcoin,ethereum\"",
"x-convert": {
"lowercase": true
},
"name": "slug",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9a-z-]+(?:,[0-9a-z-]+)*$"
}
},
{
"description": "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.",
"name": "symbol",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-,]+(?:,[0-9A-Za-z$@\\-]+)*$"
}
},
{
"description": "Alternatively pass in a contract address. Example: \"0xc40af1e4fecfa05ce6bab79dcd8b373d2e436c4e\"",
"name": "address",
"in": "query",
"schema": {
"type": "string"
}
},
{
"description": "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.",
"name": "skip_invalid",
"in": "query",
"schema": {
"type": "boolean",
"default": false
}
},
{
"description": "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.",
"name": "aux",
"in": "query",
"schema": {
"type": "string",
"pattern": "^(urls|logo|description|tags|platform|date_added|notice|status)+(?:,(urls|logo|description|tags|platform|date_added|notice|status)+)*$",
"default": "urls,logo,description,tags,platform,date_added,notice"
}
}
],
"tags": [
"Cryptocurrency"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Cryptocurrencies_Info_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v2/simple/price": {
"get": {
"summary": "Simple Price",
"operationId": "getV2SimplePrice",
"x-keyless": true,
"description": "Returns a lightweight latest price for one or more cryptocurrencies, with optional inline market cap, 24h volume, 24h change, and freshness timestamp. It is a slimmed-down alternative to [/v3/cryptocurrency/quotes/latest](/pro-api-reference/cryptocurrency#quotes-latest), optimized for the single most common question - \"what is X worth right now\" - without returning the full `quote` object.\n\nYou can look assets up by `id`, `slug`, or `symbol`, and at least one of those is required. The endpoint deliberately does not return supply, rank, market pairs, or descriptive metadata; for any of those, use [/v3/cryptocurrency/quotes/latest](/pro-api-reference/cryptocurrency#quotes-latest) or [/v2/cryptocurrency/info](/pro-api-reference/cryptocurrency#metadata) instead.\n\n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Builder\n - Startup\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v2/simple/price`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 60 seconds. \n**Plan credit use:** 1 call credit per 250 cryptocurrencies returned (rounded up), plus 1 credit per `convert` / `convert_id` option beyond the first. The `include_*` flags do not add credits.",
"parameters": [
{
"name": "id",
"in": "query",
"description": "One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: `1,1027`. The preferred identifier - stable and unambiguous. At least one of `id`, `slug`, or `symbol` is required.",
"schema": {
"type": "string",
"pattern": "^\\d+(?:,\\d+)*$",
"example": "1,1027"
}
},
{
"name": "slug",
"in": "query",
"description": "Alternatively pass comma-separated cryptocurrency slugs. Example: `bitcoin,ethereum`.",
"schema": {
"type": "string",
"pattern": "^[0-9a-z-]+(?:,[0-9a-z-]+)*$",
"example": "bitcoin,ethereum"
}
},
{
"name": "symbol",
"in": "query",
"description": "Alternatively pass comma-separated cryptocurrency symbols. Example: `BTC,ETH`. When a symbol matches multiple assets the highest-market-cap match is returned; use `id` to disambiguate.",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-]+(?:,[0-9A-Za-z$@\\-]+)*$",
"example": "BTC,ETH"
}
},
{
"name": "convert",
"in": "query",
"description": "Optionally calculate price in up to 120 fiat or cryptocurrency conversions at once by passing a comma-separated list of symbols. Each conversion beyond the first costs 1 additional call credit and is returned as its own entry in `quotes[]`. Cannot be used with `convert_id`.",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-]+(?:,[0-9A-Za-z$@\\-]+)*$",
"default": "USD",
"example": "USD"
}
},
{
"name": "convert_id",
"in": "query",
"description": "Same as `convert`, but by CoinMarketCap currency ID instead of symbol. Example: `convert_id=2781`. Cannot be used with `convert`.",
"schema": {
"type": "string",
"pattern": "^\\d+(?:,\\d+)*$",
"example": "2781"
}
},
{
"name": "include_market_cap",
"in": "query",
"description": "Include `market_cap` in each quote object.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "include_24h_volume",
"in": "query",
"description": "Include `volume_24h` in each quote object.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "include_24h_change",
"in": "query",
"description": "Include `percent_change_24h` in each quote object.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "include_last_updated",
"in": "query",
"description": "Include `last_updated` (ISO 8601) in each quote object.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "include_all",
"in": "query",
"description": "Shortcut to enable `include_market_cap`, `include_24h_volume`, `include_24h_change`, and `include_last_updated` together. When `true` it wins over an individual flag set to `false`. Does not add credits.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "precision",
"in": "query",
"description": "Round all price, market-cap, and volume values to this many decimal places. Omit for full precision.",
"schema": {
"type": "integer",
"minimum": 0,
"maximum": 18
}
},
{
"name": "skip_invalid",
"in": "query",
"description": "When multiple assets are requested, skip invalid lookups and return the valid ones rather than failing the whole request.",
"schema": {
"type": "boolean",
"default": true
}
}
],
"tags": [
"Cryptocurrency"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V2_Simple_Price_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v1/cryptocurrency/categories": {
"get": {
"summary": "Categories",
"operationId": "getV1CryptocurrencyCategories",
"x-keyless": true,
"description": "Returns information about all coin categories available on CoinMarketCap. Includes a paginated list of cryptocurrency quotes and metadata from each category.\n\n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Free\n - Builder\n - Startup\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/cryptocurrency/categories`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Data is updated only as needed, every 30 seconds. \n**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. \n**CMC equivalent pages:** Our free airdrops page [coinmarketcap.com/cryptocurrency-category/](https://coinmarketcap.com/cryptocurrency-category/).",
"parameters": [
{
"description": "Optionally offset the start (1-based index) of the paginated list of items to return.",
"name": "start",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"default": 1
}
},
{
"description": "Optionally specify the number of results to return. Use this parameter and the \"start\" parameter to determine your own pagination size.",
"name": "limit",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
{
"description": "Filtered categories by one or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2",
"name": "id",
"in": "query",
"schema": {
"type": "string",
"pattern": "^\\d+(?:,\\d+)*$"
}
},
{
"description": "Alternatively filter categories by a comma-separated list of cryptocurrency slugs. Example: \"bitcoin,ethereum\"",
"x-convert": {
"lowercase": true
},
"name": "slug",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9a-z-]+(?:,[0-9a-z-]+)*$"
}
},
{
"description": "Alternatively filter categories one or more comma-separated cryptocurrency symbols. Example: \"BTC,ETH\".",
"name": "symbol",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-,]+(?:,[0-9A-Za-z$@\\-]+)*$"
}
}
],
"tags": [
"Cryptocurrency"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Categories_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v1/cryptocurrency/category": {
"get": {
"summary": "Category",
"operationId": "getV1CryptocurrencyCategory",
"x-keyless": true,
"description": "Returns information about a single coin category available on CoinMarketCap. Includes a paginated list of the cryptocurrency quotes and metadata for the category.\n\n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Free\n - Builder\n - Startup\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/cryptocurrency/category`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Data is updated only as needed, every 30 seconds. \n**Plan credit use:** 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. \n**CMC equivalent pages:** Our Cryptocurrency Category page [coinmarketcap.com/cryptocurrency-category/](https://coinmarketcap.com/cryptocurrency-category/).",
"parameters": [
{
"description": "The Category ID. This can be found using the Categories API.",
"name": "id",
"in": "query",
"required": true,
"schema": {
"type": "string"
}
},
{
"description": "Optionally offset the start (1-based index) of the paginated list of coins to return.",
"name": "start",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"default": 1
}
},
{
"description": "Optionally specify the number of coins to return. Use this parameter and the \"start\" parameter to determine your own pagination size.",
"name": "limit",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"default": 100
}
},
{
"description": "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](/guides/standards-and-conventions). Each conversion is returned in its own \"quote\" object.",
"name": "convert",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-,]+(?:,[0-9A-Za-z$@\\-]+)*$"
}
},
{
"description": "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.",
"name": "convert_id",
"in": "query",
"schema": {
"type": "string",
"pattern": "^\\d+(?:,\\d+)*$"
}
}
],
"tags": [
"Cryptocurrency"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Category_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v1/exchange/map": {
"get": {
"summary": "Exchange ID Map",
"operationId": "getV1ExchangeMap",
"x-keyless": true,
"description": "Returns a paginated list of all active cryptocurrency exchanges by 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.\n\nBy default this endpoint returns exchanges that have at least 1 actively tracked market. You may receive a map of all inactive cryptocurrencies by passing `listing_status=inactive`. You may also receive a map of registered exchanges that are listed but do not yet meet methodology requirements to have tracked markets available via `listing_status=untracked`. Please review **(3) Listing Tiers** in our methodology documentation for additional details on listing states. \n\n**This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Builder\n - Startup\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/exchange/map`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Mapping data is updated only as needed, every 30 seconds. \n**Plan credit use:** 1 call credit per call. \n**CMC equivalent pages:** No equivalent, this data is only available via API. ",
"parameters": [
{
"description": "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.",
"name": "listing_status",
"in": "query",
"schema": {
"type": "string",
"pattern": "^(active|inactive|untracked)+(?:,(active|inactive|untracked)+)*$",
"default": "active"
}
},
{
"description": "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.",
"x-convert": {
"lowercase": true
},
"name": "slug",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9a-z-]+(?:,[0-9a-z-]+)*$"
}
},
{
"description": "Optionally offset the start (1-based index) of the paginated list of items to return.",
"name": "start",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"default": 1
}
},
{
"description": "Optionally specify the number of results to return. Use this parameter and the \"start\" parameter to determine your own pagination size.",
"name": "limit",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
{
"description": "What field to sort the list of exchanges by.",
"name": "sort",
"in": "query",
"schema": {
"type": "string",
"enum": [
"volume_24h",
"id"
],
"default": "id"
}
},
{
"description": "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.",
"name": "aux",
"in": "query",
"schema": {
"type": "string",
"pattern": "^(first_historical_data|last_historical_data|is_active|status)+(?:,(first_historical_data|last_historical_data|is_active|status)+)*$",
"default": "first_historical_data,last_historical_data,is_active"
}
},
{
"description": "Optionally include one fiat or cryptocurrency IDs to filter market pairs by. For example `?crypto_id=1` would only return exchanges that have BTC.",
"name": "crypto_id",
"in": "query",
"schema": {
"type": "string",
"pattern": "^\\d*$"
}
}
],
"tags": [
"Exchange"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Exchange_Map_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v2/tools/price-conversion": {
"get": {
"summary": "Price Conversion v2",
"operationId": "getV2ToolsPriceconversion",
"x-keyless": true,
"description": "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). \n \n **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](/pro-api-reference/deprecated).\n\n\n**Technical Notes**\n- 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. \n- You may reference a current list of all supported cryptocurrencies via the [cryptocurrency/map](/pro-api-reference/cryptocurrency#cryptocurrency-id-map) endpoint. This endpoint also returns the supported date ranges for historical conversions via the `first_historical_data` and `last_historical_data` properties. \n- Conversions are supported in 93 different fiat currencies and 4 precious metals [as outlined here](/guides/standards-and-conventions). Historical fiat conversions are supported as far back as 2013-04-28.\n- A `last_updated` timestamp 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. \n\n**This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n- Basic (Latest market price conversions)\n- Builder (Latest market price conversions + 1 month historical)\n- Startup (Latest market price conversions + 1 month historical)\n- Growth (Latest market price conversions + 3 months historical)\n- Professional (Latest market price conversions + 12 months historical)\n- Enterprise (Latest market price conversions + up to 6 years historical)\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v2/tools/price-conversion`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 60 seconds for the lastest cryptocurrency and fiat currency rates. \n**Plan credit use:** 1 call credit per call and 1 call credit per `convert` option beyond the first. \n**CMC equivalent pages:** Our cryptocurrency conversion page at [coinmarketcap.com/converter/](https://coinmarketcap.com/converter/). ",
"parameters": [
{
"description": "An amount of currency to convert. Example: 10.43",
"name": "amount",
"in": "query",
"required": true,
"schema": {
"type": "number",
"minimum": 1e-8,
"maximum": 1000000000000
}
},
{
"description": "The CoinMarketCap currency ID of the base cryptocurrency or fiat to convert from. Example: \"1\"",
"name": "id",
"in": "query",
"schema": {
"type": "string",
"pattern": "^\\d*$"
}
},
{
"description": "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.",
"name": "symbol",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-]*$"
}
},
{
"description": "Optional 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.",
"name": "time",
"in": "query",
"schema": {
"type": "string"
}
},
{
"description": "Pass up to 120 comma-separated fiat or cryptocurrency symbols to convert the source amount to.",
"name": "convert",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-,]+(?:,[0-9A-Za-z$@\\-]+)*$"
}
},
{
"description": "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.",
"name": "convert_id",
"in": "query",
"schema": {
"type": "string",
"pattern": "^\\d+(?:,\\d+)*$"
}
}
],
"tags": [
"Tools"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Tools_Price_Conversion_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v3/fear-and-greed/historical": {
"get": {
"summary": "CMC Crypto Fear and Greed Historical",
"operationId": "getV3FearandgreedHistorical",
"x-keyless": true,
"description": "Returns a paginated list of all CMC Crypto Fear and Greed values at 12am UTC time. \t\t\t\n\n\n \n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Startup\n - Builder\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v3/fear-and-greed/historical`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 15 seconds. \n**Plan credit use:** 1 API call credit per request no matter query size. \n**CMC equivalent pages:** Our CMC Crypto Fear and Greed Index card on https://coinmarketcap.com/charts/.",
"parameters": [
{
"description": "Optionally offset the start (1-based index) of the paginated list of items to return.",
"name": "start",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"default": 1
}
},
{
"description": "Optionally specify the number of results to return. Use this parameter and the \"start\" parameter to determine your own pagination size.",
"name": "limit",
"in": "query",
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 50
}
}
],
"tags": [
"Global Metrics"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Fear_and_Greed_Historical_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v3/fear-and-greed/latest": {
"get": {
"summary": "CMC Crypto Fear and Greed Latest",
"operationId": "getV3FearandgreedLatest",
"x-keyless": true,
"description": "Returns the lastest CMC Crypto Fear and Greed value. \t\t\n\n\n \n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Startup\n - Builder\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v3/fear-and-greed/latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 15 minutes. \n**Plan credit use:** 1 call credit per request. \n**CMC equivalent pages:** Our CMC Crypto Fear and Greed Index card on https://coinmarketcap.com/charts/.",
"tags": [
"Global Metrics"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Fear_and_Greed_Latest_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v1/global-metrics/quotes/latest": {
"get": {
"summary": "Quotes Latest",
"operationId": "getV1GlobalmetricsQuotesLatest",
"x-keyless": true,
"description": "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.\n\n**This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n- Basic\n- Builder\n- Startup\n- Growth\n- Professional\n- Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/global-metrics/quotes/latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 5 minute. \n**Plan credit use:** 1 call credit per call and 1 call credit per `convert` option beyond the first. \n**CMC equivalent pages:** The latest aggregate global market stats ticker across all CMC pages like [coinmarketcap.com](https://coinmarketcap.com/). ",
"parameters": [
{
"description": "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](/guides/standards-and-conventions). Each conversion is returned in its own \"quote\" object.",
"name": "convert",
"in": "query",
"schema": {
"type": "string",
"pattern": "^[0-9A-Za-z$@\\-,]+(?:,[0-9A-Za-z$@\\-]+)*$"
}
},
{
"description": "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.",
"name": "convert_id",
"in": "query",
"schema": {
"type": "string",
"pattern": "^\\d+(?:,\\d+)*$"
}
}
],
"tags": [
"Global Metrics"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Global_Metrics_Quotes_Latest_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v3/index/cmc100-historical": {
"get": {
"parameters": [
{
"description": "Timestamp (Unix or ISO 8601) to start returning CoinMarketCap 100 Index data for. Optional, if not passed, we'll return quotes calculated in reverse from \"time_end\".",
"in": "query",
"name": "time_start",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "Timestamp (Unix or ISO 8601) to stop returning CoinMarketCap 100 Index data 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.",
"in": "query",
"name": "time_end",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "The number of interval periods to return results for. Optional, required if both \"time_start\" and \"time_end\" aren't supplied. The default is 5 items. If \"time_start\" and \"time_end\" are supplied, the query limit is 10 and the count starts from \"time_start\".",
"in": "query",
"name": "count",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "Optionally adjust the interval of data returned.Valid values:\"5m\",\"15m\",\"daily\".",
"in": "query",
"name": "interval",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Succeeded response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiResponseOfIndexHistoricalResponseDTO"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
},
"tags": [
"CMC Index"
],
"description": "Returns an interval of historic CoinMarketCap 100 Index values based on the interval parameter. \t\t\n\n\n \n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Startup\n - Builder\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v3/index/cmc100-historical`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 5 minutes. \n**Plan credit use:** 1 API call credit per request no matter query size. \n**CMC equivalent pages:** Our CoinMarketCap 100 Index on https://coinmarketcap.com/charts/cmc100/.",
"operationId": "getV3IndexCMC100Historical",
"x-keyless": true,
"summary": "CoinMarketCap 100 Index Historical"
}
},
"/v3/index/cmc100-latest": {
"get": {
"responses": {
"200": {
"description": "Succeeded response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiResponseOfIndexLatestResponseDTO"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
},
"tags": [
"CMC Index"
],
"description": "Returns the lastest CoinMarketCap 100 Index value, constituents, and constituent weights. \t\t\n\n\n \n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Startup\n - Builder\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v3/index/cmc100-latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 5 minutes. \n**Plan credit use:** 1 call credit per API call. \n**CMC equivalent pages:** Our CoinMarketCap 100 Index on https://coinmarketcap.com/charts/cmc100/.",
"operationId": "getV3IndexCMC100Latest",
"x-keyless": true,
"summary": "CoinMarketCap 100 Index Latest"
}
},
"/v3/index/cmc20-historical": {
"get": {
"parameters": [
{
"description": "Timestamp (Unix or ISO 8601) to start returning CoinMarketCap 20 Index data for. Optional, if not passed, we'll return quotes calculated in reverse from \"time_end\".",
"in": "query",
"name": "time_start",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "Timestamp (Unix or ISO 8601) to stop returning CoinMarketCap 20 Index data 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.",
"in": "query",
"name": "time_end",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "The number of interval periods to return results for. Optional, required if both \"time_start\" and \"time_end\" aren't supplied. The default is 5 items. If \"time_start\" and \"time_end\" are supplied, the query limit is 10 and the count starts from \"time_start\".",
"in": "query",
"name": "count",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "Optionally adjust the interval of data returned.Valid values:\"5m\",\"15m\",\"daily\".",
"in": "query",
"name": "interval",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Succeeded response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiResponseOfCMC20IndexHistoricalResponseDTO"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
},
"tags": [
"CMC Index"
],
"description": "Returns an interval of historic CoinMarketCap 20 Index values based on the interval parameter. \t\t\n\n\n \n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Startup\n - Builder\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v3/index/cmc20-historical`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 5 minutes. \n**Plan credit use:** 1 API call credit per request no matter query size. \n**CMC equivalent pages:** Our CoinMarketCap 20 Index on https://coinmarketcap.com/charts/cmc20/.",
"operationId": "getV3IndexCMC20Historical",
"x-keyless": true,
"summary": "CoinMarketCap 20 Index Historical"
}
},
"/v3/index/cmc20-latest": {
"get": {
"responses": {
"200": {
"description": "Succeeded response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiResponseOfCMC20IndexLatestResponseDTO"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
},
"tags": [
"CMC Index"
],
"description": "Returns the lastest CoinMarketCap 20 Index value, constituents, and constituent weights. \t\t\n\n\n \n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Startup\n - Builder\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v3/index/cmc20-latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 5 minutes. \n**Plan credit use:** 1 call credit per API call. \n**CMC equivalent pages:** Our CoinMarketCap 20 Index on https://coinmarketcap.com/charts/cmc20/.",
"operationId": "getV3IndexCMC20Latest",
"x-keyless": true,
"summary": "CoinMarketCap 20 Index Latest"
}
},
"/v4/dex/spot-pairs/latest": {
"get": {
"tags": [
"Token"
],
"summary": "Pairs Listings Latest",
"description": "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.\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v4/dex/spot-pairs/latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getSpotPairsLatest",
"x-keyless": true,
"parameters": [
{
"name": "network_id",
"in": "query",
"description": "One or more comma-separated CoinMarketCap cryptocurrency network ids.",
"required": false,
"example": "1,2",
"schema": {
"type": "string"
}
},
{
"name": "network_slug",
"in": "query",
"description": "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.",
"required": false,
"example": "ethereum,base",
"schema": {
"type": "string"
}
},
{
"name": "dex_id",
"in": "query",
"description": "One or more comma-separated CoinMarketCap dex exchange ids",
"required": false,
"example": "1,2",
"schema": {
"type": "string"
}
},
{
"name": "dex_slug",
"in": "query",
"description": "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.",
"required": false,
"example": "uniswap,pancakeswap",
"schema": {
"type": "string"
}
},
{
"name": "base_asset_id",
"in": "query",
"description": "One or more comma-separated CoinMarketCap cryptocurrency ids.",
"required": false,
"example": "1,2",
"schema": {
"type": "string"
}
},
{
"name": "base_asset_symbol",
"in": "query",
"description": "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.",
"required": false,
"example": "ethereum, usdt.",
"schema": {
"type": "string"
}
},
{
"name": "base_asset_contract_address",
"in": "query",
"description": "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.",
"required": false,
"example": "ethereum, usdt.",
"schema": {
"type": "string"
}
},
{
"name": "base_asset_ucid",
"in": "query",
"description": "One or more comma-separated CoinMarketCap cryptocurrency IDs.",
"required": false,
"example": "1,1027",
"schema": {
"type": "string"
}
},
{
"name": "quote_asset_id",
"in": "query",
"description": "One or more comma-separated CoinMarketCap cryptocurrency ids.",
"required": false,
"example": "1,2",
"schema": {
"type": "string"
}
},
{
"name": "quote_asset_symbol",
"in": "query",
"description": "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.",
"required": false,
"example": "ethereum, usdt.",
"schema": {
"type": "string"
}
},
{
"name": "quote_asset_contract_address",
"in": "query",
"description": "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.",
"required": false,
"example": "ethereum, usdt.",
"schema": {
"type": "string"
}
},
{
"name": "quote_asset_ucid",
"in": "query",
"description": "One or more comma-separated CoinMarketCap cryptocurrency IDs.",
"required": false,
"example": "1,1027",
"schema": {
"type": "string"
}
},
{
"name": "scroll_id",
"in": "query",
"description": "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.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Optionally specify the number of results to return. Use this parameter and the start parameter to determine your own pagination size.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "liquidity_min",
"in": "query",
"description": "Optionally specify a threshold of minimum liquidity to filter results by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "liquidity_max",
"in": "query",
"description": "Optionally specify a threshold of maximum liquidity to filter results by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "volume_24h_min",
"in": "query",
"description": "Optionally specify a threshold of minimum 24 hour USD volume to filter results by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "volume_24h_max",
"in": "query",
"description": "Optionally specify a threshold of maximum 24 hour USD volume to filter results by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "no_of_transactions_24h_min",
"in": "query",
"description": "Optionally specify a threshold of minimum 24h no. of transactions to filter results by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "no_of_transactions_24h_max",
"in": "query",
"description": "Optionally specify a threshold of maximum 24h no. of transactions to filter results by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "percent_change_24h_min",
"in": "query",
"description": "Optionally specify a threshold of minimum 24 hour percent change to filter results by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "percent_change_24h_max",
"in": "query",
"description": "Optionally specify a threshold of maximum 24 hour percent change to filter results by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "sort",
"in": "query",
"description": "Default:`\"volume_24h\"`\nValid values: `\"volume_24h\"` `\"liquidity\"` `\"no_of_transactions_24h\"` `\"percent_change_24h\"` // todo\nSort the list of dex spot pairs by.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "sort_dir",
"in": "query",
"description": "Default:`\"desc\"`\nValid values: `\"desc\"` `\"asc\"`\nThe direction in which to order dex spot pairs against the specified sort.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "aux",
"in": "query",
"description": "Default:`\"\"`\nValid 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\"`\nOptionally specify a comma-separated list of supplemental data fields to return.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "reverse_order",
"in": "query",
"description": "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.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "convert_id",
"in": "query",
"description": "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.",
"required": false,
"example": "1,2781",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V4_DEX_Spot_Pairs_Latest_-_Response_Model"
}
}
}
}
}
}
},
"/v4/dex/pairs/quotes/latest": {
"get": {
"tags": [
"Token"
],
"summary": "Quotes Latest",
"description": "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.\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v4/dex/pairs/quotes/latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getLatestPairsQuotes",
"x-keyless": true,
"parameters": [
{
"name": "contract_address",
"in": "query",
"description": "One or more comma-separated contract addresses.",
"required": false,
"example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640,0xc2e9f25be6257c210d7adf0d4cd6e3e881ba25f8",
"schema": {
"type": "string"
}
},
{
"name": "network_id",
"in": "query",
"description": "One or more CoinMarketCap cryptocurrency network ids",
"required": false,
"example": "1",
"schema": {
"type": "string"
}
},
{
"name": "network_slug",
"in": "query",
"description": "Alternatively, one network names in URL friendly shorthand \"slug\" format (all lowercase, spaces replaced with hyphens).",
"required": false,
"example": "ethereum",
"schema": {
"type": "string"
}
},
{
"name": "aux",
"in": "query",
"description": "Default:`\"\"`\nValid 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\"`\nOptionally specify a comma-separated list of supplemental data fields to return.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "convert_id",
"in": "query",
"description": "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.",
"required": false,
"example": "1,2781",
"schema": {
"type": "string"
}
},
{
"name": "skip_invalid",
"in": "query",
"description": "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.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "reverse_order",
"in": "query",
"description": "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.",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V4_DEX_Pairs_Quotes_Latest_-_Response_Model"
}
}
}
}
}
}
},
"/v1/k-line/points": {
"get": {
"tags": [
"OHLCV"
],
"summary": "Get K-line points",
"description": "Get K-line price points for a token.\n\nResponse Format: Each point is an array with 3 elements:\n- **[0]** price: Token price\n- **[1]** volume: Trading volume\n- **[2]** timestamp: UNIX timestamp (seconds)\n\nExample: ``[[1.23, 50000, 1705363200], ...]``\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/k-line/points`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getKlinePoints",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"description": "Platform name or id",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token or pool address",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "interval",
"in": "query",
"description": "Kline interval: 1s/5s/30s/1min/3min/5min/15min/30min/1h/2h/4h/6h/8h/12h/1d/3d/1w/1m",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "Start timestamp (UNIX epoch)",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "to",
"in": "query",
"description": "End timestamp (UNIX epoch)",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "unit",
"in": "query",
"description": "Kline unit: usd, native, quote",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Number of points to load",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pm",
"in": "query",
"description": "Kline type: p (price), m (marketcap)",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_K_Line_Points_-_Response_Model"
}
}
}
}
}
}
},
"/v1/k-line/candles": {
"get": {
"tags": [
"OHLCV"
],
"summary": "Get K-line candles",
"description": "Get K-line candle (OHLCV) data for a token.\n\nResponse Format: Each candle is an array with 7 elements:\n- **[0]** open: Opening price\n- **[1]** high: Highest price\n- **[2]** low: Lowest price\n- **[3]** close: Closing price\n- **[4]** volume: Trading volume\n- **[5]** timestamp: UNIX timestamp (seconds)\n- **[6]** traders: Number of unique traders\n\nExample: ``[[1.23, 1.45, 1.20, 1.40, 50000, 1705363200, 128], ...]``\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/k-line/candles`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getKlineCandles",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"description": "Platform name or id",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token or pool address",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "interval",
"in": "query",
"description": "Kline interval: 1s/5s/30s/1min/3min/5min/15min/30min/1h/2h/4h/6h/8h/12h/1d/3d/1w/1m",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "Start timestamp (UNIX epoch)",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "to",
"in": "query",
"description": "End timestamp (UNIX epoch)",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "unit",
"in": "query",
"description": "Kline unit: usd, native, quote",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Number of candles to load",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pm",
"in": "query",
"description": "Kline type: p (price), m (marketcap)",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_K_Line_Candles_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/token": {
"get": {
"tags": [
"Token"
],
"summary": "Get token detail",
"description": "Get detailed information for a specific token\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/token`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getToken",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"description": "Platform name",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token address",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Token_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/token/price": {
"get": {
"tags": [
"Token"
],
"summary": "Get token price",
"description": "Get current price for a specific token\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/token/price`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getTokenPrice",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"description": "Platform name",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token address",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Token_Price_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/token/pools": {
"get": {
"tags": [
"Token"
],
"summary": "Get token pools",
"description": "Get all pools for a specific token\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/token/pools`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getTokenPools",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"description": "Platform name",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token address",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "size",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"format": "int32",
"default": 20
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Token_Pools_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/token-liquidity/query": {
"get": {
"tags": [
"Token"
],
"summary": "Query token liquidity",
"description": "Get liquidity information for a specific token\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/token-liquidity/query`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "queryTokenLiquidity",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"description": "Platform name",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token address",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "interval",
"in": "query",
"description": "Time interval",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Result limit",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "to",
"in": "query",
"description": "End timestamp",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "needLatest",
"in": "query",
"description": "Whether to include latest value",
"required": false,
"schema": {
"type": "boolean"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Token_Liquidity_Query_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/tokens/transactions": {
"get": {
"tags": [
"Token"
],
"summary": "Get swap list",
"description": "Get swap/trade history for a token\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/tokens/transactions`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getSwapList",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"description": "Blockchain platform name (bsc/sol/etc)",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token contract address",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "type",
"in": "query",
"description": "Transaction type (0 for buy, 1 for sell)",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "types",
"in": "query",
"description": "Transaction types filter, supports: buy, sell, open, close, add, reduce",
"required": false,
"explode": true,
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "maker",
"in": "query",
"description": "Maker address, support comma separated list",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "sortBy",
"in": "query",
"description": "Field to sort by (currently only supports 'time')",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "sortType",
"in": "query",
"description": "Sort direction ('asc' or 'desc', default is 'desc')",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "startTime",
"in": "query",
"description": "Start timestamp (inclusive)",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "endTime",
"in": "query",
"description": "End timestamp (inclusive)",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "minVolume",
"in": "query",
"description": "Minimum volume (inclusive)",
"required": false,
"schema": {
"type": "number"
}
},
{
"name": "maxVolume",
"in": "query",
"description": "Maximum volume (inclusive)",
"required": false,
"schema": {
"type": "number"
}
},
{
"name": "lastId",
"in": "query",
"description": "Cursor for pagination, format: ts_txHash_logId",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Result limit",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "version",
"in": "query",
"description": "Version",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Tokens_Transactions_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/security/detail": {
"get": {
"tags": [
"Token"
],
"summary": "Get security detail",
"description": "Get security audit information for a token\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/security/detail`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getSecurityDetail",
"x-keyless": true,
"parameters": [
{
"name": "platformName",
"in": "query",
"description": "Platform name",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token address",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Security_Detail_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/search": {
"get": {
"tags": [
"Token"
],
"summary": "Search tokens",
"description": "Search for tokens by keyword\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/search`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "search",
"x-keyless": true,
"parameters": [
{
"name": "q",
"in": "query",
"description": "Search keyword",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "platform",
"in": "query",
"description": "Platform filter",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "sort",
"in": "query",
"description": "Sort field",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Result limit",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "code",
"in": "query",
"description": "Code filter",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Search_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/platform/list": {
"get": {
"tags": [
"Platform"
],
"summary": "Get platform list",
"description": "Get list of all supported platforms\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/platform/list`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getPlatformList",
"x-keyless": true,
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Platform_List_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/platform/detail": {
"get": {
"tags": [
"Platform"
],
"summary": "Get platform detail",
"description": "Get detailed information for a specific platform\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/platform/detail`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getPlatformDetail",
"x-keyless": true,
"parameters": [
{
"name": "platformName",
"in": "query",
"description": "Platform name",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Platform_Detail_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/liquidity-change/list": {
"get": {
"tags": [
"Token"
],
"summary": "Get liquidity change list",
"description": "Get liquidity change history for a token\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/liquidity-change/list`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getLiquidityChangeList",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"description": "Blockchain platform name (bsc/sol/etc)",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "address",
"in": "query",
"description": "Token contract address",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "type",
"in": "query",
"description": "Liquidity change type",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "maker",
"in": "query",
"description": "Maker address, support comma separated list",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "sortBy",
"in": "query",
"description": "Field to sort by (currently only supports 'ts')",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "sortType",
"in": "query",
"description": "Sort direction ('asc' or 'desc', default is 'desc')",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "startTime",
"in": "query",
"description": "Start timestamp (inclusive)",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "endTime",
"in": "query",
"description": "End timestamp (inclusive)",
"required": false,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "minVolume",
"in": "query",
"description": "Minimum USD volume (inclusive)",
"required": false,
"schema": {
"type": "number"
}
},
{
"name": "maxVolume",
"in": "query",
"description": "Maximum USD volume (inclusive)",
"required": false,
"schema": {
"type": "number"
}
},
{
"name": "lastId",
"in": "query",
"description": "Cursor for pagination, format: ts_txHash_logId",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Result limit",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Liquidity_Change_List_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/holders/list": {
"post": {
"tags": [
"Holder"
],
"summary": "Get holders list",
"description": "Get detailed information for holders list\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/holders/list`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getHolders",
"x-keyless": true,
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DqueryHoldersRequestDTO"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Holders_List_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/holders/detail": {
"post": {
"tags": [
"Holder"
],
"summary": "Get holder detail",
"description": "Get detailed information for holders detail\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/holders/detail`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getHolderDetail",
"x-keyless": true,
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DqueryHoldersDetailRequestDTO"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Holders_Detail_-_Response_Model"
}
}
}
}
}
}
},
"/v1/dex/holders/count": {
"get": {
"tags": [
"Holder"
],
"summary": "Get holder count",
"description": "Get detailed information for holders count\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/dex/holders/count`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.",
"operationId": "getHolderCount",
"x-keyless": true,
"parameters": [
{
"name": "platform",
"in": "query",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "tokenAddress",
"in": "query",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/V1_DEX_Holders_Count_-_Response_Model"
}
}
}
}
}
}
},
"/v1/altcoin-season-index/latest": {
"get": {
"summary": "Altcoin Season Index Latest",
"operationId": "getV1AltcoinSeasonIndexLatest",
"x-keyless": true,
"description": "Returns the latest Altcoin Season Index snapshot with yearly high/low statistics. Index scale 0-100; values above 75 suggest altcoin season, below 25 suggest Bitcoin season.\n\n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Builder\n - Startup\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/altcoin-season-index/latest`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 15 minutes.\n**Plan credit use:** 1 API call credit per request.",
"tags": [
"Global Metrics"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Altcoin_Season_Index_Latest_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
},
"/v1/altcoin-season-index/historical": {
"get": {
"summary": "Altcoin Season Index Historical",
"operationId": "getV1AltcoinSeasonIndexHistorical",
"x-keyless": true,
"description": "Returns historical Altcoin Season Index data for a specified timeframe (7d, 30d, or 90d). Data points are sorted by timestamp (oldest first).\n\n **This endpoint is available on the following [API plans](https://coinmarketcap.com/api/pricing/):**\n - Basic\n - Builder\n - Startup\n - Growth\n - Professional\n - Enterprise\n\nCall this endpoint keyless - no API key, no signup. Prefix the path with `/public-api`: `https://pro-api.coinmarketcap.com/public-api/v1/altcoin-season-index/historical`. See the [Keyless Public API](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api) for the full list, rate limits, and examples.\n\n**Cache / Update frequency:** Every 15 minutes.\n**Plan credit use:** 1 API call credit per request.",
"parameters": [
{
"name": "timeframe",
"in": "query",
"description": "Timeframe for historical data. Valid values are 7d, 30d, and 90d. Default is 7d.",
"required": false,
"schema": {
"type": "string",
"default": "7d",
"enum": [
"7d",
"30d",
"90d"
]
}
}
],
"tags": [
"Global Metrics"
],
"responses": {
"200": {
"description": "Successful",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Altcoin_Season_Index_Historical_-_Response_Model"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_400_Error_Object"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_401_Error_Object"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_403_Error_Object"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_429_Error_Object"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTP_Status_500_Error_Object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https://pro-api.coinmarketcap.com/public-api",
"description": "Keyless Public API (no API key)"
}
],
"components": {
"schemas": {
"V1_DEX_Platform_List_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PlatformDTO"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Security_Detail_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TokenSecurityResponseDTO"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Token_Liquidity_Query_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TokenLiquiditySnapshotDTO"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Token_Pools_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TokenTopPoolDTO"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_K_Line_Candles_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": [
"number",
"null"
]
}
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_K_Line_Points_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V3_Cryptocurrency_Quotes_Latest_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CryptoQuoteV3DTO"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V4_DEX_Pairs_Quotes_Latest_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DexParisQuotesDTO"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V4_DEX_Spot_Pairs_Latest_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DexSpotPairDTO"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Holders_Count_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/HolderCountVO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Holders_Detail_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/HolderDetailVO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Holders_List_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/HolderDexVO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Liquidity_Change_List_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/LiquidityChangeListResponseDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Platform_Detail_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/PlatformDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Search_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/SearchResponseDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Token_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/TokenDetailDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Token_Price_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/TokenPriceDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V1_DEX_Tokens_Transactions_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/SwapListResponseDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"V2_Simple_Price_-_Item_Object": {
"type": "object",
"description": "Latest-price entry for a single cryptocurrency.",
"properties": {
"id": {
"type": "integer",
"description": "CoinMarketCap cryptocurrency ID.",
"example": 1
},
"name": {
"type": "string",
"description": "Cryptocurrency name.",
"example": "Bitcoin"
},
"symbol": {
"type": "string",
"description": "Cryptocurrency symbol.",
"example": "BTC"
},
"slug": {
"type": "string",
"description": "Cryptocurrency slug.",
"example": "bitcoin"
},
"quotes": {
"type": "array",
"description": "One quote object per `convert` / `convert_id` currency requested.",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Convert currency symbol (e.g. `USD`).",
"example": "USD"
},
"price": {
"type": "number",
"description": "Latest price in the convert currency.",
"example": 63319.879266088545
},
"market_cap": {
"type": "number",
"description": "Market cap in the convert currency. Present only when `include_market_cap` (or `include_all`) is true."
},
"volume_24h": {
"type": "number",
"description": "24-hour trading volume in the convert currency. Present only when `include_24h_volume` (or `include_all`) is true."
},
"percent_change_24h": {
"type": "number",
"description": "24-hour price change percentage. Present only when `include_24h_change` (or `include_all`) is true."
},
"last_updated": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp of the price. Present only when `include_last_updated` (or `include_all`) is true."
}
},
"required": [
"symbol",
"price"
]
}
}
},
"required": [
"id",
"name",
"symbol",
"slug",
"quotes"
]
},
"V2_Simple_Price_-_Response_Model": {
"type": "object",
"example": {
"data": [
{
"id": 1,
"name": "Bitcoin",
"symbol": "BTC",
"slug": "bitcoin",
"quotes": [
{
"symbol": "USD",
"price": 63319.879266088545,
"market_cap": 1270345579794.01152078075,
"volume_24h": 23424304928.73598862,
"percent_change_24h": -3.03610139,
"last_updated": "2026-07-28T10:35:05.000Z"
}
]
},
{
"id": 1027,
"name": "Ethereum",
"symbol": "ETH",
"slug": "ethereum",
"quotes": [
{
"symbol": "USD",
"price": 1875.3832420347037,
"market_cap": 226326126225.454083360708918688,
"volume_24h": 12578049044.85534477,
"percent_change_24h": -4.60239011,
"last_updated": "2026-07-28T10:35:05.000Z"
}
]
}
],
"status": {
"timestamp": "2026-07-28T10:38:38.654Z",
"error_code": "0",
"error_message": "",
"elapsed": 10,
"credit_count": 1
}
},
"properties": {
"data": {
"type": "array",
"description": "Array of asset objects, one per resolved identifier. With `skip_invalid=true`, unresolved identifiers are simply absent.",
"items": {
"$ref": "#/components/schemas/V2_Simple_Price_-_Item_Object"
}
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"status": {
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Current ISO 8601 timestamp on the server.",
"example": "2018-06-02T22:51:28.209Z"
},
"error_code": {
"type": "integer",
"description": "An internal error code for the current error. If a unique platform error code is not available the HTTP status code is returned.",
"example": 400,
"default": 400
},
"error_message": {
"type": "string",
"description": "An error message to go along with the error code.",
"example": "Invalid value for \\\"id\\\""
},
"elapsed": {
"type": "integer",
"description": "Number of milliseconds taken to generate this response",
"example": 10
},
"credit_count": {
"type": "integer",
"description": "Number of API call credits required for this call. Always 0 for errors.",
"example": 0
}
},
"required": [
"timestamp",
"error_code",
"error_message",
"elapsed",
"credit_count"
]
},
"tags": {
"type": "array",
"description": "Array of tags associated with this cryptocurrency. Currently only a mineable tag will be returned if the cryptocurrency is mineable. Additional tags will be returned in the future.",
"example": [
"mineable"
],
"items": {
"type": "string"
}
},
"platform": {
"type": [
"object",
"null"
],
"description": "Metadata about the parent cryptocurrency platform this cryptocurrency belongs to if it is a token, otherwise null.",
"properties": {
"id": {
"type": [
"integer",
"string"
],
"description": "The unique CoinMarketCap ID for the parent platform cryptocurrency.",
"example": 1
},
"name": {
"type": "string",
"description": "The name of the parent platform cryptocurrency.",
"example": "Ethereum"
},
"symbol": {
"type": "string",
"description": "The ticker symbol for the parent platform cryptocurrency.",
"example": "ETH"
},
"slug": {
"type": "string",
"description": "The web URL friendly shorthand version of the parent platform cryptocurrency name.",
"example": "ethereum"
},
"token_address": {
"type": "string",
"description": "The token address on the parent platform cryptocurrency.",
"example": "0xe41d2489571d322189246dafa5ebde1f4699f498"
}
},
"required": [
"id",
"name",
"symbol",
"slug",
"token_address"
]
},
"self_reported_tags": {
"type": "array",
"description": "Array of self reported tags associated with this cryptocurrency.",
"example": [
"Store Of Value",
"Play To Earn"
],
"items": {
"type": "string"
}
},
"website": {
"type": "array",
"description": "Array of website URLs.",
"example": [
"https://bitcoin.org/"
],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"technical_doc": {
"type": "array",
"description": "Array of white paper or technical documentation URLs.",
"example": [
"https://bitcoin.org/bitcoin.pdf"
],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"explorer": {
"type": "array",
"description": "Array of block explorer URLs.",
"example": [
"https://blockchain.coinmarketcap.com/chain/bitcoin",
"https://blockchain.info/",
"https://live.blockcypher.com/btc/"
],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"source_code": {
"type": "array",
"description": "Array of source code URLs.",
"example": [
"https://github.com/bitcoin/"
],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"message_board": {
"type": "array",
"description": "Array of message board URLs.",
"example": [
"https://bitcointalk.org"
],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"chat": {
"type": "array",
"description": "Array of chat service URLs.",
"example": [],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"announcement": {
"type": "array",
"description": "Array of announcement URLs.",
"example": [],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"reddit": {
"type": "array",
"description": "Array of Reddit community page URLs.",
"example": [
"https://reddit.com/r/bitcoin"
],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"twitter": {
"type": "array",
"description": "Array of official twitter profile URLs.",
"example": [
"https://twitter.com/Bitcoin"
],
"items": {
"type": "string",
"x-format": {
"uri": true
}
}
},
"DexTokenSignalDTO": {
"type": "object",
"properties": {
"mtp": {
"type": "number",
"description": "highestPrice / firstSignalPrice"
},
"psc": {
"type": "integer",
"description": "push count",
"format": "int64"
}
},
"description": "Token signal"
},
"TokenStatsDTO": {
"type": "object",
"properties": {
"tp": {
"type": "string",
"description": "Stat type, e.g., '1h', '24h', '7d'",
"example": "24h"
},
"vu": {
"type": "string",
"description": "Total volume (string formatted)",
"example": "123456.789"
},
"txs": {
"type": "string",
"description": "Total number of transactions",
"example": "1024"
},
"nb": {
"type": "string",
"description": "Number of buy transactions",
"example": "678"
},
"ns": {
"type": "string",
"description": "Number of sell transactions",
"example": "346"
},
"bvu": {
"type": "string",
"description": "Buy volume",
"example": "65432.12"
},
"svu": {
"type": "string",
"description": "Sell volume",
"example": "58024.67"
},
"but": {
"type": "string",
"description": "Number of unique buyers",
"example": "431"
},
"sut": {
"type": "string",
"description": "Number of unique sellers",
"example": "398"
},
"pc": {
"type": "number",
"description": "Price change rate (e.g. 5.23 means +5.23%)",
"format": "float",
"example": 3.51
},
"ut": {
"type": "string",
"description": "Number of unique traders",
"example": "789"
}
},
"description": "Statistics data for token in specific interval"
},
"CryptoCurrencyExchangeDTO": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Exchange ID, e.g. 270",
"format": "int32"
},
"slug": {
"type": "string",
"description": "Exchange slug, e.g. binance"
},
"n": {
"type": "string",
"description": "Full exchange name, e.g. Binance"
},
"lg": {
"type": "string",
"description": "Logo URL, e.g. https://s2.coinmarketcap.com/static/img/exchanges/64x64/270.png"
},
"wst": {
"type": "string",
"description": "Exchange website URL"
},
"cat": {
"type": "array",
"description": "Exchange categories, e.g. SPOT, DERIVATIVES",
"items": {
"type": "string",
"description": "Exchange categories, e.g. SPOT, DERIVATIVES"
}
}
},
"description": "Centralized exchange information"
},
"Token": {
"type": "object",
"properties": {
"addr": {
"type": "string",
"description": "Token address"
},
"lg": {
"type": "string",
"description": "Token logo URL"
},
"n": {
"type": "string",
"description": "Token name"
},
"sym": {
"type": "string",
"description": "Token symbol"
},
"liq": {
"type": "string",
"description": "Liquidity in native unit"
},
"liqUsd": {
"type": "string",
"description": "Liquidity in USD"
}
},
"description": "Basic token info in the pool"
},
"TokenDetailDTO": {
"type": "object",
"properties": {
"n": {
"type": "string",
"description": "Token name"
},
"sym": {
"type": "string",
"description": "Token symbol"
},
"addr": {
"type": "string",
"description": "Token address"
},
"plt": {
"type": "string",
"description": "Platform name"
},
"pdex": {
"type": "string",
"description": "Token platform dexer name (pdex)"
},
"pcid": {
"type": "integer",
"description": "Token platform crypto ID (pcid)",
"format": "int32"
},
"pid": {
"type": "integer",
"description": "Platform ID",
"format": "int32"
},
"dec": {
"type": "integer",
"description": "Token decimals",
"format": "int32"
},
"crt": {
"type": "string",
"description": "Token creator address"
},
"own": {
"type": "string",
"description": "Token owner address"
},
"rnc": {
"type": "string",
"description": "Renounced address"
},
"web": {
"type": "string",
"description": "Project website"
},
"tw": {
"type": "string",
"description": "Twitter URL"
},
"tg": {
"type": "string",
"description": "Telegram URL"
},
"lg": {
"type": "string",
"description": "Logo URL"
},
"pubAt": {
"type": "string",
"description": "Token publish timestamp"
},
"lchAt": {
"type": "string",
"description": "Token launched timestamp"
},
"fdv": {
"type": "string",
"description": "Fully Diluted Valuation"
},
"mcap": {
"type": "string",
"description": "Market capitalization"
},
"ts": {
"type": "string",
"description": "Total token supply"
},
"bs": {
"type": "string",
"description": "Burned supply"
},
"cs": {
"type": "string",
"description": "Circulating supply"
},
"liqUsd": {
"type": "string",
"description": "Liquidity (USD)"
},
"liq": {
"type": "string",
"description": "Liquidity (native)"
},
"hld": {
"type": "string",
"description": "Holder count"
},
"p": {
"type": "string",
"description": "Token price in USD"
},
"ph24h": {
"type": "string",
"description": "24h price high"
},
"pl24h": {
"type": "string",
"description": "24h price low"
},
"pt": {
"type": "string",
"description": "Price last updated timestamp"
},
"fpt": {
"type": "string",
"description": "Timestamp of the first time this token had a price"
},
"fpct": {
"type": "string",
"description": "Timestamp when the first pool for this token was created"
},
"bcr": {
"type": "number",
"description": "Bonding curve ratio",
"format": "double"
},
"sts": {
"type": "array",
"description": "Token statistics",
"items": {
"$ref": "#/components/schemas/TokenStatsDTO"
}
},
"pls": {
"type": "array",
"description": "Top liquidity pools",
"items": {
"$ref": "#/components/schemas/TokenTopPoolDTO"
}
},
"turl": {
"type": "string",
"description": "DEX trading URL"
},
"nps": {
"type": "string",
"description": "Number of top pools"
},
"tsrc": {
"type": "string",
"description": "Pool source"
},
"rl": {
"type": "string",
"description": "Token risk level"
},
"lf": {
"type": "integer",
"description": "Listed flag (1 = listed, 0 = unlisted)",
"format": "int32"
},
"cid": {
"type": "integer",
"description": "Crypto currency ID",
"format": "int32"
},
"lmc": {
"type": "string",
"description": "Listing market capitalization"
},
"lsmc": {
"type": "string",
"description": "Listing self-reported market capitalization"
},
"lsrcs": {
"type": "string",
"description": "Listing self-reported circulating supply"
},
"ltcs": {
"type": "string",
"description": "Listing circulating supply"
},
"ltda": {
"type": "string",
"description": "Listing token date added"
},
"cexs": {
"type": "array",
"description": "Centralized exchange listings",
"items": {
"$ref": "#/components/schemas/CryptoCurrencyExchangeDTO"
}
},
"sig": {
"$ref": "#/components/schemas/DexTokenSignalDTO"
},
"ecs": {
"type": "integer",
"description": "Binance exclusive code, 1 - exclusive",
"format": "int32"
},
"la": {
"type": "integer",
"description": "show listed alert, 1-show,0-hide",
"format": "int32"
}
},
"description": "Detailed token information"
},
"TokenTopPoolDTO": {
"type": "object",
"properties": {
"addr": {
"type": "string",
"description": "Pool address"
},
"v24": {
"type": "string",
"description": "24-hour trading volume"
},
"pubAt": {
"type": "string",
"description": "Publish timestamp"
},
"t0": {
"$ref": "#/components/schemas/Token"
},
"t1": {
"$ref": "#/components/schemas/Token"
},
"bidx": {
"type": "integer",
"description": "Index of the base token in the pool (0 or 1)",
"format": "int32"
},
"exid": {
"type": "integer",
"description": "Exchange ID",
"format": "int32"
},
"exn": {
"type": "string",
"description": "Exchange name"
},
"liqUsd": {
"type": "string",
"description": "Liquidity in USD"
},
"fa": {
"type": "string",
"description": "Factory address"
},
"lr": {
"type": "string",
"description": "Locked rate"
},
"br": {
"type": "string",
"description": "Burned rate"
},
"top": {
"type": "boolean",
"description": "Is top pool"
},
"mi": {
"type": "boolean",
"description": "Is meme inner pool"
}
},
"description": "Token's top pool information"
},
"TokenPriceDTO": {
"type": "object",
"properties": {
"pid": {
"type": "integer",
"description": "Platform ID",
"format": "int32"
},
"pdex": {
"type": "string",
"description": "Platform dexer name"
},
"pcid": {
"type": "integer",
"description": "Platform crypto ID",
"format": "int32"
},
"a": {
"type": "string",
"description": "Token address"
},
"n": {
"type": "string",
"description": "Token name"
},
"sym": {
"type": "string",
"description": "Token symbol"
},
"lg": {
"type": "string",
"description": "Logo URL"
},
"p": {
"type": "number",
"description": "Current price (USD)"
},
"pc1h": {
"type": "number",
"description": "Price change in last 1 hour (percentage)"
},
"pc24h": {
"type": "number",
"description": "Price change in last 24 hours (percentage)"
},
"pc7d": {
"type": "number",
"description": "Price change in last 7 days (percentage)"
},
"v24h": {
"type": "number",
"description": "24-hour trading volume (USD)"
},
"l": {
"type": "number",
"description": "Liquidity (USD)"
},
"ts": {
"type": "string",
"description": "Timestamp of price data"
},
"mc": {
"type": "number",
"description": "Market cap"
},
"fpt": {
"type": "string",
"description": "Timestamp (Unix milliseconds) of the first time this token had a price."
},
"fpct": {
"type": "string",
"description": "Timestamp (Unix milliseconds) when the first pool for this token was created."
}
},
"description": "Token price information"
},
"DexQuoteDTO": {
"type": "object",
"properties": {
"price": {
"type": "number",
"description": "Price in the specified currency for this spot pair.",
"format": "bigdecimal"
},
"liquidity": {
"type": "number",
"description": "Total liquidity available currently in the specified currency. This field will return null if not available.",
"format": "bigdecimal"
},
"convert_id": {
"type": "string",
"description": "id of specified currency."
},
"price_by_quote_asset": {
"type": "number",
"description": "Price of the base asset in quote asset for this spot pair.",
"format": "bigdecimal"
},
"last_updated": {
"type": "string",
"description": "Timestamp (ISO 8601) of when the conversion currency's current value was referenced for this conversion.",
"format": "date-time"
},
"volume_24h": {
"type": "number",
"description": "Reported 24 hour volume in the specified spot pair in the specified currency.",
"format": "bigdecimal"
},
"percent_change_price_1h": {
"type": "number",
"description": "1 hour price change percentage in the specified spot pair in the specified currency.",
"format": "bigdecimal"
},
"percent_change_price_24h": {
"type": "number",
"description": "24 hour price change percentage in the specified spot pair in the specified currency.",
"format": "bigdecimal"
},
"fully_diluted_value": {
"type": "number",
"description": "Fully Diluted Value = (Total Supply - Burned Supply) * Price. Returned in the specified currency.",
"format": "bigdecimal"
},
"24h_buy_volume": {
"type": "number",
"description": "24 hours buy volume of the asset",
"format": "bigdecimal"
},
"24h_sell_volume": {
"type": "number",
"description": "24 hours sell volume of the asset",
"format": "bigdecimal"
}
},
"description": "A map of market quotes in different currency conversions. The default map included is USD."
},
"DexSpotPairDTO": {
"type": "object",
"properties": {
"quote": {
"type": "array",
"description": "A map of market quotes in different currency conversions. The default map included is USD.",
"items": {
"$ref": "#/components/schemas/DexQuoteDTO"
}
},
"contract_address": {
"type": "string",
"description": "The unique contract address for this spot pair."
},
"name": {
"type": "string",
"description": "The name of this spot pair."
},
"base_asset_id": {
"type": [
"string",
"null"
],
"description": "The id of this base asset in the spot pair."
},
"base_asset_ucid": {
"type": [
"string",
"null"
],
"description": "The ucid of this base asset in the spot pair."
},
"base_asset_name": {
"type": "string",
"description": "The name of this base asset in the spot pair."
},
"base_asset_symbol": {
"type": "string",
"description": "The symbol of this base asset in the spot pair."
},
"base_asset_contract_address": {
"type": "string",
"description": "The contract addres of this base asset in the spot pair."
},
"quote_asset_id": {
"type": [
"string",
"null"
],
"description": "The id of this quote asset in the spot pair."
},
"quote_asset_ucid": {
"type": [
"string",
"null"
],
"description": "The ucid of this quote asset in the spot pair."
},
"quote_asset_name": {
"type": "string",
"description": "The name of this quote asset in the spot pair."
},
"quote_asset_symbol": {
"type": "string",
"description": "The symbol of this quote asset in the spot pair."
},
"quote_asset_contract_address": {
"type": "string",
"description": "The contract addresss of this quote asset in the spot pair."
},
"dex_id": {
"type": "string",
"description": "The id of this dex the spot pair is on."
},
"dex_slug": {
"type": "string",
"description": "The name of this dex the spot pair is on."
},
"network_id": {
"type": "string",
"description": "The id of the network the spot pair is on."
},
"network_slug": {
"type": "string",
"description": "The slug of the network the spot pair is on."
},
"last_updated": {
"type": "string",
"description": "Timestamp (ISO 8601) of the last time this record was updated.",
"format": "date-time"
},
"created_at": {
"type": [
"string",
"null"
],
"description": "Timestamp (ISO 8601) when we started tracking this asset.",
"format": "date-time"
},
"num_transactions_24h": {
"type": "integer",
"description": "Number of transactions in past 24 hours",
"format": "int64"
},
"holders": {
"type": "integer",
"description": "Number of holders of the asset",
"format": "int64"
},
"24h_no_of_buys": {
"type": "integer",
"description": "Number of asset buys in the past 24 hours",
"format": "int64"
},
"24h_no_of_sells": {
"type": "integer",
"description": "Number of asset sells in the past 24 hours",
"format": "int64"
},
"pool_created": {
"type": "string",
"description": "When the pool of the asset was created",
"format": "date-time"
},
"buy_tax": {
"type": "number",
"description": "Buy tax on the asset",
"format": "bigdecimal"
},
"sell_tax": {
"type": "number",
"description": "Sell tax on the asset",
"format": "bigdecimal"
},
"security_scan": {
"type": "array",
"description": "Security scan by Go+.\n\n\nAll 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.\n\nCoinMarketCap 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.\n\nOnly returned if passed in aux.",
"items": {
"$ref": "#/components/schemas/SecurityScanResult"
}
},
"pool_base_asset": {
"type": "number",
"description": "Base asset in the pool",
"format": "bigdecimal"
},
"pool_quote_asset": {
"type": "number",
"description": "Quote asset in the pool",
"format": "bigdecimal"
},
"percent_pooled_base_asset": {
"type": "number",
"description": "Percentage of the base asset in the pool",
"format": "bigdecimal"
},
"24h_volume_quote_asset": {
"type": "number",
"description": "24 hours volume of the quote asset",
"format": "bigdecimal"
},
"total_supply_quote_asset": {
"type": "number",
"description": "Total supply of the quote asset",
"format": "bigdecimal"
},
"total_supply_base_asset": {
"type": "number",
"description": "Total supply of the quote asset",
"format": "bigdecimal"
},
"date_launched": {
"type": "string",
"description": "Timestamp (ISO 8601) of the launch date for this exchange.",
"format": "date-time"
},
"scroll_id": {
"type": "string",
"description": "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."
}
}
},
"SecurityScan3rdResult": {
"type": "object",
"properties": {
"open_source": {
"type": "boolean"
},
"proxy": {
"type": "boolean"
},
"mintable": {
"type": "boolean"
},
"can_take_back_ownership": {
"type": "boolean"
},
"owner_change_balance": {
"type": "boolean"
},
"hidden_owner": {
"type": "boolean"
},
"self_destruct": {
"type": "boolean"
},
"external_call": {
"type": "boolean"
},
"cannot_buy": {
"type": "boolean"
},
"cannot_sell_all": {
"type": "boolean"
},
"slippage_modifiable": {
"type": "boolean"
},
"honeypot": {
"type": "boolean"
},
"transfer_pausable": {
"type": "boolean"
},
"blacklisted": {
"type": "boolean"
},
"whitelisted": {
"type": "boolean"
},
"in_dex": {
"type": "boolean"
},
"anti_whale": {
"type": "boolean"
},
"anti_whale_modifiable": {
"type": "boolean"
},
"trading_cool_down": {
"type": "boolean"
},
"personal_slippage_modifiable": {
"type": "boolean"
},
"trust_list": {
"type": "boolean"
},
"true_token": {
"type": "boolean"
},
"airdrop_scam": {
"type": "boolean"
}
}
},
"SecurityScanAggregatedResult": {
"type": "object",
"properties": {
"contract_verified": {
"type": "boolean"
},
"honeypot": {
"type": "boolean"
}
}
},
"SecurityScanResult": {
"type": "object",
"properties": {
"third_party": {
"$ref": "#/components/schemas/SecurityScan3rdResult"
},
"aggregated": {
"$ref": "#/components/schemas/SecurityScanAggregatedResult"
}
},
"description": "Security scan by Go+.\n\n\nAll 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.\n\nCoinMarketCap 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.\n\nOnly returned if passed in aux."
},
"DexParisQuotesDTO": {
"type": "object",
"properties": {
"quote": {
"type": "array",
"description": "A map of market quotes in different currency conversions. The default map included is USD.",
"items": {
"$ref": "#/components/schemas/DexQuoteDTO"
}
},
"contract_address": {
"type": "string",
"description": "The unique contract address for this spot pair."
},
"name": {
"type": "string",
"description": "The name of this spot pair."
},
"base_asset_id": {
"type": [
"string",
"null"
],
"description": "The id of this base asset in the spot pair."
},
"base_asset_ucid": {
"type": "string",
"description": "The ucid of this base asset in the spot pair."
},
"base_asset_name": {
"type": "string",
"description": "The name of this base asset in the spot pair."
},
"base_asset_symbol": {
"type": "string",
"description": "The symbol of this base asset in the spot pair."
},
"base_asset_contract_address": {
"type": "string",
"description": "The contract addres of this base asset in the spot pair."
},
"quote_asset_id": {
"type": [
"string",
"null"
],
"description": "The id of this quote asset in the spot pair."
},
"quote_asset_ucid": {
"type": "string",
"description": "The ucid of this quote asset in the spot pair."
},
"quote_asset_name": {
"type": "string",
"description": "The name of this quote asset in the spot pair."
},
"quote_asset_symbol": {
"type": "string",
"description": "The symbol of this quote asset in the spot pair."
},
"quote_asset_contract_address": {
"type": "string",
"description": "The contract addresss of this quote asset in the spot pair."
},
"dex_id": {
"type": "string",
"description": "The id of this dex the spot pair is on."
},
"dex_slug": {
"type": "string",
"description": "The name of this dex the spot pair is on."
},
"network_id": {
"type": "string",
"description": "The id of the network the spot pair is on."
},
"network_slug": {
"type": "string",
"description": "The slug of the network the spot pair is on."
},
"last_updated": {
"type": "string",
"description": "Timestamp (ISO 8601) of the last time this record was updated.",
"format": "date-time"
},
"created_at": {
"type": [
"string",
"null"
],
"description": "Timestamp (ISO 8601) when we started tracking this asset.",
"format": "date-time"
},
"num_transactions_24h": {
"type": "integer",
"description": "Number of transactions in past 24 hours",
"format": "int64"
},
"holders": {
"type": [
"integer",
"null"
],
"description": "Number of holders of the asset",
"format": "int64"
},
"24h_no_of_buys": {
"type": "integer",
"description": "Number of asset buys in the past 24 hours",
"format": "int64"
},
"24h_no_of_sells": {
"type": "integer",
"description": "Number of asset sells in the past 24 hours",
"format": "int64"
},
"pool_created": {
"type": [
"string",
"null"
],
"description": "When the pool of the asset was created",
"format": "date-time"
},
"buy_tax": {
"type": [
"number",
"null"
],
"description": "Buy tax on the asset",
"format": "bigdecimal"
},
"sell_tax": {
"type": [
"number",
"null"
],
"description": "Sell tax on the asset",
"format": "bigdecimal"
},
"security_scan": {
"type": [
"array",
"null"
],
"description": "Security scan by Go+.\n\n\nAll 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.\n\nCoinMarketCap 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.\n\nOnly returned if passed in aux.",
"items": {
"$ref": "#/components/schemas/SecurityScanResult"
}
},
"pool_base_asset": {
"type": "number",
"description": "Base asset in the pool",
"format": "bigdecimal"
},
"pool_quote_asset": {
"type": "number",
"description": "Quote asset in the pool",
"format": "bigdecimal"
},
"percent_pooled_base_asset": {
"type": [
"number",
"null"
],
"description": "Percentage of the base asset in the pool",
"format": "bigdecimal"
},
"24h_volume_quote_asset": {
"type": "number",
"description": "24 hours volume of the quote asset",
"format": "bigdecimal"
},
"total_supply_quote_asset": {
"type": [
"number",
"null"
],
"description": "Total supply of the quote asset",
"format": "bigdecimal"
},
"total_supply_base_asset": {
"type": [
"number",
"null"
],
"description": "Total supply of the quote asset",
"format": "bigdecimal"
},
"date_launched": {
"type": "string",
"description": "Timestamp (ISO 8601) of the launch date for this exchange.",
"format": "date-time"
}
},
"description": "DEX pairs quotes data"
},
"IndexDetailDTO": {
"properties": {
"id": {
"description": "The unique CoinMarketCap ID for this cryptocurrency.",
"format": "int32",
"type": "integer"
},
"name": {
"description": "The name of this cryptocurrency.",
"type": "string"
},
"symbol": {
"description": "The ticker symbol for this cryptocurrency.",
"type": "string"
},
"url": {
"description": "The URL of the detail page on CoinMarketCap for this cryptocurrency.",
"type": "string"
},
"weight": {
"description": "The relative proportion of this constituent within the index expressed as a percentage.",
"format": "bigdecimal",
"type": "number"
}
},
"type": "object"
},
"IndexLatestDTO": {
"description": "The latest CoinMarketCap 100 Index value is returned in this object.",
"properties": {
"constituents": {
"description": "Array detailing the list of constituents and their weightage.",
"items": {
"$ref": "#/components/schemas/IndexDetailDTO"
},
"type": "array"
},
"last_update": {
"description": "Timestamp (ISO 8601) of the last time this record was updated.",
"type": "string",
"format": "date"
},
"next_update": {
"description": "Timestamp (ISO 8601) of the next time this record will be updated.",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"type": "string"
},
"value": {
"description": "Current value of CoinMarketCap 100 Index.",
"format": "bigdecimal",
"type": "number"
},
"value_24h_percentage_change": {
"description": "Percentage change of the CoinMarketCap 100 Index over the past 24h. ",
"format": "bigdecimal",
"type": "number"
}
},
"type": "object"
},
"IndexHistoricalDTO": {
"properties": {
"constituents": {
"description": "Array detailing the list of constituents and their weightage.",
"items": {
"$ref": "#/components/schemas/IndexDetailDTO"
},
"type": "array"
},
"update_time": {
"description": "Timestamp (ISO 8601) of the time this record was updated.",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"type": "string"
},
"value": {
"description": "Value of CoinMarketCap 100 Index.",
"format": "bigdecimal",
"type": "number"
}
},
"type": "object"
},
"CryptoQuoteV3DTO": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int32"
},
"name": {
"type": "string"
},
"symbol": {
"type": "string"
},
"slug": {
"type": "string"
},
"platform": {
"anyOf": [
{
"$ref": "#/components/schemas/Platform"
},
{
"type": "null"
}
]
},
"quote": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Quote"
}
},
"tags": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CryptoTag"
}
},
"is_active": {
"type": "integer",
"format": "int32"
},
"infinite_supply": {
"type": "boolean"
},
"is_market_cap_included_in_calc": {
"type": "integer",
"format": "int32"
},
"is_fiat": {
"type": "integer",
"format": "int32"
},
"circulating_supply": {
"type": "number",
"description": "Circulating supply of the cryptocurrency",
"format": "bigdecimal"
},
"total_supply": {
"type": "number",
"description": "Total supply of the cryptocurrency",
"format": "bigdecimal"
},
"max_supply": {
"type": [
"number",
"null"
],
"description": "Maximum supply of the cryptocurrency",
"format": "bigdecimal"
},
"date_added": {
"type": "string"
},
"num_market_pairs": {
"type": "integer",
"format": "int32"
},
"cmc_rank": {
"type": "integer",
"format": "int32"
},
"last_updated": {
"type": "string"
},
"tvl_ratio": {
"type": [
"number",
"null"
],
"description": "TVL to market cap ratio",
"format": "bigdecimal"
},
"self_reported_circulating_supply": {
"type": [
"number",
"null"
],
"description": "Self-reported circulating supply",
"format": "bigdecimal"
},
"self_reported_market_cap": {
"type": [
"number",
"null"
],
"description": "Self-reported market capitalization",
"format": "bigdecimal"
},
"unlocked_circulating_supply": {
"type": "number",
"description": "Unlocked circulating supply",
"format": "bigdecimal"
},
"unlocked_market_cap": {
"type": "number",
"description": "Unlocked market capitalization",
"format": "bigdecimal"
},
"minted_market_cap": {
"type": "number",
"description": "Market cap calculated from the minted supply, in the requested currency."
}
}
},
"CryptoTag": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
}
}
},
"Platform": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int32"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"symbol": {
"type": "string"
},
"token_address": {
"type": "string"
}
}
},
"Quote": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Currency ID",
"format": "int32"
},
"symbol": {
"type": "string",
"description": "Currency symbol"
},
"price": {
"type": "number",
"description": "Current price in the specified currency",
"format": "bigdecimal"
},
"volume_24h": {
"type": "number",
"description": "24-hour trading volume",
"format": "bigdecimal"
},
"cex_volume_24h": {
"type": "number",
"description": "24-hour trading volume from centralized exchanges",
"format": "bigdecimal"
},
"dex_volume_24h": {
"type": "number",
"description": "24-hour trading volume from decentralized exchanges",
"format": "bigdecimal"
},
"volume_24h_reported": {
"type": "number",
"description": "Reported 24-hour trading volume",
"format": "bigdecimal"
},
"volume_7d": {
"type": "number",
"description": "7-day trading volume",
"format": "bigdecimal"
},
"volume_7d_reported": {
"type": "number",
"description": "Reported 7-day trading volume",
"format": "bigdecimal"
},
"volume_30d": {
"type": "number",
"description": "30-day trading volume",
"format": "bigdecimal"
},
"volume_30d_reported": {
"type": "number",
"description": "Reported 30-day trading volume",
"format": "bigdecimal"
},
"volume_change_24h": {
"type": "number",
"description": "24-hour volume change percentage",
"format": "bigdecimal"
},
"percent_change_1h": {
"type": "number",
"description": "1-hour percentage change",
"format": "bigdecimal"
},
"percent_change_24h": {
"type": "number",
"description": "24-hour percentage change",
"format": "bigdecimal"
},
"percent_change_7d": {
"type": "number",
"description": "7-day percentage change",
"format": "bigdecimal"
},
"percent_change_30d": {
"type": "number",
"description": "30-day percentage change",
"format": "bigdecimal"
},
"percent_change_60d": {
"type": "number",
"description": "60-day percentage change",
"format": "bigdecimal"
},
"percent_change_90d": {
"type": "number",
"description": "90-day percentage change",
"format": "bigdecimal"
},
"market_cap": {
"type": "number",
"description": "Current market capitalization",
"format": "bigdecimal"
},
"market_cap_dominance": {
"type": "number",
"description": "Market cap dominance percentage",
"format": "bigdecimal"
},
"fully_diluted_market_cap": {
"type": "number",
"description": "Fully diluted market capitalization",
"format": "bigdecimal"
},
"minted_market_cap": {
"type": "number",
"description": "Minted market capitalization",
"format": "bigdecimal"
},
"tvl": {
"type": [
"number",
"null"
],
"description": "Total Value Locked",
"format": "bigdecimal"
},
"market_cap_by_total_supply": {
"type": "number",
"description": "Market cap calculated by total supply",
"format": "bigdecimal"
},
"last_updated": {
"type": "string",
"description": "Last updated timestamp"
}
}
},
"CryptoListingDTO": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int32"
},
"name": {
"type": "string"
},
"symbol": {
"type": "string"
},
"slug": {
"type": "string"
},
"platform": {
"anyOf": [
{
"$ref": "#/components/schemas/Platform"
},
{
"type": "null"
}
]
},
"quote": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Quote"
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"is_active": {
"type": "integer",
"format": "int32"
},
"infinite_supply": {
"type": "boolean"
},
"is_market_cap_included_in_calc": {
"type": "integer",
"format": "int32"
},
"is_fiat": {
"type": "integer",
"format": "int32"
},
"circulating_supply": {
"type": "number",
"description": "Circulating supply of the cryptocurrency",
"format": "bigdecimal"
},
"total_supply": {
"type": "number",
"description": "Total supply of the cryptocurrency",
"format": "bigdecimal"
},
"max_supply": {
"type": [
"number",
"null"
],
"description": "Maximum supply of the cryptocurrency",
"format": "bigdecimal"
},
"date_added": {
"type": "string"
},
"num_market_pairs": {
"type": "integer",
"format": "int32"
},
"cmc_rank": {
"type": "integer",
"format": "int32"
},
"last_updated": {
"type": "string"
},
"tvl_ratio": {
"type": [
"number",
"null"
],
"description": "TVL to market cap ratio",
"format": "bigdecimal"
},
"self_reported_circulating_supply": {
"type": [
"number",
"null"
],
"description": "Self-reported circulating supply",
"format": "bigdecimal"
},
"self_reported_market_cap": {
"type": [
"number",
"null"
],
"description": "Self-reported market capitalization",
"format": "bigdecimal"
},
"minted_market_cap": {
"type": "number",
"description": "Minted market capitalization",
"format": "bigdecimal"
},
"unlocked_circulating_supply": {
"type": "number",
"description": "Unlocked circulating supply",
"format": "bigdecimal"
},
"unlocked_market_cap": {
"type": "number",
"description": "Unlocked market capitalization",
"format": "bigdecimal"
}
}
},
"TokenLiquiditySnapshotDTO": {
"type": "object",
"properties": {
"snapshotTime": {
"type": "integer",
"format": "int64"
},
"liquidityUsd": {
"type": "number"
},
"liquidity": {
"type": "number"
}
}
},
"SwapListResponseDTO": {
"type": "object",
"properties": {
"swaps": {
"type": "array",
"description": "List of swap transactions",
"items": {
"$ref": "#/components/schemas/TradeHistoryDTO"
}
},
"lastId": {
"type": "string",
"description": "Last ID for pagination"
}
},
"description": "Swap list response data"
},
"TagDTO": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Tag type"
},
"value": {
"type": "integer",
"description": "Tag value",
"format": "int32"
}
},
"description": "Tag of swap tx"
},
"TradeHistoryDTO": {
"type": "object",
"properties": {
"ts": {
"type": "string",
"description": "Transaction time (timestamp)"
},
"tp": {
"type": "string",
"description": "Transaction type (buy/sell)"
},
"t0a": {
"type": "string",
"description": "Base token address"
},
"t1a": {
"type": "string",
"description": "Quote token address"
},
"t0s": {
"type": "string",
"description": "Base token symbol"
},
"t1s": {
"type": "string",
"description": "Quote token symbol"
},
"eid": {
"type": "integer",
"description": "exchange id",
"format": "int32"
},
"en": {
"type": "string",
"description": "exchange name"
},
"f": {
"type": "string",
"description": "factory address"
},
"a0": {
"type": "number",
"description": "Base token amount"
},
"a1": {
"type": "number",
"description": "Quote token amount"
},
"t0pu": {
"type": "number",
"description": "Price in USD"
},
"t1pu": {
"type": "number",
"description": "Price in USD"
},
"q": {
"type": "number",
"description": "Price in quote"
},
"v": {
"type": "number",
"description": "Total transaction value in USD"
},
"qi": {
"type": "integer",
"description": "quoteIndex",
"format": "int32"
},
"ma": {
"type": "string",
"description": "Maker address"
},
"ex": {
"type": "boolean",
"description": "exclude"
},
"txtp": {
"type": "integer",
"description": "exclude",
"format": "int32"
},
"tx": {
"type": "string",
"description": "Transaction hash"
},
"h": {
"type": "string",
"description": "height"
},
"txId": {
"type": "string",
"description": "txId"
},
"lgid": {
"type": "string",
"description": "Log ID"
},
"t0t": {
"type": "boolean",
"description": "t0top"
},
"t1t": {
"type": "boolean",
"description": "t1top"
},
"tags": {
"type": "array",
"description": "holder tags",
"items": {
"$ref": "#/components/schemas/TagDTO"
}
},
"tc": {
"type": "string",
"description": "transaction count"
},
"kn": {
"type": "string",
"description": "kol name"
},
"kpn": {
"type": "string",
"description": "kol public name"
},
"klu": {
"type": "string",
"description": "kol logo url"
},
"t0pt": {
"type": "string",
"description": "Token0 position type (open/close/add/reduce)"
},
"t1pt": {
"type": "string",
"description": "Token1 position type (open/close/add/reduce)"
}
},
"description": "Swap transaction data"
},
"BnSecurityExtraInfoDTO": {
"type": "object",
"properties": {
"buyTax": {
"type": "string",
"description": "Buy tax"
},
"sellTax": {
"type": "string",
"description": "Sell tax"
},
"isFlaggedByVendor": {
"type": "boolean",
"description": "Whether the token is flagged by third-party security vendors",
"example": false
},
"isVerified": {
"type": "boolean",
"description": "Whether the token contract is verified",
"example": true
},
"isReported": {
"type": "boolean",
"description": "Whether the token has been reported by users or security platforms",
"example": false
},
"source": {
"type": "string",
"description": "Data source of the security information",
"example": "GoPlus"
}
},
"description": "Extra security metadata provided by external vendors or on-chain analysis"
},
"DisplayItem": {
"type": "object",
"properties": {
"honeypotStatus": {
"type": "string",
"description": "EVM - Honeypot status",
"example": "Safe"
},
"unverifiedContractStatus": {
"type": "string",
"description": "EVM - Unverified contract status",
"example": "Verified"
},
"mintableStatus": {
"type": "string",
"description": "Solana - Mintable token status",
"example": "Non-mintable"
},
"freezableStatus": {
"type": "string",
"description": "Solana - Freezable status",
"example": "Non-freezable"
},
"rugPullStatus": {
"type": "string",
"description": "Solana - Rug pull detection",
"example": "No risk"
},
"fakeTokenStatus": {
"type": "string",
"description": "Solana - Fake token detection",
"example": "Genuine"
}
},
"description": "Security item display flags for EVM or Solana"
},
"SecurityItem": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Rule code"
},
"riskCode": {
"type": "string",
"description": "Risk classification code"
},
"riskyLevel": {
"type": "string",
"description": "Risk level"
},
"isHit": {
"type": "boolean",
"description": "Whether the risk was hit",
"example": true
},
"order": {
"type": "integer",
"description": "Display order",
"format": "int32"
},
"des": {
"type": "string",
"description": "Risk description"
},
"groupId": {
"type": "string",
"description": "Group ID for categorization"
}
},
"description": "Detailed security item"
},
"TokenSecurityResponseDTO": {
"type": "object",
"properties": {
"platformName": {
"type": "string",
"description": "Platform name",
"example": "ethereum"
},
"platformId": {
"type": "integer",
"description": "Platform ID",
"format": "int32",
"example": 1
},
"tokenContractAddress": {
"type": "string",
"description": "Token contract address",
"example": "0xabc123..."
},
"securityLevel": {
"type": "string",
"description": "Overall security level"
},
"categoryLevel": {
"type": "string",
"description": "Overall category level"
},
"securityBatchLevel": {
"type": "integer",
"description": "Overall security batch level",
"format": "int32"
},
"extra": {
"$ref": "#/components/schemas/BnSecurityExtraInfoDTO"
},
"securityItems": {
"type": "array",
"description": "Detailed security items",
"items": {
"$ref": "#/components/schemas/SecurityItem"
}
},
"evmDisplay": {
"$ref": "#/components/schemas/DisplayItem"
},
"solanaDisplay": {
"$ref": "#/components/schemas/DisplayItem"
},
"exist": {
"type": "boolean",
"description": "token security exist"
},
"tags": {
"type": "array",
"description": "token security exist",
"items": {
"type": "string",
"description": "token security exist"
}
}
},
"description": "Token security response"
},
"SearchResponseDTO": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"format": "int32"
},
"tks": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SearchResultDTO"
}
}
}
},
"SearchResultDTO": {
"type": "object",
"properties": {
"pltId": {
"type": "integer",
"format": "int32"
},
"plt": {
"type": "string"
},
"plti": {
"type": "integer",
"format": "int32"
},
"n": {
"type": "string"
},
"s": {
"type": "string"
},
"addr": {
"type": "string"
},
"pt": {
"type": "string"
},
"lt": {
"type": "string"
},
"w": {
"type": "string"
},
"x": {
"type": "string"
},
"l": {
"type": "string"
},
"pu": {
"type": "string"
},
"pc24h": {
"type": "number",
"format": "float"
},
"dec": {
"type": "integer",
"format": "int32"
},
"tsup": {
"type": "string"
},
"fpt": {
"type": "string"
},
"fpct": {
"type": "string"
},
"v24h": {
"type": "number"
},
"fdv": {
"type": "number"
},
"mc": {
"type": "number"
},
"liq": {
"type": "number"
},
"ts": {
"type": "string"
},
"lf": {
"type": "integer",
"format": "int32"
},
"cid": {
"type": "integer",
"format": "int32"
},
"bnCid": {
"type": "string"
},
"ut24h": {
"type": "string"
},
"ecs": {
"type": "integer",
"description": "Binance exclusive code, 1 - exclusive",
"format": "int32"
},
"ssc": {
"type": "number",
"description": "Search relevance score",
"format": "float"
},
"pin": {
"type": "string",
"description": "Comma-separated pinned types based on sort fields: ido,alpha,trending or null"
}
}
},
"PlatformDTO": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Unique platform ID",
"format": "int32",
"example": 14
},
"n": {
"type": "string",
"description": "Platform name",
"example": "Ethereum"
},
"i": {
"type": "string",
"description": "Icon URL for the platform",
"example": "https://cdn.example.com/icons/eth.png"
},
"uf": {
"type": "string",
"description": "URL format for block explorer (contract/token)",
"example": "https://etherscan.io/token/{tokenAddress}"
},
"dn": {
"type": "string",
"description": "Number of supported DEXs on this platform",
"example": "12"
},
"txuf": {
"type": "string",
"description": "URL format for viewing transactions",
"example": "https://etherscan.io/tx/{txHash}"
},
"v": {
"type": "boolean",
"description": "Whether the platform is visible in the UI",
"example": true
},
"p": {
"type": "boolean",
"description": "Whether the platform is pinned (e.g., prioritized display)",
"example": false
},
"addrUrl": {
"type": "string",
"description": "URL format for address explorer",
"example": "https://etherscan.io/address/{address}"
},
"chId": {
"type": "integer",
"description": "Internal chain ID",
"format": "int32",
"example": 1
},
"puf": {
"type": "string",
"description": "URL format for pool explorer",
"example": "https://dexscan.io/pool/{poolAddress}"
},
"wcId": {
"type": "integer",
"description": "Wrapped native token ID (e.g., WETH)",
"format": "int32",
"example": 2001
},
"hl": {
"type": "integer",
"description": "Whether the platform is highlighted",
"format": "int32",
"example": 1
},
"ho": {
"type": "integer",
"description": "Display order for highlighted platforms",
"format": "int32",
"example": 3
},
"pltA": {
"type": "string",
"description": "platform acronym",
"example": "ETH"
},
"cid": {
"type": "integer",
"format": "int32"
},
"na": {
"type": "string",
"description": "Address used for this platform's native coin, for example `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` on EVM chains."
}
},
"description": "Data Transfer Object representing a supported blockchain platform"
},
"LiquidityChangeDTO": {
"type": "object",
"properties": {
"ts": {
"type": "string"
},
"tp": {
"type": "string"
},
"eid": {
"type": "integer",
"description": "exchange id",
"format": "int32"
},
"en": {
"type": "string",
"description": "exchange name"
},
"f": {
"type": "string",
"description": "factory address"
},
"t0a": {
"type": "string",
"description": "Base token address"
},
"t1a": {
"type": "string",
"description": "Quote token address"
},
"t0s": {
"type": "string"
},
"t1s": {
"type": "string"
},
"a0": {
"type": "number"
},
"a1": {
"type": "number"
},
"tu": {
"type": "number"
},
"m": {
"type": "string"
},
"txn": {
"type": "string"
},
"h": {
"type": "string"
},
"txId": {
"type": "string"
},
"lgid": {
"type": "string"
}
},
"description": "List of liquidity change transactions"
},
"LiquidityChangeListResponseDTO": {
"type": "object",
"properties": {
"lastId": {
"type": "string",
"description": "Last ID for pagination"
},
"lcs": {
"type": "array",
"description": "List of liquidity change transactions",
"items": {
"$ref": "#/components/schemas/LiquidityChangeDTO"
}
},
"tlu": {
"type": "number",
"description": "total liquidity usd value"
},
"lpc": {
"type": "string",
"description": "liquidity pool count"
}
},
"description": "Swap list response data"
},
"DqueryHoldersDetailRequestDTO": {
"type": "object",
"properties": {
"tokenAddress": {
"type": "string",
"description": "Token contract address",
"example": "0x1234567890abcdef1234567890abcdef12345678"
},
"walletAddress": {
"type": "string",
"description": "Wallet address",
"example": "0xabcdef1234567890abcdef1234567890abcdef12"
},
"platform": {
"type": "string",
"description": "Blockchain platform",
"example": "ethereum"
},
"tag": {
"type": "string",
"description": "tag enum [tag_all, tag_kol, tag_smart_money, tag_whale, tag_bot, tag_sniper, tag_dev]",
"example": "tag_all"
}
},
"description": "holders detail request"
},
"DqueryHoldersRequestDTO": {
"type": "object",
"properties": {
"tokenAddress": {
"type": "string",
"description": "Token contract address",
"example": "0x1234567890abcdef1234567890abcdef12345678"
},
"platform": {
"type": "string",
"description": "Blockchain platform",
"example": "ethereum"
},
"tag": {
"type": "string",
"description": "tag enum [tag_all, tag_kol, tag_smart_money, tag_whale, tag_bot, tag_sniper, tag_dev]",
"example": "tag_all"
}
},
"description": "holders request"
},
"HolderCountVO": {
"type": "object",
"properties": {
"platformId": {
"type": "integer",
"format": "int32"
},
"count": {
"type": "string"
},
"tokenAddress": {
"type": "string"
}
}
},
"HolderDetailVO": {
"type": "object",
"properties": {
"blockHeight": {
"type": "string"
},
"firstActiveTime": {
"type": "string"
},
"netBuyAmount": {
"type": "string"
},
"realizedPnlPercent": {
"type": "string"
},
"spotPosition": {
"type": "string"
},
"buyVolume": {
"type": "string"
},
"sellVolume": {
"type": "string"
},
"buyUsd": {
"type": "string"
},
"sellUsd": {
"type": "string"
},
"buyCount": {
"type": "string"
},
"sellCount": {
"type": "string"
},
"avgBuyPriceUsd": {
"type": "string"
},
"avgSellPriceUsd": {
"type": "string"
},
"realizedPnl": {
"type": "string"
},
"actualBalance": {
"type": "string"
},
"price": {
"type": "string"
},
"walletAddress": {
"type": "string"
},
"tokenAddress": {
"type": "string"
},
"platformId": {
"type": "integer",
"format": "int32"
},
"percent": {
"type": "string"
},
"balance": {
"type": "string"
},
"totalSupply": {
"type": "string"
},
"tokenAccount": {
"type": "string"
},
"logoUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"publicName": {
"type": "string"
},
"tags": {
"type": "string"
},
"addressExplorerUrl": {
"type": "string"
},
"symbol": {
"type": "string"
},
"nativeBalance": {
"type": "string"
},
"fundingSource": {
"type": "string"
},
"fundingTime": {
"type": "string"
},
"lastActiveTime": {
"type": "string"
},
"walletCreateTime": {
"type": "integer",
"format": "int64"
},
"spotOpenTs": {
"type": "string"
},
"spotClearanceTs": {
"type": "string"
},
"tokenLogo": {
"type": "string"
},
"tokenSymbol": {
"type": "string"
},
"platformCryptoId": {
"type": "integer",
"format": "int32"
},
"dexerPlatformName": {
"type": "string"
},
"lowLiquidityFlag": {
"type": "integer",
"format": "int32"
},
"memePumpInnerFlag": {
"type": "integer",
"format": "int32"
},
"blackListFlag": {
"type": "integer",
"format": "int32"
},
"stableCoinFlag": {
"type": "integer",
"format": "int32"
},
"riskLevelFlag": {
"type": "integer",
"format": "int32"
}
}
},
"HolderDexVO": {
"type": "object",
"properties": {
"holders": {
"type": "array",
"items": {
"$ref": "#/components/schemas/HolderDetailVO"
}
}
}
},
"ApiResponseOfIndexHistoricalResponseDTO": {
"properties": {
"data": {
"$ref": "#/components/schemas/IndexHistoricalDpsDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"type": "object"
},
"ApiResponseOfIndexLatestResponseDTO": {
"properties": {
"data": {
"$ref": "#/components/schemas/IndexLatestDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
],
"type": "object"
},
"IndexHistoricalDpsDTO": {
"items": {
"$ref": "#/components/schemas/IndexHistoricalDTO"
},
"type": "array"
},
"ApiResponseOfCMC20IndexHistoricalResponseDTO": {
"properties": {
"data": {
"$ref": "#/components/schemas/CMC20IndexHistoricalDpsDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"type": "object"
},
"ApiResponseOfCMC20IndexLatestResponseDTO": {
"properties": {
"data": {
"$ref": "#/components/schemas/CMC20IndexLatestDTO"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
],
"type": "object"
},
"CMC20IndexDetailDTO": {
"properties": {
"id": {
"description": "The unique CoinMarketCap ID for this cryptocurrency.",
"format": "int32",
"type": "integer"
},
"name": {
"description": "The name of this cryptocurrency.",
"type": "string"
},
"symbol": {
"description": "The ticker symbol for this cryptocurrency.",
"type": "string"
},
"url": {
"description": "The URL of the detail page on CoinMarketCap for this cryptocurrency.",
"type": "string"
},
"weight": {
"description": "The relative proportion of this constituent within the index expressed as a percentage.",
"format": "bigdecimal",
"type": "number"
},
"priceUsd": {
"description": "The price of this cryptocurrency in USD.",
"format": "bigdecimal",
"type": "number"
},
"units": {
"description": "The units of this cryptocurrency.",
"format": "bigdecimal",
"type": "number"
}
},
"type": "object"
},
"CMC20IndexHistoricalDTO": {
"properties": {
"constituents": {
"description": "Array detailing the list of constituents and their weightage.",
"items": {
"$ref": "#/components/schemas/CMC20IndexDetailDTO"
},
"type": "array"
},
"update_time": {
"description": "Timestamp (ISO 8601) of the time this record was updated.",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"type": "string"
},
"value": {
"description": "Value of CoinMarketCap 20 Index.",
"format": "bigdecimal",
"type": "number"
}
},
"type": "object"
},
"CMC20IndexHistoricalDpsDTO": {
"items": {
"$ref": "#/components/schemas/CMC20IndexHistoricalDTO"
},
"type": "array"
},
"CMC20IndexLatestDTO": {
"description": "The latest CoinMarketCap 20 Index value is returned in this object.",
"properties": {
"constituents": {
"description": "Array detailing the list of constituents and their weightage.",
"items": {
"$ref": "#/components/schemas/CMC20IndexDetailDTO"
},
"type": "array"
},
"last_update": {
"description": "Timestamp (ISO 8601) of the last time this record was updated.",
"type": "string",
"format": "date"
},
"next_update": {
"description": "Timestamp (ISO 8601) of the next time this record will be updated.",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"type": "string"
},
"value": {
"description": "Current value of CoinMarketCap 20 Index.",
"format": "bigdecimal",
"type": "number"
},
"value_24h_percentage_change": {
"description": "Percentage change of the CoinMarketCap 20 Index over the past 24h. ",
"format": "bigdecimal",
"type": "number"
}
},
"type": "object"
},
"API_Status_Object": {
"type": "object",
"description": "Standardized status object for API calls.",
"properties": {
"timestamp": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Current timestamp (ISO 8601) on the server.",
"example": "2026-03-05T22:43:48.471Z"
},
"error_code": {
"type": [
"integer",
"string"
],
"description": "An internal error code for the current error. If a unique platform error code is not available the HTTP status code is returned. `0` is returned if there is no error. Some endpoints return this code as a string, for example `\"0\"`."
},
"error_message": {
"type": [
"string",
"null"
],
"description": "An error message to go along with the error code.",
"example": ""
},
"elapsed": {
"type": "integer",
"description": "Number of milliseconds taken to generate this response.",
"example": 10
},
"credit_count": {
"type": "integer",
"description": "Number of API call credits that were used for this call.",
"example": 1
},
"notice": {
"type": [
"string",
"null"
],
"description": "Optional notice about API key information.",
"example": ""
},
"total_count": {
"type": "integer",
"description": "Total number of results available for this request. Only returned by some list endpoints.",
"example": 8128
}
},
"required": [
"timestamp",
"error_code",
"error_message",
"elapsed",
"credit_count"
]
},
"HTTP_Status_400_Error_Object": {
"type": "object",
"description": "Bad Request",
"properties": {
"status": {
"$ref": "#/components/schemas/status"
}
}
},
"status_1": {
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Current ISO 8601 timestamp on the server.",
"example": "2018-06-02T22:51:28.209Z"
},
"error_code": {
"type": "integer",
"description": "An internal error code for the current error. If a unique platform error code is not available the HTTP status code is returned.",
"example": 1002,
"default": 401
},
"error_message": {
"type": "string",
"description": "An error message to go along with the error code.",
"example": "API key missing."
},
"elapsed": {
"type": "integer",
"description": "Number of milliseconds taken to generate this response",
"example": 10
},
"credit_count": {
"type": "integer",
"description": "Number of API call credits required for this call. Always 0 for errors.",
"example": 0
}
},
"required": [
"timestamp",
"error_code",
"error_message",
"elapsed",
"credit_count"
]
},
"HTTP_Status_401_Error_Object": {
"type": "object",
"description": "Unauthorized",
"properties": {
"status": {
"$ref": "#/components/schemas/status_1"
}
}
},
"status_2": {
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Current ISO 8601 timestamp on the server.",
"example": "2018-06-02T22:51:28.209Z"
},
"error_code": {
"type": "integer",
"description": "An internal error code for the current error. If a unique platform error code is not available the HTTP status code is returned.",
"example": 1006,
"default": 403
},
"error_message": {
"type": "string",
"description": "An error message to go along with the error code.",
"example": "Your API Key subscription plan doesn't support this endpoint."
},
"elapsed": {
"type": "integer",
"description": "Number of milliseconds taken to generate this response",
"example": 10
},
"credit_count": {
"type": "integer",
"description": "Number of API call credits required for this call. Always 0 for errors.",
"example": 0
}
},
"required": [
"timestamp",
"error_code",
"error_message",
"elapsed",
"credit_count"
]
},
"HTTP_Status_403_Error_Object": {
"type": "object",
"description": "Forbidden",
"properties": {
"status": {
"$ref": "#/components/schemas/status_2"
}
}
},
"status_3": {
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Current ISO 8601 timestamp on the server.",
"example": "2018-06-02T22:51:28.209Z"
},
"error_code": {
"type": "integer",
"description": "An internal error code string for the current error. If a unique platform error code is not available the HTTP status code is returned.",
"example": 1008,
"default": 429
},
"error_message": {
"type": "string",
"description": "An error message to go along with the error code.",
"example": "You've exceeded your API Key's HTTP request rate limit. Rate limits reset every minute."
},
"elapsed": {
"type": "integer",
"description": "Number of milliseconds taken to generate this response",
"example": 10
},
"credit_count": {
"type": "integer",
"description": "Number of API call credits required for this call. Always 0 for errors.",
"example": 0
}
},
"required": [
"timestamp",
"error_code",
"error_message",
"elapsed",
"credit_count"
]
},
"HTTP_Status_429_Error_Object": {
"type": "object",
"description": "Too Many Requests",
"properties": {
"status": {
"$ref": "#/components/schemas/status_3"
}
}
},
"status_4": {
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Current ISO 8601 timestamp on the server.",
"example": "2018-06-02T22:51:28.209Z"
},
"error_code": {
"type": "integer",
"description": "An internal error code string for the current error. If a unique platform error code is not available the HTTP status code is returned.",
"default": 500,
"enum": [
500
]
},
"error_message": {
"type": "string",
"description": "An error message to go along with the error code.",
"example": "An internal server error occurred"
},
"elapsed": {
"type": "integer",
"description": "Number of milliseconds taken to generate this response",
"example": 10
},
"credit_count": {
"type": "integer",
"description": "Number of API call credits required for this call. Always 0 for errors.",
"example": 0
}
},
"required": [
"timestamp",
"error_code",
"error_message",
"elapsed",
"credit_count"
]
},
"HTTP_Status_500_Error_Object": {
"type": "object",
"description": "Internal Server Error",
"properties": {
"status": {
"$ref": "#/components/schemas/status_4"
}
}
},
"Categories_-_Category_object": {
"type": "object",
"description": "A results object for each category requested. The map key being the id used in the request.",
"properties": {
"id": {
"type": "string",
"description": "The unique ID of the category",
"example": "fj3893983c1b42617d6dc0"
},
"name": {
"type": "string",
"description": "The name of the category",
"example": "A16Z Portfolio"
},
"title": {
"type": "string",
"description": "The title of the category",
"example": "A16Z Portfolio"
},
"description": {
"type": "string",
"description": "The description of the category",
"example": "A16Z Portfolio"
},
"num_tokens": {
"type": "integer",
"example": 12
},
"avg_price_change": {
"type": "number",
"description": "Average price change of coins within this categry",
"example": 0.03
},
"market_cap": {
"type": "number",
"description": "Market cap of coins within this categry",
"example": 121020662982
},
"market_cap_change": {
"type": "number",
"description": "Market cap change of coins within this categry",
"example": 0.03
},
"volume": {
"type": "number",
"description": "Volume of coins within this categry",
"example": 121020662982
},
"volume_change": {
"type": "number",
"description": "Volume change of coins within this categry",
"example": 0.03
},
"last_updated": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when this was last updated.",
"example": "2013-04-28T00:00:00.000Z"
}
},
"required": [
"id",
"avg_price_change",
"market_cap",
"market_cap_change",
"volume",
"volume_change",
"last_updated"
]
},
"Categories_-_Results_map": {
"type": "array",
"description": "Results of your query returned as an object map.",
"items": {
"$ref": "#/components/schemas/Categories_-_Category_object"
}
},
"Categories_-_Response_Model": {
"type": "object",
"example": {
"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": "2021-11-10T10:35:12.354Z"
}
],
"status": {
"timestamp": "2021-08-01T22:51:28.209Z",
"error_code": 0,
"error_message": "",
"elapsed": 3,
"credit_count": 1
}
},
"properties": {
"data": {
"$ref": "#/components/schemas/Categories_-_Results_map"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Cryptocurrency_-_Quote_object": {
"type": "object",
"description": "A market quote in the currency conversion option.",
"properties": {
"price": {
"type": [
"number",
"null"
],
"description": "Price in the specified currency for this historical.",
"example": 7139.82
},
"volume_24h": {
"type": [
"number",
"null"
],
"description": "Rolling 24 hour adjusted volume in the specified currency.",
"example": 4885880000
},
"volume_24h_reported": {
"type": "number",
"description": "Rolling 24 hour reported volume in the specified currency. *This field is only returned if requested through the `aux` request parameter.*",
"example": 4885880000
},
"volume_7d": {
"type": "number",
"description": "Rolling 7 day adjusted volume in the specified currency. *This field is only returned if requested through the `aux` request parameter.*",
"example": 4885880000
},
"volume_7d_reported": {
"type": "number",
"description": "Rolling 7 day reported volume in the specified currency. *This field is only returned if requested through the `aux` request parameter.*",
"example": 4885880000
},
"volume_30d": {
"type": "number",
"description": "Rolling 30 day adjusted volume in the specified currency. *This field is only returned if requested through the `aux` request parameter.*",
"example": 4885880000
},
"volume_30d_reported": {
"type": "number",
"description": "Rolling 30 day reported volume in the specified currency. *This field is only returned if requested through the `aux` request parameter.*",
"example": 4885880000
},
"market_cap": {
"type": [
"number",
"null"
],
"description": "Market cap in the specified currency.",
"example": 121020662982
},
"percent_change_1h": {
"type": [
"number",
"null"
],
"description": "1 hour change in the specified currency.",
"example": 0.03
},
"percent_change_24h": {
"type": [
"number",
"null"
],
"description": "24 hour change in the specified currency.",
"example": 5.75
},
"percent_change_7d": {
"type": [
"number",
"null"
],
"description": "7 day change in the specified currency.",
"example": -19.64
},
"last_updated": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when the conversion currency's current value was referenced.",
"example": "2018-06-02T23:59:59.999Z"
},
"cex_volume_24h": {
"type": "number",
"description": "24 hour trading volume from centralized exchanges in the requested currency."
},
"dex_volume_24h": {
"type": "number",
"description": "24 hour trading volume from decentralized exchanges in the requested currency."
},
"volume_change_24h": {
"type": [
"number",
"null"
],
"description": "24 hour change in trading volume, as a percentage."
},
"percent_change_30d": {
"type": [
"number",
"null"
],
"description": "30 day price change as a percentage."
},
"percent_change_60d": {
"type": [
"number",
"null"
],
"description": "60 day price change as a percentage."
},
"percent_change_90d": {
"type": [
"number",
"null"
],
"description": "90 day price change as a percentage."
},
"market_cap_dominance": {
"type": [
"number",
"null"
],
"description": "This cryptocurrency's share of the total cryptocurrency market cap, as a percentage."
},
"fully_diluted_market_cap": {
"type": [
"number",
"null"
],
"description": "Fully diluted market cap in the requested currency."
},
"tvl": {
"type": [
"number",
"null"
],
"description": "Total value locked in the requested currency. `null` when TVL is not available."
}
},
"required": [
"price",
"volume_24h",
"market_cap",
"percent_change_1h",
"percent_change_24h",
"percent_change_7d",
"last_updated"
]
},
"Cryptocurrency_-_Quote_map": {
"type": "object",
"description": "A map of market quotes in different currency conversions. The default map included is USD.",
"example": {
"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"
}
},
"additionalProperties": {
"$ref": "#/components/schemas/Cryptocurrency_-_Quote_object"
}
},
"Cryptocurrency_-_Cryptocurrency_object": {
"type": "object",
"description": "A cryptocurrency object for every cryptocurrency that matched list options.",
"properties": {
"id": {
"type": "integer",
"description": "The unique CoinMarketCap ID for this cryptocurrency.",
"example": 1
},
"name": {
"type": "string",
"description": "The name of this cryptocurrency.",
"example": "Bitcoin"
},
"symbol": {
"type": "string",
"description": "The ticker symbol for this cryptocurrency.",
"example": "BTC"
},
"slug": {
"type": "string",
"description": "The web URL friendly shorthand version of this cryptocurrency name.",
"example": "bitcoin"
},
"cmc_rank": {
"type": [
"integer",
"null"
],
"description": "The cryptocurrency's CoinMarketCap rank by market cap.",
"example": 5
},
"num_market_pairs": {
"type": "integer",
"description": "The number of active trading pairs available for this cryptocurrency across supported exchanges.",
"example": 500
},
"circulating_supply": {
"type": "number",
"description": "The approximate number of coins circulating for this cryptocurrency.",
"example": 16950100
},
"total_supply": {
"type": "number",
"description": "The approximate total amount of coins in existence right now (minus any coins that have been verifiably burned).",
"example": 16950100
},
"market_cap_by_total_supply": {
"type": "number",
"description": "The market cap by total supply. *This field is only returned if requested through the `aux` request parameter.*",
"example": 158055024432
},
"max_supply": {
"type": [
"number",
"null"
],
"description": "The expected maximum limit of coins ever to be available for this cryptocurrency.",
"example": 21000000
},
"last_updated": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of the last time this cryptocurrency's market data was updated.",
"example": "2018-06-02T22:51:28.209Z"
},
"date_added": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when this cryptocurrency was added to CoinMarketCap.",
"example": "2013-04-28T00:00:00.000Z"
},
"tags": {
"$ref": "#/components/schemas/tags"
},
"platform": {
"$ref": "#/components/schemas/platform"
},
"quote": {
"$ref": "#/components/schemas/Cryptocurrency_-_Quote_map"
},
"is_active": {
"type": "integer",
"description": "1 if this cryptocurrency has at least 1 active market currently being tracked by the platform, otherwise 0."
},
"infinite_supply": {
"type": "boolean",
"description": "Whether this cryptocurrency is known to have an infinite supply."
},
"is_fiat": {
"type": "integer",
"description": "1 if this is a fiat currency, otherwise 0."
},
"tvl_ratio": {
"type": [
"number",
"null"
],
"description": "Ratio of total value locked to market cap. `null` when TVL is not available."
},
"self_reported_circulating_supply": {
"type": [
"number",
"null"
],
"description": "The circulating supply reported by the project team. `null` when not reported."
},
"self_reported_market_cap": {
"type": [
"number",
"null"
],
"description": "The market cap based on the self-reported circulating supply. `null` when not reported."
},
"minted_market_cap": {
"type": "number",
"description": "Market cap calculated from the minted supply, in the requested currency."
}
},
"required": [
"id",
"name",
"symbol",
"slug",
"quote"
]
},
"Cryptocurrency_-_Results_array": {
"type": "array",
"description": "Array of cryptocurrency objects matching the list options.",
"items": {
"$ref": "#/components/schemas/Cryptocurrency_-_Cryptocurrency_object"
},
"required": [
"Cryptocurrency - Cryptocurrency object"
]
},
"Category_-_Cryptocurrency_object": {
"type": "object",
"description": "A results object for each cryptocurrency found in the category.",
"properties": {
"id": {
"type": "string",
"description": "The unique ID of the category",
"example": "169267882822616"
},
"name": {
"type": "string",
"description": "The name of the category",
"example": "A16Z Portfolio"
},
"title": {
"type": "string",
"description": "The title of the category",
"example": "A16Z Portfolio"
},
"description": {
"type": "string",
"description": "The description of the category",
"example": "A16Z Portfolio"
},
"num_tokens": {
"type": "integer",
"example": 12
},
"avg_price_change": {
"type": "number",
"description": "Average price change of coins within this categry",
"example": 0.03
},
"market_cap": {
"type": "number",
"description": "Market cap of coins within this categry",
"example": 121020662982
},
"market_cap_change": {
"type": "number",
"description": "Market cap change of coins within this categry",
"example": 0.03
},
"volume": {
"type": "number",
"description": "Volume of coins within this categry",
"example": 121020662982
},
"volume_change": {
"type": "number",
"description": "Volume change of coins within this categry",
"example": 0.03
},
"coins": {
"$ref": "#/components/schemas/Cryptocurrency_-_Results_array"
},
"last_updated": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when this was last updated.",
"example": "2013-04-28T00:00:00.000Z"
}
},
"required": [
"id",
"avg_price_change",
"market_cap",
"market_cap_change",
"volume",
"volume_change",
"coins",
"last_updated"
]
},
"Category_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Category_-_Cryptocurrency_object"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"tags_1": {
"type": "array",
"description": "Tags associated with this cryptocurrency.",
"example": [
"mineable"
],
"items": {
"type": "string"
}
},
"Cryptocurrencies_Info_-_URLs_object": {
"type": "object",
"description": "An object containing various resource URLs for this cryptocurrency.",
"properties": {
"website": {
"$ref": "#/components/schemas/website"
},
"technical_doc": {
"$ref": "#/components/schemas/technical_doc"
},
"explorer": {
"$ref": "#/components/schemas/explorer"
},
"source_code": {
"$ref": "#/components/schemas/source_code"
},
"message_board": {
"$ref": "#/components/schemas/message_board"
},
"chat": {
"$ref": "#/components/schemas/chat"
},
"announcement": {
"$ref": "#/components/schemas/announcement"
},
"reddit": {
"$ref": "#/components/schemas/reddit"
},
"twitter": {
"$ref": "#/components/schemas/twitter"
},
"facebook": {
"type": "array",
"description": "Facebook links for this cryptocurrency.",
"items": {
"type": "string"
}
}
},
"required": [
"website",
"technical_doc",
"explorer",
"source_code",
"message_board",
"chat",
"announcement",
"reddit",
"twitter"
]
},
"Cryptocurrencies_Info_-_Cryptocurrency_object._Please_note_this_will_be_wrapped_in_an_array_if_you_request_by_symbol_using_the_v2_endpoint.": {
"type": "object",
"description": "A results object for each cryptocurrency requested. The map key being the id/symbol used in the request.",
"properties": {
"id": {
"type": "integer",
"description": "The unique CoinMarketCap ID for this cryptocurrency.",
"example": 1
},
"name": {
"type": "string",
"description": "The name of this cryptocurrency.",
"example": "Bitcoin"
},
"symbol": {
"type": "string",
"description": "The ticker symbol for this cryptocurrency.",
"example": "BTC"
},
"category": {
"type": "string",
"description": "The category for this cryptocurrency.",
"example": "coin",
"enum": [
"coin",
"token"
]
},
"slug": {
"type": "string",
"description": "The web URL friendly shorthand version of this cryptocurrency name.",
"example": "bitcoin"
},
"logo": {
"type": "string",
"description": "Link to a CoinMarketCap hosted logo png for this cryptocurrency. 64px is default size returned. Replace \"64x64\" in the image path with these alternative sizes: 16, 32, 64, 128, 200",
"example": "https://s2.coinmarketcap.com/static/img/coins/64x64/1.png"
},
"description": {
"type": "string",
"description": "A CoinMarketCap supplied brief description of this cryptocurrency. This field will return null if a description is not available.",
"example": "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."
},
"date_added": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when this cryptocurrency was added to CoinMarketCap.",
"example": "2013-04-28T00:00:00.000Z"
},
"date_launched": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when this cryptocurrency was launched.",
"example": "2013-04-28T00:00:00.000Z"
},
"notice": {
"type": "string",
"description": "A [Markdown](https://commonmark.org/help/) formatted notice that may highlight a significant event or condition that is impacting the cryptocurrency or how it is displayed, otherwise null. A notice may highlight a recent or upcoming mainnet swap, symbol change, exploit event, or known issue with a particular exchange or market, for example. If present, this notice is also displayed in an alert banner at the top of the cryptocurrency's page on coinmarketcap.com."
},
"tags": {
"anyOf": [
{
"$ref": "#/components/schemas/tags_1"
},
{
"type": "null"
}
]
},
"platform": {
"$ref": "#/components/schemas/platform"
},
"self_reported_circulating_supply": {
"type": [
"number",
"null"
],
"description": "The self reported number of coins circulating for this cryptocurrency.",
"example": 16950100
},
"self_reported_market_cap": {
"type": [
"number",
"null"
],
"description": "The self reported market cap for this cryptocurrency.",
"example": 16950100
},
"self_reported_tags": {
"$ref": "#/components/schemas/self_reported_tags"
},
"infinite_supply": {
"type": "boolean",
"description": "The cryptocurrency is known to have an infinite supply.",
"example": false
},
"urls": {
"$ref": "#/components/schemas/Cryptocurrencies_Info_-_URLs_object"
},
"subreddit": {
"type": "string",
"description": "Name of the project's subreddit, if any."
},
"twitter_username": {
"type": "string",
"description": "The project's X (Twitter) username, if any."
},
"tag-names": {
"type": [
"array",
"null"
],
"description": "Names of the tags in `tags`, in the same order.",
"items": {
"type": "string"
}
},
"tag-groups": {
"type": [
"array",
"null"
],
"description": "Group of each tag in `tags`, in the same order. For example `ALGORITHM`, `CATEGORY` or `PLATFORM`.",
"items": {
"type": "string"
}
},
"contract_address": {
"type": "array",
"description": "Contract addresses of this cryptocurrency on each platform it is deployed on.",
"items": {
"type": "object",
"properties": {
"contract_address": {
"type": "string",
"description": "Token contract address on this platform."
},
"platform": {
"type": "object",
"description": "The platform this contract address belongs to.",
"properties": {
"name": {
"type": "string",
"description": "Platform name."
},
"coin": {
"type": "object",
"description": "The platform's native cryptocurrency.",
"properties": {
"id": {
"type": "string",
"description": "CoinMarketCap ID of the platform's native cryptocurrency."
},
"name": {
"type": "string",
"description": "Name of the platform's native cryptocurrency."
},
"symbol": {
"type": "string",
"description": "Symbol of the platform's native cryptocurrency."
},
"slug": {
"type": "string",
"description": "URL-friendly slug of the platform's native cryptocurrency."
}
}
}
}
}
}
}
}
},
"required": [
"id",
"name",
"symbol",
"category",
"slug",
"logo",
"description",
"date_added",
"tags",
"platform",
"urls"
]
},
"Cryptocurrency_Info_-_Results_map": {
"type": "object",
"description": "Results of your query returned as an object map.",
"example": {
"1": {
"urls": {
"website": [
"https://bitcoin.org/"
],
"technical_doc": [
"https://bitcoin.org/bitcoin.pdf"
],
"twitter": [],
"reddit": [
"https://reddit.com/r/bitcoin"
],
"message_board": [
"https://bitcointalk.org"
],
"announcement": [],
"chat": [],
"explorer": [
"https://blockchain.coinmarketcap.com/chain/bitcoin",
"https://blockchain.info/",
"https://live.blockcypher.com/btc/"
],
"source_code": [
"https://github.com/bitcoin/"
]
},
"logo": "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"
}
},
"additionalProperties": {
"description": "On the v2 endpoint, requests by `symbol` return an array of objects for each symbol, because more than one cryptocurrency can share a symbol. Requests by `id` or `slug` return a single object.",
"oneOf": [
{
"$ref": "#/components/schemas/Cryptocurrencies_Info_-_Cryptocurrency_object._Please_note_this_will_be_wrapped_in_an_array_if_you_request_by_symbol_using_the_v2_endpoint."
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/Cryptocurrencies_Info_-_Cryptocurrency_object._Please_note_this_will_be_wrapped_in_an_array_if_you_request_by_symbol_using_the_v2_endpoint."
}
}
]
}
},
"Cryptocurrencies_Info_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Cryptocurrency_Info_-_Results_map"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Cryptocurrency_Map_-_Cryotocurrency_Object": {
"type": "object",
"description": "Cryptocurrency object for each result",
"properties": {
"id": {
"type": "integer",
"description": "The unique cryptocurrency ID for this cryptocurrency.",
"example": 1
},
"rank": {
"type": "number",
"description": "The rank of this cryptocurrency.",
"example": 1
},
"name": {
"type": "string",
"description": "The name of this cryptocurrency.",
"example": "Bitcoin"
},
"symbol": {
"type": "string",
"description": "The ticker symbol for this cryptocurrency, always in all caps.",
"example": "BTC"
},
"slug": {
"type": "string",
"description": "The web URL friendly shorthand version of this cryptocurrency name.",
"example": "bitcoin"
},
"is_active": {
"type": "integer",
"description": "1 if this cryptocurrency has at least 1 active market currently being tracked by the platform, otherwise 0. A value of 1 is analogous with `listing_status=active`.",
"example": 1,
"minimum": 0,
"maximum": 1
},
"status": {
"type": "string",
"description": "The listing status of the cryptocurrency. *This field is only returned if requested through the `aux` request parameter.*",
"example": "active",
"enum": [
"active",
"inactive",
"untracked"
]
},
"first_historical_data": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of the date this cryptocurrency was first available on the platform.",
"example": "2013-04-28T18:47:21.000Z"
},
"last_historical_data": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of the last time this cryptocurrency's market data was updated.",
"example": "2018-06-02T22:51:28.209Z"
},
"platform": {
"$ref": "#/components/schemas/platform"
}
},
"required": [
"id",
"rank",
"name",
"symbol",
"slug"
]
},
"Cryptocurrency_Map_-_Cryptocurrency_Array": {
"type": "array",
"description": "Array of cryptocurrency object results.",
"items": {
"$ref": "#/components/schemas/Cryptocurrency_Map_-_Cryotocurrency_Object"
}
},
"Cryptocurrency_Map_-_Response_Model": {
"type": "object",
"example": {
"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
}
},
"properties": {
"data": {
"$ref": "#/components/schemas/Cryptocurrency_Map_-_Cryptocurrency_Array"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Exchange_Map_-_Exchange_Object": {
"type": "object",
"description": "Exchange object description",
"properties": {
"id": {
"type": "integer",
"description": "The unique CoinMarketCap ID for this exchange.",
"example": 270
},
"name": {
"type": "string",
"description": "The name of this exchange.",
"example": "Binance"
},
"slug": {
"type": "string",
"description": "The web URL friendly shorthand version of this exchange name.",
"example": "binance"
},
"is_active": {
"type": "integer",
"description": "1 if this exchange is still being actively tracked and updated, otherwise 0.",
"example": 1,
"minimum": 0,
"maximum": 1
},
"status": {
"type": "string",
"description": "The listing status of the exchange. *This field is only returned if requested through the `aux` request parameter.*",
"example": "active",
"enum": [
"active",
"inactive",
"untracked"
]
},
"first_historical_data": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of the earliest market data record available to query using our historical endpoints. `null` if there is no historical data currently available for this exchange.",
"example": "2018-04-26T00:45:00.000Z"
},
"last_historical_data": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of the latest market data record available to query using our historical endpoints. `null` if there is no historical data currently available for this exchange.",
"example": "2019-06-02T21:25:00.000Z"
},
"is_listed": {
"type": "integer",
"description": "1 if this exchange is currently listed on CoinMarketCap, otherwise 0."
},
"is_redistributable": {
"type": "integer",
"description": "1 if this exchange's data can be redistributed, otherwise 0."
}
},
"required": [
"id",
"name",
"slug"
]
},
"Exchange_Map_-_Exchanges_Array": {
"type": "array",
"description": "Array of exchange object results.",
"items": {
"$ref": "#/components/schemas/Exchange_Map_-_Exchange_Object"
}
},
"Exchange_Map_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Exchange_Map_-_Exchanges_Array"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Tools_Price_Conversion_-_Quote_object": {
"type": "object",
"description": "A quote object for each conversion requested. The map key being the id/symbol used in the request.",
"properties": {
"price": {
"type": "number",
"description": "Converted price in terms of the quoted currency and historic time (if supplied).",
"example": 1235000
},
"last_updated": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when the destination currency's market value was recorded.",
"example": "2018-06-02T00:00:00.000Z"
}
},
"required": [
"price",
"last_updated"
]
},
"Tools_Price_Conversion_-_Quotes_map._Please_note_this_will_be_wrapped_in_an_array_if_you_request_by_symbol_using_the_v2_endpoint.": {
"type": "object",
"description": "An object map of price conversions.",
"additionalProperties": {
"$ref": "#/components/schemas/Tools_Price_Conversion_-_Quote_object"
}
},
"Tools_Price_Conversion_-_Results_Object": {
"type": "object",
"description": "Results object for your API call.",
"example": {
"symbol": "BTC",
"id": 1,
"name": "Bitcoin",
"amount": 50,
"last_updated": "2018-06-06T08:04:36.000Z",
"quote": {
"USD": {
"price": 284656.08465608465,
"last_updated": "2018-06-06T06:00:00.000Z"
}
}
},
"properties": {
"id": {
"type": "integer",
"description": "The unique CoinMarketCap ID for your base currency.",
"example": 1
},
"name": {
"type": "string",
"description": "The name of your base currency.",
"example": "Bitcoin"
},
"symbol": {
"type": "string",
"description": "The symbol for your base currency.",
"example": "BTC"
},
"amount": {
"type": "number",
"description": "Amount of base currency to convert from.",
"example": 50
},
"last_updated": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when the referenced market value of the base currency was recorded.",
"example": "2018-06-02T00:00:00.000Z"
},
"quote": {
"$ref": "#/components/schemas/Tools_Price_Conversion_-_Quotes_map._Please_note_this_will_be_wrapped_in_an_array_if_you_request_by_symbol_using_the_v2_endpoint."
}
},
"required": [
"id",
"name",
"symbol",
"amount",
"last_updated",
"quote"
]
},
"Tools_Price_Conversion_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Tools_Price_Conversion_-_Results_Object"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Fear_and_Greed_Historical_-_Fear_and_Greed_object": {
"type": "object",
"description": "Fear and Greed Historical",
"properties": {
"timestamp": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp of when this historical quote was recorded."
},
"value": {
"type": "integer",
"description": "The value of CMC Fear and Greed. \n\nWhen the value is closer to 0, the market is in Extreme Fear, and investors have over-sold irrationally.\n\nWhen the value is closer to 100, the market is in Extreme Greed, indicating a likely market correction."
},
"value_classification": {
"type": "string",
"description": "The value classication of CMC Fear and Greed. \n \n1 ≤ x < 20: Extreme Fear \n20 ≤ x < 40: Fear \n40 ≤ x < 60: Neutral \n60 ≤ x < 80: Greed \n80 ≤ x ≤ 100: Extreme Greed"
}
},
"required": [
"timestamp",
"value",
"value_classification"
]
},
"Fear_and_Greed_Historical_-_Results_map": {
"type": "array",
"description": "Fear and Greed Historical.",
"example": [
{
"timestamp": "1726617600",
"value": 38,
"value_classification": "Fear"
},
{
"timestamp": "1726531200",
"value": 34,
"value_classification": "Fear"
},
{
"timestamp": "1726444800",
"value": 36,
"value_classification": "Fear"
},
{
"timestamp": "1726358400",
"value": 38,
"value_classification": "Fear"
},
{
"timestamp": "1726272000",
"value": 38,
"value_classification": "Fear"
}
],
"items": {
"$ref": "#/components/schemas/Fear_and_Greed_Historical_-_Fear_and_Greed_object"
},
"required": [
"Fear and Greed Historical - Fear and Greed object"
]
},
"Fear_and_Greed_Historical_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Fear_and_Greed_Historical_-_Results_map"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Fear_and_Greed_Latest_-_Response_Object": {
"type": "object",
"description": "The latest CMC Fear and Greed value.",
"example": {
"value": 40,
"value_classification": "Neutral",
"update_time": "2024-09-19T02:54:56.017Z"
},
"properties": {
"value": {
"type": "integer",
"description": "The value of CMC Fear and Greed. \n\nWhen the value is closer to 0, the market is in Extreme Fear, and investors have over-sold irrationally. \n\nWhen the value is closer to 100, the market is in Extreme Greed, indicating a likely market correction.",
"minimum": 0,
"maximum": 100
},
"value_classification": {
"type": "string",
"description": "The value classication of CMC Fear and Greed. \n \n1 ≤ x < 20: Extreme Fear \n20 ≤ x < 40: Fear \n40 ≤ x < 60: Neutral \n60 ≤ x < 80: Greed \n80 ≤ x ≤ 100: Extreme Greed"
},
"update_time": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of the last time this record was updated."
}
},
"required": [
"value",
"value_classification",
"update_time"
]
},
"Fear_and_Greed_Latest_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Fear_and_Greed_Latest_-_Response_Object"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Global_Metrics_Quotes_Latest_-_Quote_object": {
"type": "object",
"description": "A market quote in the currency conversion option.",
"properties": {
"total_market_cap": {
"type": "number",
"description": "The sum of all individual cryptocurrency market capitalizations in the requested currency.",
"example": 250385096532.124
},
"total_volume_24h": {
"type": "number",
"description": "The sum of rolling 24 hour adjusted volume (as outlined in our methodology) for all cryptocurrencies in the requested currency.",
"example": 119270642406.968
},
"total_volume_24h_reported": {
"type": "number",
"description": "The sum of rolling 24 hour reported volume for all cryptocurrencies in the requested currency.",
"example": 1514905418.39087
},
"altcoin_volume_24h": {
"type": "number",
"description": "The sum of rolling 24 hour adjusted volume (as outlined in our methodology) for all cryptocurrencies excluding Bitcoin in the requested currency.",
"example": 119270642406.968
},
"altcoin_volume_24h_reported": {
"type": "number",
"description": "The sum of rolling 24 hour reported volume for all cryptocurrencies excluding Bitcoin in the requested currency.",
"example": 1514905418.39087
},
"altcoin_market_cap": {
"type": "number",
"description": "The sum of all individual cryptocurrency market capitalizations excluding Bitcoin in the requested currency.",
"example": 250385096532.124
},
"last_updated": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp (ISO 8601) of when the conversion currency's current value was referenced.",
"example": "2019-05-16T18:47:00.000Z"
},
"defi_volume_24h": {
"type": "number",
"description": "The sum of rolling 24 hour adjusted volume for all DeFi cryptocurrencies in the requested currency."
},
"defi_volume_24h_reported": {
"type": "number",
"description": "The sum of rolling 24 hour reported volume for all DeFi cryptocurrencies in the requested currency."
},
"defi_market_cap": {
"type": "number",
"description": "The sum of market caps for all DeFi cryptocurrencies in the requested currency."
},
"defi_24h_percentage_change": {
"type": "number",
"description": "Percentage change in 24 hour DeFi volume compared with the previous 24 hours."
},
"stablecoin_volume_24h": {
"type": "number",
"description": "The sum of rolling 24 hour adjusted volume for all stablecoins in the requested currency."
},
"stablecoin_volume_24h_reported": {
"type": "number",
"description": "The sum of rolling 24 hour reported volume for all stablecoins in the requested currency."
},
"stablecoin_market_cap": {
"type": "number",
"description": "The sum of market caps for all stablecoins in the requested currency."
},
"stablecoin_24h_percentage_change": {
"type": "number",
"description": "Percentage change in 24 hour stablecoin volume compared with the previous 24 hours."
},
"derivatives_volume_24h": {
"type": "number",
"description": "The sum of rolling 24 hour adjusted volume for all derivatives markets in the requested currency."
},
"derivatives_volume_24h_reported": {
"type": "number",
"description": "The sum of rolling 24 hour reported volume for all derivatives markets in the requested currency."
},
"derivatives_24h_percentage_change": {
"type": "number",
"description": "Percentage change in 24 hour derivatives volume compared with the previous 24 hours."
},
"total_market_cap_yesterday": {
"type": "number",
"description": "Total cryptocurrency market cap as of yesterday, in the requested currency."
},
"total_volume_24h_yesterday": {
"type": "number",
"description": "Total 24 hour volume as of yesterday, in the requested currency."
},
"total_market_cap_yesterday_percentage_change": {
"type": "number",
"description": "Percentage change in total market cap compared with yesterday."
},
"total_volume_24h_yesterday_percentage_change": {
"type": "number",
"description": "Percentage change in total 24 hour volume compared with yesterday."
}
},
"required": [
"total_market_cap",
"total_volume_24h",
"total_volume_24h_reported",
"altcoin_volume_24h",
"altcoin_volume_24h_reported",
"altcoin_market_cap",
"last_updated"
]
},
"Global_Metrics_Quotes_Latest_-_Quote_map": {
"type": "object",
"description": "A map of market quotes in different currency conversions. The default map included is USD.",
"example": {
"USD": {
"total_market_cap": 250284668020.67,
"total_volume_24h": 16903498628.86,
"total_volume_24h_reported": 16903498628.86,
"altcoin_volume_24h": 11883384723.14,
"altcoin_volume_24h_reported": 11883384723.14,
"altcoin_market_cap": 119597549931.01,
"last_updated": "2018-06-02T23:46:14.000Z"
}
},
"additionalProperties": {
"$ref": "#/components/schemas/Global_Metrics_Quotes_Latest_-_Quote_object"
}
},
"Global_Metrics_Quotes_Latest_-_Results_Object": {
"type": "object",
"description": "Results object for your API call.",
"properties": {
"btc_dominance": {
"type": "number",
"description": "Bitcoin's market dominance percentage by market cap.",
"example": 67.0057
},
"eth_dominance": {
"type": "number",
"description": "Ethereum's market dominance percentage by market cap.",
"example": 9.02205
},
"active_cryptocurrencies": {
"type": "number",
"description": "Count of active cryptocurrencies tracked by CoinMarketCap. This includes all cryptocurrencies with a `listing_status` of \"active\" or \"listed\" as returned from our /cryptocurrency/map call.",
"example": 2941
},
"total_cryptocurrencies": {
"type": "number",
"description": "Count of all cryptocurrencies tracked by CoinMarketCap. This includes \"inactive\" `listing_status` cryptocurrencies.",
"example": 4637
},
"active_market_pairs": {
"type": "number",
"description": "Count of active market pairs tracked by CoinMarketCap across all exchanges.",
"example": 21209
},
"active_exchanges": {
"type": "number",
"description": "Count of active exchanges tracked by CoinMarketCap. This includes all exchanges with a `listing_status` of \"active\" or \"listed\" as returned by our /exchange/map call.",
"example": 445
},
"total_exchanges": {
"type": "number",
"description": "Count of all exchanges tracked by CoinMarketCap. This includes \"inactive\" `listing_status` exchanges.",
"example": 677
},
"last_updated": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ",
"description": "Timestamp of when this record was last updated.",
"example": "2019-05-16T18:47:00.000Z"
},
"quote": {
"$ref": "#/components/schemas/Global_Metrics_Quotes_Latest_-_Quote_map"
},
"eth_dominance_yesterday": {
"type": "number",
"description": "Ethereum's market dominance percentage by market cap as of yesterday."
},
"btc_dominance_yesterday": {
"type": "number",
"description": "Bitcoin's market dominance percentage by market cap as of yesterday."
},
"eth_dominance_24h_percentage_change": {
"type": "number",
"description": "Change in Ethereum's market dominance since yesterday, in percentage points."
},
"btc_dominance_24h_percentage_change": {
"type": "number",
"description": "Change in Bitcoin's market dominance since yesterday, in percentage points."
},
"defi_volume_24h": {
"type": "number",
"description": "The sum of rolling 24 hour adjusted volume for all DeFi cryptocurrencies in USD."
},
"defi_volume_24h_reported": {
"type": "number",
"description": "The sum of rolling 24 hour reported volume for all DeFi cryptocurrencies in USD."
},
"defi_market_cap": {
"type": "number",
"description": "The sum of market caps for all DeFi cryptocurrencies in USD."
},
"defi_24h_percentage_change": {
"type": "number",
"description": "Percentage change in 24 hour DeFi volume compared with the previous 24 hours."
},
"stablecoin_volume_24h": {
"type": "number",
"description": "The sum of rolling 24 hour adjusted volume for all stablecoins in USD."
},
"stablecoin_volume_24h_reported": {
"type": "number",
"description": "The sum of rolling 24 hour reported volume for all stablecoins in USD."
},
"stablecoin_market_cap": {
"type": "number",
"description": "The sum of market caps for all stablecoins in USD."
},
"stablecoin_24h_percentage_change": {
"type": "number",
"description": "Percentage change in 24 hour stablecoin volume compared with the previous 24 hours."
},
"derivatives_volume_24h": {
"type": "number",
"description": "The sum of rolling 24 hour adjusted volume for all derivatives markets in USD."
},
"derivatives_volume_24h_reported": {
"type": "number",
"description": "The sum of rolling 24 hour reported volume for all derivatives markets in USD."
},
"derivatives_24h_percentage_change": {
"type": "number",
"description": "Percentage change in 24 hour derivatives volume compared with the previous 24 hours."
},
"total_crypto_dex_currencies": {
"type": "integer",
"description": "Total number of DEX tokens tracked by CoinMarketCap."
},
"today_incremental_crypto_number": {
"type": "integer",
"description": "Number of new cryptocurrencies and DEX tokens tracked so far today (UTC)."
},
"past_24h_incremental_crypto_number": {
"type": "integer",
"description": "Number of new cryptocurrencies and DEX tokens tracked in the past 24 hours."
},
"past_7d_incremental_crypto_number": {
"type": "integer",
"description": "Number of new cryptocurrencies and DEX tokens tracked in the past 7 days."
},
"past_30d_incremental_crypto_number": {
"type": "integer",
"description": "Number of new cryptocurrencies and DEX tokens tracked in the past 30 days."
},
"tracked_yearly_number": {
"type": "object",
"description": "The highest and lowest number of new cryptocurrencies and DEX tokens tracked in a single day over the past year.",
"properties": {
"maxIncrementalNumber": {
"type": "integer",
"description": "Highest number of new assets tracked in a single day."
},
"minIncrementalNumber": {
"type": "integer",
"description": "Lowest number of new assets tracked in a single day."
},
"maxIncrementalDate": {
"type": "string",
"description": "Date (ISO 8601) of the day with the highest number.",
"format": "date-time"
},
"minIncrementalDate": {
"type": "string",
"description": "Date (ISO 8601) of the day with the lowest number.",
"format": "date-time"
}
}
}
},
"required": [
"active_cryptocurrencies",
"total_cryptocurrencies",
"active_market_pairs",
"active_exchanges",
"total_exchanges",
"last_updated",
"quote"
]
},
"Global_Metrics_Quotes_Latest_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Global_Metrics_Quotes_Latest_-_Results_Object"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Altcoin_Season_Index_Latest_-_Response_Object": {
"type": "object",
"description": "Altcoin Season Index latest snapshot.",
"properties": {
"altcoin_index": {
"type": "integer",
"format": "int32",
"description": "Altcoin Season Index (0-100). Values above 75 indicate altcoin season; below 25 indicate Bitcoin season."
},
"altcoin_marketcap": {
"type": "number",
"description": "Altcoin market capitalization (USD)."
},
"snapshot_time": {
"type": "string",
"description": "Snapshot timestamp (ISO 8601)."
},
"yearly_high": {
"type": "integer",
"format": "int32",
"description": "Highest index value in the past year."
},
"yearly_high_date": {
"type": "string",
"description": "Date of yearly high (ISO 8601 date)."
},
"yearly_low": {
"type": "integer",
"format": "int32",
"description": "Lowest index value in the past year."
},
"yearly_low_date": {
"type": "string",
"description": "Date of yearly low (ISO 8601 date)."
}
},
"required": [
"altcoin_index",
"altcoin_marketcap",
"snapshot_time"
]
},
"Altcoin_Season_Index_Latest_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Altcoin_Season_Index_Latest_-_Response_Object"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
},
"Altcoin_Season_Index_Historical_-_Point_Object": {
"type": "object",
"description": "Single Altcoin Season Index sample in a historical series.",
"properties": {
"timestamp": {
"type": "string",
"description": "Sample time (ISO 8601)."
},
"altcoin_index": {
"type": "integer",
"format": "int32",
"description": "Altcoin Season Index value (0-100)."
},
"altcoin_marketcap": {
"type": "number",
"description": "Altcoin market capitalization at sample time (USD)."
}
},
"required": [
"timestamp",
"altcoin_index"
]
},
"Altcoin_Season_Index_Historical_-_Response_Object": {
"type": "object",
"description": "Altcoin Season Index historical series for a timeframe.",
"properties": {
"timeframe": {
"type": "string",
"description": "Requested timeframe (7d, 30d, or 90d)."
},
"points": {
"type": "array",
"description": "Historical points sorted by timestamp (oldest first).",
"items": {
"$ref": "#/components/schemas/Altcoin_Season_Index_Historical_-_Point_Object"
}
}
},
"required": [
"timeframe",
"points"
]
},
"Altcoin_Season_Index_Historical_-_Response_Model": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Altcoin_Season_Index_Historical_-_Response_Object"
},
"status": {
"$ref": "#/components/schemas/API_Status_Object"
}
},
"required": [
"data"
]
}
}
},
"x-tagGroups": [
{
"name": "Pro API",
"tags": [
"Cryptocurrency",
"Exchange",
"Global Metrics",
"CMC Index"
]
},
{
"name": "Dex API",
"tags": [
"Token",
"Platform",
"Holder",
"OHLCV"
]
},
{
"name": "Tools",
"tags": [
"Tools"
]
}
]
}