# Nansen Token Information (TGM)

> Nansen Token Information (TGM) is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP or x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns comprehensive token metadata, market metrics, and spot trading activity for a given token on a specified blockchain over a chosen timeframe.

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/tgm/token-information?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-12
- 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-token-information-b1666f90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0gQreooF0GgExw5Nb0yAm

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-token-information-b1666f90 -d '<json body>'
```

Example prompt: Pull the full Nansen Token God Mode profile for AAVE at contract 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 on Ethereum — give me the market cap, FDV, total liquidity, buy/sell volumes, unique traders, and holder count for the last 1 day.

## When to prefer this

Use this endpoint when you need a one-stop comprehensive snapshot of a token — combining metadata (name, symbol, logo, social links, deployment date), market positioning (market cap, FDV), and trading activity (volume, buys, sells, liquidity, holders) in a single call. Prefer this over separate metadata or volume endpoints when you need the full picture for token profiling, due diligence, or dashboard population across any of the 25 supported chains.

## Known failure modes

- Invalid or unsupported chain enum returns a validation error
- Token address not found on the specified chain returns empty or null data fields
- Unsupported timeframe enum value causes a 422 validation error
- Malformed token address (wrong format) triggers a bad request error
- No trading activity in the timeframe returns zero-value spot metrics
- Rate limiting or quota exceeded returns a 429 error

## How this service works

Get comprehensive token information including basic details (name, symbol, contract address, logo), token details (deployment date, social links, market metrics like market cap and FDV), and spot trading metrics (volume, buys/sells, unique traders, liquidity, holders).

This endpoint provides a complete overview of a token's metadata, market position, and trading activity for a specific date range.

## Output

A JSON object containing: token name, symbol, logo URL; token details such as deployment date, social links (Twitter/X, Telegram, website), market cap, and FDV; and spot trading metrics including total buy/sell transaction counts, buy/sell volumes in USD, total trading volume, liquidity in USD, unique buyer/seller counts, and total holder count — all scoped to the requested chain and timeframe.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMTokenInformationRequest",
 "required": [
  "chain",
  "token_address",
  "timeframe"
 ],
 "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."
  },
  "timeframe": {
   "enum": [
    "5m",
    "1h",
    "6h",
    "12h",
    "1d",
    "7d"
   ],
   "type": "string",
   "title": "TGMFlowIntelligenceTimeframe",
   "description": "TGM flow intelligence timeframe options."
  },
  "token_address": {
   "type": "string",
   "title": "Token Address",
   "examples": [
    "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
   ],
   "description": "Token address"
  }
 },
 "description": "Request model for TGM token information endpoint.\nThis endpoint provides comprehensive token information including basic details,\ntoken details (deployment, social links, market metrics), and spot trading metrics.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TGMTokenInformationResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "title": "TGMTokenInformation",
   "properties": {
    "logo": {
     "anyOf": [
      {
       "type": "string"
      }
     ],
     "title": "Logo",
     "examples": [
      "https://assets.coingecko.com/coins/images/12645/large/AAVE.png"
     ],
     "description": "Token logo URL"
    },
    "name": {
     "anyOf": [
      {
       "type": "string"
      }
     ],
     "title": "Name",
     "examples": [
      "Aave"
     ],
     "description": "Token name"
    },
    "symbol": {
     "anyOf": [
      {
       "type": "string"
      }
     ],
     "title": "Symbol",
     "examples": [
      "AAVE"
     ],
     "description": "Token symbol"
    },
    "spot_metrics": {
     "anyOf": [
      {
       "type": "object",
       "title": "SpotMetrics",
       "properties": {
        "total_buys": {
         "anyOf": [
          {
           "type": "integer"
          }
         ],
         "title": "Total Buys",
         "examples": [
          666
         ],
         "description": "Total number of buy transactions"
        },
        "total_sells": {
         "anyOf": [
          {
           "type": "integer"
          }
         ],
         "title": "Total Sells",
         "examples": [
          499
         ],
         "description": "Total number of sell transactions"
        },
        "liquidity_usd": {
         "anyOf": [
          {
           "type": "number"
          }
         ],
         "title": "Liquidity Usd",
         "examples": [
          153420000
         ],
         "description": "Liquidity in USD"
        },
        "total_holders": {
         "anyOf": [
          {
           "type": "integer"
          }
         ],
         "title": "Total Holders",
         "examples": [
          165299
         ],
         "description": "Total number of token holders"
        },
        "unique_buyers": {
         "anyOf": [
          {
           "type": "integer"
          }
         ],
         "title": "Unique Buyers",
         "examples": [
          106
         ],
         "description": "Number of unique buyers"
        },
        "buy_volume_usd": {
         "anyOf": [
          {
           "type": "number"
          }
         ],
         "title": "Buy Volume Usd",
         "examples": [
          4520000
         ],
         "description": "Total buy volume in USD"
        },
        "u
… (truncated)
```

## More

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