The CoinGecko Pro API provides the same comprehensive cryptocurrency market data as the standard API but with enhanced performance, higher rate limits of up to 1,000 calls per minute, and faster data updates with prices cached every 30 seconds. It includes exclusive endpoints for advanced analytics, detailed market data, and historical granularity that are not available on the free Demo plan.
openapi: 3.1.0
info:
title: CoinGecko Pro API
description: >-
The CoinGecko Pro API provides the same comprehensive cryptocurrency
market data as the standard Demo API but with enhanced performance,
higher rate limits of up to 1,000 calls per minute, and faster data
updates with prices cached every 30 seconds. It includes exclusive
endpoints for advanced analytics, detailed market data, and historical
granularity that are not available on the free Demo plan. The Pro API
is designed for commercial use cases and comes with dedicated support
SLA and access to over 2 million token data points. This spec covers
the exclusive endpoints available only to paid plan subscribers.
version: '3.0.1'
contact:
name: CoinGecko Support
url: https://support.coingecko.com
termsOfService: https://www.coingecko.com/en/terms
externalDocs:
description: CoinGecko Pro API Documentation
url: https://docs.coingecko.com/reference/introduction
servers:
- url: https://pro-api.coingecko.com/api/v3
description: CoinGecko Pro API Server
tags:
- name: Coins
description: >-
Exclusive coin data endpoints for paid plan subscribers including
recently added coins, top gainers and losers, and circulating supply
chart data.
- name: Exchanges
description: >-
Exclusive exchange endpoints for paid plan subscribers including
extended volume chart data.
- name: Global
description: >-
Exclusive global market data endpoints for paid plan subscribers
including market cap chart data.
- name: NFTs
description: >-
Exclusive NFT endpoints for paid plan subscribers including NFT
market data and historical chart data.
- name: Token Lists
description: >-
Token list endpoints for paid plan subscribers providing
standardized token lists by asset platform.
security:
- proApiKeyHeader: []
- proApiKeyQuery: []
paths:
/coins/list/new:
get:
operationId: getNewlyAddedCoins
summary: Get recently added coins
description: >-
Get the list of the latest 200 coins that have been recently added
to CoinGecko. This endpoint is exclusive to paid plan subscribers.
tags:
- Coins
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: string
description: CoinGecko coin identifier
symbol:
type: string
description: Coin ticker symbol
name:
type: string
description: Coin display name
activated_at:
type: integer
description: UNIX timestamp when the coin was added
'401':
description: Unauthorized - invalid or missing Pro API key
'403':
description: Forbidden - endpoint not available on current plan
/coins/top_gainers_losers:
get:
operationId: getTopGainersLosers
summary: Get top gainers and losers
description: >-
Get the top 30 coins with the largest price gain and the top 30
coins with the largest price loss over a specified time duration.
This endpoint is exclusive to paid plan subscribers.
tags:
- Coins
parameters:
- name: vs_currency
in: query
required: true
description: The target currency for price data (e.g., usd)
schema:
type: string
default: usd
- name: duration
in: query
description: Time duration for price change calculation
schema:
type: string
enum:
- 1h
- 24h
- 7d
- 14d
- 30d
- 60d
- 1y
default: 24h
- name: top_coins
in: query
description: >-
Filter by top N coins by market cap (e.g., 300 to only
consider the top 300 coins)
schema:
type: string
enum:
- '300'
- '500'
- '1000'
- all
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
top_gainers:
type: array
description: Top coins by price increase
items:
$ref: '#/components/schemas/GainerLoser'
top_losers:
type: array
description: Top coins by price decrease
items:
$ref: '#/components/schemas/GainerLoser'
'401':
description: Unauthorized - invalid or missing Pro API key
'403':
description: Forbidden - endpoint not available on current plan
/coins/{id}/circulating_supply_chart:
get:
operationId: getCoinCirculatingSupplyChart
summary: Get coin circulating supply chart
description: >-
Get historical circulating supply chart data for a specific coin.
This endpoint is exclusive to paid plan subscribers.
tags:
- Coins
parameters:
- name: id
in: path
required: true
description: The CoinGecko coin ID
schema:
type: string
- name: days
in: query
required: true
description: Number of days of historical data
schema:
type: string
- name: interval
in: query
description: Data interval (daily)
schema:
type: string
enum:
- daily
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: array
description: Data point as [timestamp, circulating_supply]
items:
type: number
minItems: 2
maxItems: 2
'401':
description: Unauthorized - invalid or missing Pro API key
'404':
description: Coin not found
/coins/{id}/circulating_supply_chart/range:
get:
operationId: getCoinCirculatingSupplyChartRange
summary: Get coin circulating supply chart within date range
description: >-
Get historical circulating supply chart data for a specific coin
within a custom date range specified by UNIX timestamps. This
endpoint is exclusive to paid plan subscribers.
tags:
- Coins
parameters:
- name: id
in: path
required: true
description: The CoinGecko coin ID
schema:
type: string
- name: from
in: query
required: true
description: Start date as UNIX timestamp
schema:
type: number
- name: to
in: query
required: true
description: End date as UNIX timestamp
schema:
type: number
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: array
description: Data point as [timestamp, circulating_supply]
items:
type: number
minItems: 2
maxItems: 2
'401':
description: Unauthorized - invalid or missing Pro API key
'404':
description: Coin not found
/coins/{id}/total_supply_chart:
get:
operationId: getCoinTotalSupplyChart
summary: Get coin total supply chart
description: >-
Get historical total supply chart data for a specific coin. This
endpoint is exclusive to paid plan subscribers.
tags:
- Coins
parameters:
- name: id
in: path
required: true
description: The CoinGecko coin ID
schema:
type: string
- name: days
in: query
required: true
description: Number of days of historical data
schema:
type: string
- name: interval
in: query
description: Data interval (daily)
schema:
type: string
enum:
- daily
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: array
description: Data point as [timestamp, total_supply]
items:
type: number
minItems: 2
maxItems: 2
'401':
description: Unauthorized - invalid or missing Pro API key
'404':
description: Coin not found
/coins/{id}/total_supply_chart/range:
get:
operationId: getCoinTotalSupplyChartRange
summary: Get coin total supply chart within date range
description: >-
Get historical total supply chart data for a specific coin within
a custom date range specified by UNIX timestamps. This endpoint
is exclusive to paid plan subscribers.
tags:
- Coins
parameters:
- name: id
in: path
required: true
description: The CoinGecko coin ID
schema:
type: string
- name: from
in: query
required: true
description: Start date as UNIX timestamp
schema:
type: number
- name: to
in: query
required: true
description: End date as UNIX timestamp
schema:
type: number
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: array
description: Data point as [timestamp, total_supply]
items:
type: number
minItems: 2
maxItems: 2
'401':
description: Unauthorized - invalid or missing Pro API key
'404':
description: Coin not found
/nfts/markets:
get:
operationId: getNFTsMarkets
summary: List NFTs with market data
description: >-
Get the list of all supported NFT collections with floor price,
market cap, volume, and market-related data. This endpoint is
exclusive to paid plan subscribers.
tags:
- NFTs
parameters:
- name: order
in: query
description: Sort order for results
schema:
type: string
enum:
- h24_volume_usd_asc
- h24_volume_usd_desc
- h24_volume_native_asc
- h24_volume_native_desc
- floor_price_native_asc
- floor_price_native_desc
- market_cap_native_asc
- market_cap_native_desc
- market_cap_usd_asc
- market_cap_usd_desc
- name: per_page
in: query
description: Number of results per page (1-250)
schema:
type: integer
minimum: 1
maximum: 250
default: 100
- name: page
in: query
description: Page number for pagination
schema:
type: integer
default: 1
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: string
description: NFT collection identifier
contract_address:
type: string
description: Contract address
asset_platform_id:
type: string
description: Asset platform identifier
name:
type: string
description: Collection name
image:
type: object
properties:
small:
type: string
format: uri
description:
type: string
description: Collection description
native_currency:
type: string
description: Native currency
floor_price:
type: object
properties:
native_currency:
type: number
usd:
type: number
market_cap:
type: object
properties:
native_currency:
type: number
usd:
type: number
volume_24h:
type: object
properties:
native_currency:
type: number
usd:
type: number
floor_price_24h_percentage_change:
type: object
properties:
native_currency:
type: number
usd:
type: number
number_of_unique_addresses:
type: integer
description: Number of unique holder addresses
total_supply:
type: number
description: Total supply of NFTs
'401':
description: Unauthorized - invalid or missing Pro API key
'403':
description: Forbidden - endpoint not available on current plan
/nfts/{id}/market_chart:
get:
operationId: getNFTMarketChart
summary: Get NFT collection market chart
description: >-
Get historical market chart data for a specific NFT collection
including floor price, market cap, and volume data. This endpoint
is exclusive to paid plan subscribers.
tags:
- NFTs
parameters:
- name: id
in: path
required: true
description: The NFT collection ID
schema:
type: string
- name: days
in: query
required: true
description: Number of days of historical data
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
floor_price_usd:
type: array
description: Floor price data points
items:
type: array
items:
type: number
floor_price_native:
type: array
description: Floor price in native currency data points
items:
type: array
items:
type: number
market_cap_usd:
type: array
description: Market cap data points
items:
type: array
items:
type: number
h24_volume_usd:
type: array
description: 24h volume data points
items:
type: array
items:
type: number
h24_volume_native:
type: array
description: 24h volume in native currency data points
items:
type: array
items:
type: number
'401':
description: Unauthorized - invalid or missing Pro API key
'404':
description: NFT collection not found
/nfts/{asset_platform_id}/contract/{contract_address}/market_chart:
get:
operationId: getNFTContractMarketChart
summary: Get NFT market chart by contract address
description: >-
Get historical market chart data for a specific NFT collection by
contract address. This endpoint is exclusive to paid plan
subscribers.
tags:
- NFTs
parameters:
- name: asset_platform_id
in: path
required: true
description: The asset platform ID
schema:
type: string
- name: contract_address
in: path
required: true
description: The NFT contract address
schema:
type: string
- name: days
in: query
required: true
description: Number of days of historical data
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
floor_price_usd:
type: array
items:
type: array
items:
type: number
floor_price_native:
type: array
items:
type: array
items:
type: number
market_cap_usd:
type: array
items:
type: array
items:
type: number
h24_volume_usd:
type: array
items:
type: array
items:
type: number
h24_volume_native:
type: array
items:
type: array
items:
type: number
'401':
description: Unauthorized - invalid or missing Pro API key
'404':
description: NFT collection not found
/nfts/{id}/tickers:
get:
operationId: getNFTTickers
summary: Get NFT collection tickers
description: >-
Get the latest floor price and 24h volume tickers for a specific
NFT collection across different marketplaces. This endpoint is
exclusive to paid plan subscribers.
tags:
- NFTs
parameters:
- name: id
in: path
required: true
description: The NFT collection ID
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
tickers:
type: array
items:
type: object
properties:
floor_price_in_native_currency:
type: number
description: Floor price in native currency
h24_volume_in_native_currency:
type: number
description: 24h volume in native currency
native_currency:
type: string
description: Native currency symbol
native_currency_symbol:
type: string
description: Native currency display symbol
updated_at:
type: string
format: date-time
description: Last update timestamp
nft_marketplace_id:
type: string
description: NFT marketplace identifier
'401':
description: Unauthorized - invalid or missing Pro API key
'404':
description: NFT collection not found
/global/market_cap_chart:
get:
operationId: getGlobalMarketCapChart
summary: Get global market cap chart
description: >-
Get historical global market capitalization and volume chart data.
This endpoint is exclusive to paid plan subscribers.
tags:
- Global
parameters:
- name: days
in: query
required: true
description: Number of days of historical data
schema:
type: string
- name: vs_currency
in: query
description: The target currency for market cap data
schema:
type: string
default: usd
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
market_cap_chart:
type: object
properties:
market_cap:
type: array
description: Market cap data points as [timestamp, value]
items:
type: array
items:
type: number
volume:
type: array
description: Volume data points as [timestamp, value]
items:
type: array
items:
type: number
'401':
description: Unauthorized - invalid or missing Pro API key
'403':
description: Forbidden - endpoint not available on current plan
/token_lists/{asset_platform_id}/all.json:
get:
operationId: getTokenList
summary: Get token list by asset platform
description: >-
Get a standardized token list for a specific asset platform in the
Uniswap token list format. Includes token name, symbol, decimals,
and contract address. This endpoint is exclusive to paid plan
subscribers.
tags:
- Token Lists
parameters:
- name: asset_platform_id
in: path
required: true
description: The asset platform ID (e.g., ethereum)
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: Token list name
logoURI:
type: string
format: uri
description: Token list logo
keywords:
type: array
items:
type: string
timestamp:
type: string
format: date-time
description: Token list generation timestamp
tokens:
type: array
items:
type: object
properties:
chainId:
type: integer
description: Chain ID
address:
type: string
description: Token contract address
name:
type: string
description: Token name
symbol:
type: string
description: Token symbol
decimals:
type: integer
description: Token decimal places
logoURI:
type: string
format: uri
description: Token logo URL
'401':
description: Unauthorized - invalid or missing Pro API key
'403':
description: Forbidden - endpoint not available on current plan
/exchanges/{id}/volume_chart/range:
get:
operationId: getExchangeVolumeChartRange
summary: Get exchange volume chart within date range
description: >-
Get historical volume chart data for a specific exchange within
a custom date range specified by UNIX timestamps. This endpoint
is exclusive to paid plan subscribers.
tags:
- Exchanges
parameters:
- name: id
in: path
required: true
description: The exchange ID
schema:
type: string
- name: from
in: query
required: true
description: Start date as UNIX timestamp
schema:
type: number
- name: to
in: query
required: true
description: End date as UNIX timestamp
schema:
type: number
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: array
description: Volume data point as [timestamp, volume_in_btc]
items:
type: string
minItems: 2
maxItems: 2
'401':
description: Unauthorized - invalid or missing Pro API key
'404':
description: Exchange not found
components:
securitySchemes:
proApiKeyHeader:
type: apiKey
in: header
name: x-cg-pro-api-key
description: >-
CoinGecko Pro API key passed via request header. Obtain a paid
key from the CoinGecko developer dashboard.
proApiKeyQuery:
type: apiKey
in: query
name: x_cg_pro_api_key
description: >-
CoinGecko Pro API key passed via query string parameter.
schemas:
GainerLoser:
type: object
properties:
id:
type: string
description: CoinGecko coin identifier
symbol:
type: string
description: Coin ticker symbol
name:
type: string
description: Coin display name
image:
type: string
format: uri
description: Coin logo URL
market_cap_rank:
type: integer
description: Market cap ranking
usd:
type: number
description: Current price in USD
usd_24h_vol:
type: number
description: 24-hour trading volume in USD
usd_24h_change:
type: number
description: 24-hour price change percentage