🆕Price OHLCV

Get Token OHLCV Data

post

Get unified OHLCV (Open, High, Low, Close, Volume) data for tokens across supported chains.

This endpoint unifies the legacy TGM prices endpoints (/tgm/prices/low-timeframe and /tgm/prices/high-timeframe) into a single endpoint with support for multiple timeframes:

Low timeframes (sub-hourly): 1m, 5m, 15m, 30m, 1h High timeframes (multi-hour): 4h, 1d, 1w, 1M

Returns OHLCV candle data including:

• Price data: open, high, low, close prices

• Volume data: trading volume in token units and USD

• Market cap data: market capitalization at each time point

Date range defaults to the last 30 days if not specified.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for Token OHLCV endpoint.

This endpoint provides unified OHLCV (Open, High, Low, Close, Volume) data for tokens across supported chains with different time resolutions.

chainstring · enumRequired

Blockchain chain

Example: ethereumPossible values:

token_addressstringRequired

Token contract address

Example: 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9

date_rangeany ofOptional

Date range for the data (defaults to last 30 days if not specified)

timeframestring · enumRequired

Time resolution for OHLCV data

Example: 1hPossible values:

Responses

200

Token OHLCV data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/api/v1/tgm/token-ohlcv

HTTPcURLJavaScriptPython

POST /api/v1/tgm/token-ohlcv HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "chain": "ethereum",
  "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
  "date_range": {
    "start": "2025-01-01T00:00:00Z",
    "end": "2025-02-01T00:00:00Z"
  },
  "timeframe": "1h"
}

{
  "chain": "ethereum",
  "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
  "timeframe": "1h",
  "data": [
    {
      "interval_start": "2025-01-15T12:00:00Z",
      "open": 100.5,
      "high": 105.25,
      "low": 98.75,
      "close": 103,
      "volume": 1000000,
      "volume_usd": 100000000,
      "market_cap": {
        "open": 1500000000,
        "high": 1600000000,
        "low": 1400000000,
        "close": 1550000000
      }
    }
  ]
}