Token Information

Get 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

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

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

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/api/v1/tgm/token-information

HTTPcURLJavaScriptPython

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
    }
  }
}