🆕Nansen Indicators

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.

• Indicator scores are recomputed by a daily batch, so new activity is reflected at the next daily run rather than in real time.

Get Nansen Score Indicators

post

Get risk and reward indicators for a specific token.

Returns two groups of indicators:

• risk_indicators: Metrics for assessing token risk (btc-reflexivity, liquidity-risk, concentration-risk, token-supply-inflation)

• reward_indicators: Metrics for assessing alpha potential (chain-tvl, trading-range, price-momentum, chain-fees, protocol-fees, cex-flows, funding-rate)

Each indicator includes:

• score: Summary assessment ('low'/'medium'/'high' for risk, 'bearish'/'neutral'/'bullish' for reward)

• signal: Raw metric value

• signal_percentile: Percentile rank (0-100) vs tokens in same market cap group

• last_trigger_on: When the indicator last changed state

Authorizations

apikeystringRequired

API key for authentication

Body

Request model for TGM Indicators endpoint.

This endpoint provides risk and reward indicators for a specific token.

chainstring · enumRequired

Blockchain chain

Example: ethereumPossible values:

token_addressstringRequired

Token contract address

Example: 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9

Responses

200

Nansen score indicators 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

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/tgm/indicators

POST /api/v1/tgm/indicators HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "chain": "ethereum",
  "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
}

{
  "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
  "chain": "ethereum",
  "token_info": {
    "market_cap_usd": 1500000000,
    "market_cap_group": "largecap",
    "is_stablecoin": false
  },
  "risk_indicators": [
    {
      "indicator_type": "btc-reflexivity",
      "score": "bullish",
      "signal": 0.75,
      "signal_percentile": 85.5,
      "last_trigger_on": "2025-01-15"
    }
  ],
  "reward_indicators": [
    {
      "indicator_type": "btc-reflexivity",
      "score": "bullish",
      "signal": 0.75,
      "signal_percentile": 85.5,
      "last_trigger_on": "2025-01-15"
    }
  ]
}