# Nansen Token Risk & Reward Indicators

> Nansen Token Risk & Reward Indicators is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.05/call, status unknown (last checked 2026-10-11).

Returns scored risk and reward indicators for a specific token on a given blockchain, including metrics like BTC reflexivity, liquidity risk, price momentum, and funding rate.

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/tgm/indicators?utm_source=zero.xyz
- Price: $0.05/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Nansen
- Docs: https://docs.nansen.ai
- Website: https://nansen.ai
- Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data
- Canonical page: https://www.zero.xyz/c/nansen-indicators-18347ec8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_awx564pmS_MytlLiboKe6

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-indicators-18347ec8 -d '<json body>'
```

Example prompt: Can you pull the Nansen risk and reward indicators for the token at 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 on Ethereum? I want to know if it's showing high liquidity risk, what the price momentum score looks like, and how it ranks against other tokens in its market cap group.

## When to prefer this

Use this endpoint when you need a holistic, multi-dimensional risk and reward assessment for a specific token rather than a single metric. Ideal for portfolio risk screening, alpha discovery, or comparing token health across market cap cohorts. Prefer over raw price feeds when you need contextualized, percentile-ranked signals.

## Known failure modes

- Unsupported chain returns 422 validation error
- Invalid or unrecognized token address returns empty or error response
- Token not tracked by Nansen may return null signal values
- Rate limiting or insufficient API credits returns 402 or 429
- Stablecoin tokens may have limited or less meaningful reward indicators

## How this service works

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

## Output

Returns a structured object with token metadata (market cap, market cap group, stablecoin flag) plus two arrays: risk_indicators (btc-reflexivity, liquidity-risk, concentration-risk, token-supply-inflation) and reward_indicators (chain-tvl, trading-range, price-momentum, chain-fees, protocol-fees, cex-flows, funding-rate). Each indicator includes a categorical score (low/medium/high for risk; bearish/neutral/bullish for reward), a raw signal value, a signal percentile vs tokens in the same market cap cohort, and the date the indicator last changed state.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMIndicatorsRequest",
 "required": [
  "chain",
  "token_address"
 ],
 "properties": {
  "chain": {
   "enum": [
    "arbitrum",
    "arc",
    "avalanche",
    "base",
    "bnb",
    "ethereum",
    "hyperevm",
    "hyperliquid",
    "injective",
    "iotaevm",
    "linea",
    "mantle",
    "mantra",
    "monad",
    "near",
    "optimism",
    "plasma",
    "polygon",
    "robinhood",
    "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/nansen-indicators-18347ec8/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)