🆕Backtesting Data

Backtest your strategies against the same onchain intelligence that powers Nansen at any point in time.

The Nansen API introduces a new family of historical endpoints: point-in-time versions of our most-used endpoints. Pass any past date, and the API reconstructs holders, flows, PnL, screener results, and wallet state exactly as they appeared on that day, with the labels and prices that were valid at the time.

In short: you can now backtest. No look-ahead bias, no manual snapshotting, no rebuilding label history.

Why it matters

• Validate strategies before deploying capital. Replay any thesis, "buy when Smart Money accumulates," "exit when top holders concentrate", against real history.

• Audit and attribution. Show stakeholders, auditors, or LPs what a wallet, token, or cohort looked like on a specific date.

• Train and evaluate models. Generate clean training sets and out-of-sample test windows without leaking future information.

• Research and reporting. Quote on-chain facts as of any date, with full reproducibility.

What's available

⚠️ Beta notice. These are historical endpoints released under V1 Beta (/api/v1beta1/). Request shapes, response fields, and pricing may change as we iterate based on feedback.

All historical endpoints live under /api/v1beta1/ and follow the same conventions as the rest of the Nansen API.

Category	Endpoints	Use case
Token God Mode	tgm/historical-top-holders, tgm/historical-dex-trades, tgm/historical-who-bought-sold, tgm/historical-token-flow-summary, tgm/historical-pnl-leaderboard, tgm/historical-token-ohlcv, tgm/historical-token-quant-scores, tgm/historical-x-twitter-posts	Reconstruct a token's market structure, holder base, and trading activity on any past date.
Token Screener	token-screener/historical, token-screener/historical-perps	Re-run screeners as of a past date to test signal quality and ranking stability.
Smart Money	smart-money/historical-token-balances	See what Smart Money wallets held on any given day.
Profiler (Wallets)	profiler/address/historical-token-balances, profiler/address/historical-transactions, profiler/historical-transaction-lookup	Inspect any wallet's balances and transactions as they stood at a point in time.

Pricing

Historical endpoints cost 5× the credits of their real-time counterpart, reflecting the additional indexing required to serve point-in-time data.

Endpoint	Credits per call
tgm/historical-dex-trades	5
tgm/historical-who-bought-sold	5
tgm/historical-token-flow-summary	5
token-screener/historical	5
token-screener/historical-perps	5
profiler/address/historical-token-balances	5
profiler/address/historical-transactions	5
profiler/historical-transaction-lookup	5
tgm/historical-top-holders	25
tgm/historical-pnl-leaderboard	25
tgm/historical-token-quant-scores	25
smart-money/historical-token-balances	25

How to use them

All endpoints are POST, JSON-bodied, and authenticated with your API key in the apikey header — identical to every other Nansen API endpoint.

Each request carries a date "anchor":

• Snapshot endpoints take a single as_of_date (YYYY-MM-DD) — "show me the state on this day."

• Window endpoints take a date_from + as_of_date pair — "show me everything that happened between these two dates." ISO timestamps are accepted; date-only values are treated as UTC midnight.

Example: Top holders on a specific date

curl -X POST "https://api.nansen.ai/api/v1beta1/tgm/historical-top-holders" \
  -H "Content-Type: application/json" \
  -H "apikey: $NANSEN_API_KEY" \
  -d '{
    "chain": "ethereum",
    "token_address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
    "as_of_date": "2024-12-31",
    "label_type": "all",
    "pagination": {"page": 1, "per_page": 100}
  }'

Get started

• Base URL: https://api.nansen.ai

• Auth: apikey header

• Docs & schemas: the full OpenAPI specification covers every request and response field

• Beta status: these endpoints are in V1 Beta — schemas are stable, but we welcome feedback as we iterate

Already a Nansen API customer? Your existing key works against /api/v1beta1/ today. Reach out to your account contact for example notebooks, backtesting templates, and volume pricing.