Historical Token Quant Scores

Get Historical Token Quant Scores (Beta)

post

Beta — subject to breaking changes.

Point-in-time Nansen Score indicators for a token anchored to as_of_date.

Percentile rankings are computed across all tokens in the same market cap group at as_of_date, avoiding forward-looking bias.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for the historical token quant scores endpoint.

Returns point-in-time Nansen Score indicators for a token anchored to as_of_date.

as_of_datestring · dateRequired

Date to query indicators for

Example: 2025-06-01

chainstring · enumRequired

Blockchain chain

Example: ethereumPossible values:

token_addressstringRequired

Token contract address

Example: 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9

Responses

200

Historical token quant scores 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/v1beta1/tgm/historical-token-quant-scores

HTTPcURLJavaScriptPython

POST /api/v1beta1/tgm/historical-token-quant-scores HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "as_of_date": "2025-06-01",
  "chain": "ethereum",
  "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
}

{
  "data": [
    {
      "indicator_type": "price-momentum",
      "signal": 0.75,
      "signal_percentile": 82.5,
      "score": "bullish",
      "last_trigger_on": "2025-05-28T00:00:00",
      "is_stablecoin": false,
      "market_cap_usd": 500000000,
      "market_cap_group": "large",
      "model_type": "reward"
    }
  ]
}