# Nansen Score Indicators

> Nansen Score Indicators is a paid API for AI agents from api.nansen.ai, paid per call via MPP or x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns Nansen Score indicator data for token/wallet analytics via the Token God Mode (TGM) intelligence layer

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/tgm/indicators
- Price: $0.05/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-e5a4773e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7TCIyexIN8h88cgKW3Ief

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 api-nansen-ai-e5a4773e
```

Example prompt: Pull the Nansen Score indicators for token address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I want to see the smart money scoring signals and TGM intelligence data.

## When to prefer this

Choose this endpoint when you need Nansen's proprietary smart money scoring and TGM indicator signals for a specific token or wallet address. It is ideal for on-chain intelligence workflows requiring wallet labeling, smart money flow scores, and token-level Nansen analytics. Prefer this over raw blockchain data endpoints when you need curated institutional-grade scoring rather than raw transaction data.

## Known failure modes

- Invalid or malformed token/wallet address returns 400 error
- Unsupported blockchain network returns error or empty result
- Missing required POST body fields returns validation error
- Insufficient payment or x402 payment failure blocks the request
- Rate limiting returns 429 if too many requests
- Token not indexed by Nansen returns empty or null indicators

## How this service works

Get Nansen Score Indicators

## Output

Returns a set of Nansen Score indicator values derived from Token God Mode (TGM) data, including smart money flow signals, wallet quality scores, and on-chain intelligence metrics for the queried token or address.

## Example request

```json
{
 "chain": "ethereum",
 "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMIndicatorsRequest",
 "required": [
  "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."
  },
  "token_address": {
   "type": "string",
   "title": "Token Address",
   "examples": [
    "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
   ],
   "description": "Token contract address"
  }
 },
 "description": "Request model for TGM Indicators endpoint.\n\nThis endpoint provides risk and reward indicators for a specific token.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMIndicatorsResponse",
 "required": [
  "token_address",
  "chain",
  "token_info",
  "risk_indicators",
  "reward_indicators"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "title": "Chain",
   "examples": [
    "ethereum"
   ],
   "description": "Blockchain chain"
  },
  "token_info": {
   "type": "object",
   "title": "TGMIndicatorTokenInfo",
   "properties": {
    "is_stablecoin": {
     "anyOf": [
      {
       "type": "boolean"
      }
     ],
     "title": "Is Stablecoin",
     "examples": [
      false
     ],
     "description": "Flag indicating if token is a stablecoin"
    },
    "market_cap_usd": {
     "anyOf": [
      {
       "type": "number"
      }
     ],
     "title": "Market Cap Usd",
     "examples": [
      1500000000
     ],
     "description": "Market capitalization in USD"
    },
    "market_cap_group": {
     "anyOf": [
      {
       "type": "string"
      }
     ],
     "title": "Market Cap Group",
     "examples": [
      "largecap",
      "midcap",
      "lowcap"
     ],
     "description": "Market cap classification group"
    }
   },
   "description": "Token metadata from indicator data."
  },
  "token_address": {
   "type": "string",
   "title": "Token Address",
   "examples": [
    "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
   ],
   "description": "Token contract address"
  },
  "risk_indicators": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "TGMIndicator",
    "required": [
     "indicator_type"
    ],
    "properties": {
     "score": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Score",
      "examples": [
       "bullish",
       "high",
       "neutral",
       "low"
      ],
      "description": "Summary score (risk: low/medium/high, reward: bearish/neutral/bullish)"
     },
     "signal": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Signal",
      "examples": [
       0.75,
       -0.25
      ],
      "description": "The raw signal value for the indicator"
     },
     "indicator_type": {
      "type": "string",
      "title": "Indicator Type",
      "examples": [
       "btc-reflexivity",
       "liquidity-risk",
       "price-momentum"
      ],
      "description": "The type of indicator"
     },
     "last_trigger_on": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Last Trigger On",
      "examples": [
       "2025-01-15
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-e5a4773e/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)