# Nansen Token God Mode Historical OHLCV

> Nansen Token God Mode Historical OHLCV is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns historical OHLCV (open, high, low, close, volume) price data for a token using Nansen's Token God Mode dataset, with configurable timeframes and optional blacklist filtering

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1beta1/tgm/historical-token-ohlcv
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-token-god-mode-historical-ohlcv-34faaaaa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ar3BaNqXjVm3RyzhBYeOo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-token-god-mode-historical-ohlcv-34faaaaa
```

Example prompt: Can you pull the historical Token God Mode OHLCV data for token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum with daily resolution starting from 2024-01-01 through 2024-06-30?

## When to prefer this

Use this endpoint when you need structured historical OHLCV candlestick data for a specific on-chain token, particularly when you want Nansen's curated Token God Mode dataset with optional blacklist filtering. Prefer this over generic price APIs when you need chain-specific data, support for Hyperliquid, or Nansen's smart-money data quality standards.

## Known failure modes

- Invalid or unsupported chain name returns an error
- Malformed token contract address returns a validation error
- Unsupported timeframe value returns an error
- date_from later than as_of_date results in empty or error response
- Token not found on specified chain returns empty result
- API key missing or invalid returns 401/403
- Hyperliquid chain requires coin symbol instead of contract address — passing an address will fail
- blacklist filter applied with non-daily/weekly timeframe returns an error

## How this service works

Get historical "Token God Mode" (TGM) token OHLCV (Beta)

## Output

A time-series array of OHLCV (open, high, low, close, volume) candlestick records for the specified token, filtered to the requested chain, date range, and timeframe resolution. Optionally excludes blacklisted tokens when the filter is enabled.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string"
  },
  "as_of_ts": {
   "type": "string"
  },
  "date_from": {
   "type": "string"
  },
  "timeframe": {
   "type": "string"
  },
  "as_of_date": {
   "type": "string"
  },
  "token_address": {
   "type": "string"
  },
  "apply_blacklist_filter": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-token-god-mode-historical-ohlcv-34faaaaa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)