CoinMarketCapCoinMarketCap
PricingAPI StatusGet an API Key

© 2026 CoinMarketCap. All rights reserved.

xgithub
  • Guides
  • Pro API References
  • AI Tools
  • Changelog
  • FAQ
Endpoint Overview
Pro API
    Cryptocurrency
    Exchange
    Global Metrics
    Content
    Community
    CMC Index
Dex API
    Token
    Platform
    Holder
    OHLCV
      OHLCV LatestgetOHLCV HistoricalgetGet K-line pointsgetGet K-line candlesget
    Others
Tools
    CoinMarketCap ID MapgetKey InfogetPostman Conversion v1getPrice Conversion v2get
Deprecated
    Metadata v1 (deprecated)getPrice Conversion v1 (deprecated)getMarket Pairs Latest v1 (deprecated)getOHLCV Historical v1 (deprecated)getOHLCV Latest v1 (deprecated)getPrice Performance Stats v1 (deprecated)getQuotes Historical v1 (deprecated)getQuotes Latest v1 (deprecated)getFCAS Listings Latest (deprecated)getFCAS Quotes Latest (deprecated)get
CoinMarketCap Cryptocurrency API Documentation
CoinMarketCap Cryptocurrency API Documentation

OHLCV

Endpointhttps://pro-api.coinmarketcap.com

K-line candlestick and OHLCV price data for DEX pairs.


OHLCV Latest

GET
https://pro-api.coinmarketcap.com
/v4/dex/pairs/ohlcv/latest

Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more spot pairs for the current UTC day. Since the current UTC day is still active these values are updated frequently. You can find the final calculated OHLCV values for the last completed UTC day along with all historic days using /dex/pairs/ohlcv/historical.

OHLCV Latest › query Parameters

contract_address
​string

One or more comma-separated contract addresses.

network_id
​string

One or more CoinMarketCap cryptocurrency network ids

network_slug
​string

Alternatively, one network names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens).

aux
​string

Default:"" Valid values: "pool_created" "percent_pooled_base_asset" "num_transactions_24h" "pool_base_asset" "pool_quote_asset" "24h_volume_quote_asset" "total_supply_quote_asset" "total_supply_base_asset" "holders" "buy_tax" "sell_tax" "security_scan" "24h_no_of_buys" "24h_no_of_sells" "24h_buy_volume" "24h_sell_volume" Optionally specify a comma-separated list of supplemental data fields to return.

convert_id
​string

Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.

skip_invalid
​string

Pass true to relax request validation rules. When requesting records on multiple spot pairs an error is returned if no match is found for 1 or more requested spot pairs. If set to true, invalid lookups will be skipped allowing valid spot pairs to still be returned.

reverse_order
​string

Pass true to invert the order of a spot pair. For example, a trading pair is set up as Token B/Token A in the contract and is commonly referred to as Token A/Token B. Using reverse_order would change the order to reflect the true Token B/Token A pairing as it exists in the pool.

OHLCV Latest › Headers

X-CMC_PRO_API_KEY
​string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

OHLCV Latest › Responses

200

OK

No data returned
GET/v4/dex/pairs/ohlcv/latest
curl --request GET \ --url https://pro-api.coinmarketcap.com/v4/dex/pairs/ohlcv/latest \ --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY'
shell
Example Responses
No example specified for this content type
application/octet-stream

OHLCV Historical

GET
https://pro-api.coinmarketcap.com
/v4/dex/pairs/ohlcv/historical

Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any spot pairs using time interval parameters.

OHLCV Historical › query Parameters

contract_address
​string

One contract address. Example:"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640". If network/dex/base asset/quote asset information is passed, contract address cannot be passed. Note: contract_address is case sensitive for all non-EVM chains and not case sensitive for all EVM chains. EVM chains contract address addresses begin with 0x, and are followed by 40 alphanumeric characters(numerals and letters)

network_id
​string

One or more CoinMarketCap cryptocurrency network ids

network_slug
​string

Alternatively, one network names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens).

time_period
​string

Default:"daily" Valid values: "daily" "hourly" "1m" "5m" "15m" "4h" Time period to return OHLCV data for. If hourly, the open will be 01:00 and the close will be 01:59. If daily, the open will be 00:00:00 for the day and close will be 23:59:99 for the same day. See the main endpoint description for details.

Default: daily
time_start
​string

Timestamp (Unix or ISO 8601) to start returning OHLCV time periods for. Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time.

time_end
​string

Timestamp (Unix or ISO 8601) to stop returning OHLCV time periods for (inclusive). Optional, if not passed we'll default to the current time. Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time.

