CoinMarketCapCoinMarketCap
PricingAPI StatusGet API Key

© 2026 CoinMarketCap. All rights reserved.

xgithub
  • Overview
  • API Reference
  • AI Agent Hub
  • Changelog
  • FAQ
Choose an Endpoint
Market Data
    Cryptocurrency
    Exchange
    Global Metrics
    Content
    Community
    CMC Index
    Others
DEX Data
    Token
    Platform
    Holder
    OHLCV
      Get K-line pointsgetGet K-line candlesget
Utilities
    CoinMarketCap ID MapgetKey InfogetPostman Conversion v1getPrice Conversion v2get
Legacy
CoinMarketCap Cryptocurrency API Documentation
CoinMarketCap Cryptocurrency API Documentation

OHLCV

Endpointhttps://pro-api.coinmarketcap.com
K-line candlestick and OHLCV price data for DEX pairs. This category includes 2 endpoints:
  • /v1/k-line/points - Get K-line Points
  • /v1/k-line/candles - Get K-line Candles

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

​array[]
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

​array[]
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

HolderTools