MPPtempoquality 0.92

Token OHLCV candlestick data (open/high/low/close/volume) across 25+ chains via Nansen API, $0.01 per call.

Price
$0.01 / call
Protocol
mpp
Verified
no
Endpoint
https://api.nansen.ai/api/v1/tgm/token-ohlcv

What it does

This endpoint returns unified OHLCV (Open, High, Low, Close, Volume) candlestick data for tokens across 30+ supported blockchains including Ethereum, Solana, Base, Bitcoin, and many more. It supports multiple timeframes ranging from 1-minute to 1-month candles (1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M). Each candle includes price data (open/high/low/close), trading volume in both token units and USD, and market capitalization data. The date range defaults to the last 30 days if not specified.

The endpoint is part of Nansen's Token God Mode (TGM) suite and is accessed via POST to `/api/v1/tgm/token-ohlcv`. It requires a chain identifier and token contract address. Payment is supported via the x402 protocol at a fixed price of $0.01 per request, or through Nansen's credit system (10 credits on free tier, 1 credit on pro tier). Authentication is via an `apiKey` header. Rate limits are enforced per-second and per-minute, with remaining limits returned in response headers.

This endpoint unifies Nansen's legacy low-timeframe and high-timeframe price endpoints into a single interface. It is part of a broader Nansen API offering over 40 endpoints covering smart money tracking, wallet profiling, DEX trades, PnL analysis, prediction markets (Polymarket), perpetual positions (Hyperliquid), token screening, and AI research agents.

Capabilities

token-ohlcvmulti-chain-price-datacandlestick-datamarket-cap-trackingvolume-trackingmulti-timeframeblockchain-analyticsx402-payment

Use cases

  • —Fetch historical token price candles for charting and technical analysis
  • —Monitor real-time token volume and market cap changes across chains
  • —Build automated trading signals from multi-timeframe OHLCV data
  • —Backtest trading strategies using historical token price and volume data
  • —Track token price movements on newer chains like Base, Monad, or Sonic

Fit

Best for

  • —Agents and bots needing programmatic access to multi-chain token price history
  • —Quantitative researchers building cross-chain price models
  • —Dashboard builders displaying token charts with volume and market cap overlays

Not for

  • —Real-time sub-second tick data or order-book depth (this is candle-level data)
  • —Non-crypto price data (equities, forex, commodities)
  • —Free unlimited usage without payment (requires x402 payment or Nansen credits)

Quick start

curl -X POST https://api.nansen.ai/api/v1/tgm/token-ohlcv \
  -H 'Content-Type: application/json' \
  -H 'apiKey: YOUR_API_KEY' \
  -d '{
    "chain": "ethereum",
    "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
    "timeframe": "1d"
  }'

Example

Request

{
  "date": {
    "to": "2025-01-16T00:00:00Z",
    "from": "2025-01-15T00:00:00Z"
  },
  "chain": "ethereum",
  "timeframe": "1h",
  "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
}

Response

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

Endpoint

URLhttps://api.nansen.ai/api/v1/tgm/token-ohlcv
Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.92/ 1.00

Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.01 via x402), live 402 MPP challenge confirmed, and comprehensive endpoint documentation including supported chains, timeframes, and field descriptions. Minor gap: no actual 200 response was captured in the probe, but the schema is complete.

Warnings

  • —No crawled documentation pages were accessible beyond the API root health check; /docs returned 404. All information is derived from the OpenAPI spec.
  • —The MPP 402 challenge was confirmed live but the www_authenticate header was null — the endpoint may use x402 rather than standard MPP WWW-Authenticate flow.

Citations

Provenance

Indexed frommpp_dev
Enriched2026-04-19 15:55:27Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/4KUXRA