# Nansen Historical Token Quant Scores

> Nansen Historical Token Quant Scores is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-16).

Returns historical quantitative scores for a specific token on a given chain as of a specified date, powered by Nansen's Smart Money analytics.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1beta1/tgm/historical-token-quant-scores
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-historical-token-quant-scores-950e22b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GRZ-nv1E29eoKIpOpD67P

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-historical-token-quant-scores-950e22b5
```

Example prompt: Pull up the Nansen historical quant scores for token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum as of 2024-11-01 — I want to see how it was scoring on Smart Money indicators back then.

## When to prefer this

Use this endpoint when you need point-in-time historical quantitative scores for a specific token, particularly when evaluating smart money signals, onchain health, or token quality for a past date. Prefer this over real-time endpoints when backtesting strategies or researching how a token was rated historically.

## Known failure modes

- Invalid or unsupported chain returns an error or empty result
- Token address not found or not tracked by Nansen returns no data
- Future or out-of-range as_of_date may return an error
- Missing required parameters (chain, token_address, as_of_date) returns a validation error
- Rate limiting or payment failure returns 402 or 429

## How this service works

Get Historical Token Quant Scores (Beta)

## Output

A set of quantitative scores and indicators for the specified token on the given chain as of the requested date, derived from Nansen's 500M+ labeled address dataset and Smart Money analytics — likely including momentum, holder quality, flow, and other onchain health metrics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TgmHistoricalTokenQuantScoresRequest",
 "required": [
  "as_of_date",
  "chain",
  "token_address"
 ],
 "properties": {
  "chain": {
   "enum": [
    "arbitrum",
    "avalanche",
    "base",
    "bnb",
    "ethereum",
    "hyperevm",
    "injective",
    "iotaevm",
    "linea",
    "mantle",
    "mantra",
    "monad",
    "near",
    "optimism",
    "plasma",
    "polygon",
    "ronin",
    "scroll",
    "sei",
    "solana",
    "sonic",
    "starknet",
    "sui",
    "ton",
    "tron"
   ],
   "type": "string",
   "title": "TGMChain",
   "description": "Chains supported in TGM (Token God Mode) endpoints."
  },
  "as_of_date": {
   "type": "string",
   "title": "As Of Date",
   "format": "date",
   "examples": [
    "2025-06-01"
   ],
   "description": "Date to query indicators for"
  },
  "token_address": {
   "type": "string",
   "title": "Token Address",
   "examples": [
    "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
   ],
   "description": "Token contract address"
  }
 },
 "description": "Request model for the historical token quant scores endpoint.\n\nReturns point-in-time Nansen Score indicators for a token anchored to as_of_date.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TgmHistoricalTokenQuantScoresResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "TgmHistoricalTokenQuantScore",
    "required": [
     "indicator_type"
    ],
    "properties": {
     "score": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Score",
      "examples": [
       "bullish"
      ],
      "description": "Qualitative score label"
     },
     "signal": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Signal",
      "examples": [
       0.75
      ],
      "description": "Raw indicator signal value"
     },
     "model_type": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Model Type",
      "examples": [
       "reward"
      ],
      "description": "Whether indicator measures risk or reward"
     },
     "is_stablecoin": {
      "anyOf": [
       {
        "type": "boolean"
       }
      ],
      "title": "Is Stablecoin",
      "examples": [
       false
      ],
      "description": "Whether the token is classified as a stablecoin"
     },
     "indicator_type": {
      "type": "string",
      "title": "Indicator Type",
      "examples": [
       "price-momentum"
      ],
      "description": "Indicator type identifier"
     },
     "market_cap_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Market Cap Usd",
      "examples": [
       500000000
      ],
      "description": "Token market cap in USD at as_of_date"
     },
     "last_trigger_on": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       }
      ],
      "title": "Last Trigger On",
      "examples": [
       "2025-05-28T00:00:00"
      ],
      "description": "Timestamp of last signal trigger"
     },
     "market_cap_group": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Market Cap Group",
      "examples": [
       "large"
      ],
      "description": "Market cap group used for percentile ranking"
     },
     "signal_percentile": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Signal Percentile",
      "examples": [
       82.5
      ],
      "description": "Signal percentile vs same market cap group (0-100)"
     }
    },
    "description": "Single token quant score indicator record for a gi
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-historical-token-quant-scores-950e22b5/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)