CoinMarketCapCoinMarketCap
PricingAPI StatusGet API Key
  • Overview
  • API Reference
  • AI Agent Hub
  • Changelog
  • FAQ
If you are an AI agent, LLM, or automated tool, this documentation provides clean Markdown versions of pages. Use the HTTP Link header for the exact Markdown alternate, append .md to documentation page URLs, or start from https://pro.coinmarketcap.com/llms.txt.

© 2026 CoinMarketCap. All rights reserved.

xgithub
Choose an EndpointTrial Pro API
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
    Fiat ID MapgetKey InfogetPostman Conversion v1getPrice Conversion v2get
Legacy
CoinMarketCap Cryptocurrency API Documentation
CoinMarketCap Cryptocurrency API Documentation

OHLCV

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
[ [ 0 ] ]
json
application/json

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
[ [ 0 ] ]
json
application/json

HolderTools