🆕Token Information

Data Freshness & Historical Coverage

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

• Returns current, point-in-time token metrics (no historical range); responses are cached for up to 5 minutes.

Get "Token God Mode" (TGM) token information data

post

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.

Authorizations

apikeystringRequired

API key for authentication

Body

Request model for TGM token information endpoint. This endpoint provides comprehensive token information including basic details, token details (deployment, social links, market metrics), and spot trading metrics.

chainstring · enumRequired

Blockchain chain

Example: ethereumPossible values:

token_addressstringRequired

Token address

Example: 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9

timeframestring · enumRequired

Timeframe for the token information query

Example: 1dPossible values:

Responses

200

TGM token information 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/token-information

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

{
  "chain": "ethereum",
  "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
  "timeframe": "1d"
}

{
  "data": {
    "name": "Aave",
    "symbol": "AAVE",
    "contract_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
    "logo": "https://assets.coingecko.com/coins/images/12645/large/AAVE.png",
    "token_details": {
      "token_deployment_date": "2020-11-05T00:00:00Z",
      "website": "https://aave.com",
      "x": "https://x.com/aave",
      "telegram": "https://t.me/Aavesome",
      "market_cap_usd": 4690000000,
      "fdv_usd": 4930000000,
      "circulating_supply": 15230000,
      "total_supply": 16000000
    },
    "spot_metrics": {
      "volume_total_usd": 8850000,
      "buy_volume_usd": 4520000,
      "sell_volume_usd": 4330000,
      "total_buys": 666,
      "total_sells": 499,
      "unique_buyers": 106,
      "unique_sellers": 132,
      "liquidity_usd": 153420000,
      "total_holders": 165299
    }
  }
}