# Nansen AI - Top Tokens by Nansen Score

> Nansen AI - Top Tokens by Nansen Score is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a ranked list of top-scoring tokens based on Nansen's Smart Money analytics, filterable by market cap category and result count.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/nansen-score/top-tokens
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-ai-top-tokens-by-nansen-score-d5492040
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1ylep6BfPDqMD4L1wphfo

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-ai-top-tokens-by-nansen-score-d5492040
```

Example prompt: Show me the top 20 large-cap tokens ranked by Nansen's Smart Money score right now.

## When to prefer this

Use this endpoint when you need a ranked leaderboard of tokens by Nansen Smart Money score, especially when filtering by market cap tier (low, mid, large). Prefer this over general token screeners when on-chain smart money signal quality is the primary ranking criterion.

## Known failure modes

- Invalid limit value outside 1-1000 range returns validation error
- Invalid market_cap_group value returns 400 bad request
- Payment not provided or insufficient returns 402 Payment Required
- API key or auth failure returns 401/403
- Rate limit exceeded returns 429

## How this service works

Get Nansen Score Top Tokens

## Output

A ranked list of up to 1000 tokens with their Nansen scores and associated metadata, filtered by the requested market cap group (lowcap, midcap, or largecap).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "NansenScoreTopTokensRequest",
 "properties": {
  "limit": {
   "type": "integer",
   "title": "Limit",
   "default": 25,
   "maximum": 1000,
   "minimum": 1,
   "examples": [
    25,
    50,
    10
   ],
   "description": "Maximum number of tokens to return (1-1000)"
  },
  "market_cap_group": {
   "anyOf": [
    {
     "enum": [
      "lowcap",
      "midcap",
      "largecap"
     ],
     "type": "string",
     "title": "MarketCapGroup",
     "description": "Enum for market cap groups."
    }
   ],
   "examples": [
    "largecap",
    "midcap",
    "lowcap"
   ],
   "description": "Filter by market cap category: lowcap (<100M), midcap (100M-1B), largecap (>1B)"
  }
 },
 "description": "Request model for Nansen Score Top Tokens endpoint.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "NansenScoreTopTokensResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "NansenScoreToken",
    "required": [
     "chain",
     "token_address",
     "performance_score",
     "risk_score",
     "price_momentum_performance",
     "chain_fees_performance",
     "trading_range_performance",
     "chain_tvl_performance",
     "protocol_fees_performance",
     "btc_reflexivity_risk",
     "liquidity_risk",
     "concentration_risk",
     "inflation_risk"
    ],
    "properties": {
     "chain": {
      "enum": [
       "arbitrum",
       "avalanche",
       "base",
       "bitcoin",
       "bnb",
       "chiliz",
       "ethereum",
       "hyperevm",
       "injective",
       "linea",
       "mantle",
       "mantra",
       "monad",
       "near",
       "optimism",
       "plasma",
       "polygon",
       "ronin",
       "scroll",
       "sei",
       "solana",
       "sonic",
       "stacks",
       "sui",
       "tron",
       "viction"
      ],
      "type": "string",
      "title": "NansenScoreTopTokensChain",
      "description": "Chains supported for the Nansen Score top-tokens endpoint."
     },
     "market_cap": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Market Cap",
      "examples": [
       1500000000,
       468266714
      ],
      "description": "Token market cap in USD (with FDV fallback)"
     },
     "risk_score": {
      "type": "integer",
      "title": "Risk Score",
      "examples": [
       70,
       40,
       10
      ],
      "description": "Safety score (-60 to +80). Sum of risk indicator contributions. Safety threshold: > 0"
     },
     "latest_date": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       }
      ],
      "title": "Latest Date",
      "examples": [
       "2025-12-16T00:00:00Z"
      ],
      "description": "Most recent calendar date for this token's indicators"
     },
     "token_symbol": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Token Symbol",
      "examples": [
       "ETH"
      ],
      "description": "Token ticker symbol"
     },
     "token_address": {
      "type": "string",
      "title": "Token Address",
      "examples": [
       "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
      ],
      "description": "Token contract address"
     },
     "inflation_risk": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-ai-top-tokens-by-nansen-score-d5492040/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)