---
title: "Get Historical Token Quant Scores (Beta)"
method: POST
path: "/api/v1beta1/tgm/historical-token-quant-scores"
tags: ["Token God Mode"]
---

# Get Historical Token Quant Scores (Beta)

`POST /api/v1beta1/tgm/historical-token-quant-scores`

**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.

## Request body

- TgmHistoricalTokenQuantScoresRequest — 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_date` string, date, required — Date to query indicators for
  - `chain` 'arbitrum' | 'avalanche' | 'base' | 'bnb' | 'ethereum' | 'hyperevm' | 'hyperliquid' | 'injective' | 'iotaevm' | 'linea' | 'mantle' | 'mantra' | 'monad' | 'near' | 'optimism' | 'plasma' | 'polygon' | 'robinhood' | 'sei' | 'solana' | 'sonic' | 'starknet' | 'sui' | 'ton' | 'tron', required — Chains supported in TGM (Token God Mode) endpoints.
  - `token_address` string, required — Token contract address

## Response `200`

Historical token quant scores data

- TgmHistoricalTokenQuantScoresResponse — Response model for the historical token quant scores endpoint.
  - `data` TgmHistoricalTokenQuantScore[], required — List of token quant score indicators
    - `indicator_type` string, required — Indicator type identifier
    - `signal` number — Raw indicator signal value
    - `signal_percentile` number — Signal percentile vs same market cap group (0-100)
    - `score` string — Qualitative score label
    - `last_trigger_on` string, date-time — Timestamp of last signal trigger
    - `is_stablecoin` boolean — Whether the token is classified as a stablecoin
    - `market_cap_usd` number — Token market cap in USD at as_of_date
    - `market_cap_group` string — Market cap group used for percentile ranking
    - `model_type` string — Whether indicator measures risk or reward

## Other responses

- `400` — Bad Request - Invalid request parameters or malformed request
- `401` — Authentication error - No API key found in request
- `402` — Payment Required - This endpoint supports pay-per-request via x402 and MPP. x402 responses advertise payment options in `Payment-Required`; MPP responses advertise a fresh `WWW-Authenticate: Payment ...` challenge. Successful MPP responses may include `Payment-Receipt`.
- `403` — Forbidden - User does not have required subscription tier or has exceeded credit limit
- `404` — Not Found - The requested resource was not found
- `422` — Validation error - Invalid request parameters
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/nansen/apis/nansen-api.md) · [All operations](https://skmtc.dev/nansen/apis/nansen-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nansen/nansen-api/revisions/02a4d2e7d827/schema)