count
​string

Optionally limit the number of time periods to return results for. The default is 10 items. The current query limit is 500 items.

Default: 10
interval
​string

Default:"daily" Valid values: "1m" "5m" "15m" "30m" "1h" "4h" "8h" "12h" "daily" "weekly" "monthly" Optionally adjust the interval that "time_period" is sampled. For example with interval=monthly&time_period=daily you will see a daily OHLCV record for January, February, March and so on. See main endpoint description for available options.

Default: daily
aux
​string

Default:"" Valid values: "pool_created" "percent_pooled_base_asset" "num_transactions_24h" "pool_base_asset" "pool_quote_asset" "24h_volume_quote_asset" "total_supply_quote_asset" "total_supply_base_asset" "holders" "buy_tax" "sell_tax" "security_scan" "24h_no_of_buys" "24h_no_of_sells" "24h_buy_volume" "24h_sell_volume" Optionally specify a comma-separated list of supplemental data fields to return.

convert_id
​string

Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.

skip_invalid
​string

Pass true to relax request validation rules. When requesting records on multiple spot pairs an error is returned if no match is found for 1 or more requested spot pairs. If set to true, invalid lookups will be skipped allowing valid spot pairs to still be returned.

reverse_order
​string

Pass true to invert the order of a spot pair. For example, a trading pair is set up as Token B/Token A in the contract and is commonly referred to as Token A/Token B. Using reverse_order would change the order to reflect the true Token B/Token A pairing as it exists in the pool.

OHLCV Historical › Headers

X-CMC_PRO_API_KEY
​string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

OHLCV Historical › Responses

200

OK

No data returned
GET/v4/dex/pairs/ohlcv/historical
curl --request GET \ --url https://pro-api.coinmarketcap.com/v4/dex/pairs/ohlcv/historical \ --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY'
shell
Example Responses
No example specified for this content type
application/octet-stream

Get K-line points

GET
https://pro-api.coinmarketcap.com
/v1/k-line/points

Get K-line price points for a token.

Response Format: Each point is an array with 3 elements:

  • [0] price: Token price
  • [1] volume: Trading volume
  • [2] timestamp: UNIX timestamp (seconds)

Example: [[1.23, 50000, 1705363200], ...]

Get K-line points › query Parameters

platform
​string

Platform name or id

address
​string

Token or pool address

interval
​string

Kline interval: 1s/5s/30s/1min/3min/5min/15min/30min/1h/2h/4h/6h/8h/12h/1d/3d/1w/1m

from
​integer · int64

Start timestamp (UNIX epoch)

to
​integer · int64

End timestamp (UNIX epoch)

unit
​string

Kline unit: usd, native, quote

limit
​integer · int32

Number of points to load

pm
​string

Kline type: p (price), m (marketcap)

Get K-line points › Headers

X-CMC_PRO_API_KEY
​string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get K-line points › Responses

200

OK

No data returned
GET/v1/k-line/points
curl --request GET \ --url https://pro-api.coinmarketcap.com/v1/k-line/points \ --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY'
shell
Example Responses
No example specified for this content type

Get K-line candles

GET
https://pro-api.coinmarketcap.com
/v1/k-line/candles

Get K-line candle (OHLCV) data for a token.

Response Format: Each candle is an array with 7 elements:

  • [0] open: Opening price
  • [1] high: Highest price
  • [2] low: Lowest price
  • [3] close: Closing price
  • [4] volume: Trading volume
  • [5] timestamp: UNIX timestamp (seconds)
  • [6] traders: Number of unique traders

Example: [[1.23, 1.45, 1.20, 1.40, 50000, 1705363200, 128], ...]

Get K-line candles › query Parameters

platform
​string

Platform name or id

address
​string

Token or pool address

interval
​string

Kline interval: 1s/5s/30s/1min/3min/5min/15min/30min/1h/2h/4h/6h/8h/12h/1d/3d/1w/1m

from
​integer · int64

Start timestamp (UNIX epoch)

to
​integer · int64

End timestamp (UNIX epoch)

unit
​string

Kline unit: usd, native, quote

limit
​integer · int32

Number of candles to load

pm
​string

Kline type: p (price), m (marketcap)

Get K-line candles › Headers

X-CMC_PRO_API_KEY
​string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get K-line candles › Responses

200

OK

No data returned
GET/v1/k-line/candles
curl --request GET \ --url https://pro-api.coinmarketcap.com/v1/k-line/candles \ --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY'
shell
Example Responses
No example specified for this content type

HolderOthers