MPPtempoquality 0.88

Comprehensive token metadata including market cap, volume, holders, and spot metrics via Nansen's blockchain analytics API.

Price
$0.01 / call
Protocol
mpp
Verified
no

What it does

The Nansen Token Information endpoint (`/api/v1/tgm/token-information`) returns comprehensive metadata for a given token on a specified blockchain. The response includes basic details (name, symbol, contract address, logo), token details (deployment date, social links, market cap, FDV, circulating and total supply), and spot trading metrics (total volume, buy/sell volume, unique buyers/sellers, liquidity, and total holders). The endpoint accepts a chain, token address, and timeframe parameter.

This endpoint is part of Nansen's broader API suite (v1, OpenAPI 3.1.0) which covers smart money analytics, wallet profiling, DEX trades, PnL analysis, prediction markets, perpetual trading, and token screening across 20+ chains. The token-information endpoint costs 1 credit (pro plan) or 10 credits (free plan) per call. It also supports x402 pay-per-request at $0.01 per call. The API uses API key authentication via the `apiKey` header and enforces per-second and per-minute rate limits. The endpoint returns HTTP 402 for unauthenticated callers, confirming it is live and operational via the MPP protocol.

Capabilities

token-metadatamarket-cap-lookuptrading-volumeholder-countfdv-lookupliquidity-dataspot-metricsmulti-chainsocial-linksdeployment-datex402-paymentapi-key-authrate-limited

Use cases

  • Retrieve market cap, FDV, and circulating supply for a token before making investment decisions
  • Build dashboards showing token trading metrics (volume, buys, sells, unique traders)
  • Enrich portfolio tracking tools with token logos, social links, and deployment dates
  • Screen tokens by liquidity and holder count across multiple chains
  • Power AI agents that need on-chain token context for research queries

Fit

Best for

  • Agents needing structured token metadata across 20+ blockchains
  • Portfolio and analytics dashboards requiring market cap, volume, and holder data
  • Research workflows that combine token fundamentals with smart money signals

Not for

  • Real-time sub-second price feeds (use dedicated price oracles instead)
  • Historical time-series token data (use the OHLCV or flows endpoints instead)
  • Non-crypto or traditional equity metadata

Quick start

curl -X POST https://api.nansen.ai/api/v1/tgm/token-information \
  -H 'Content-Type: application/json' \
  -H 'apiKey: YOUR_API_KEY' \
  -d '{
    "chain": "ethereum",
    "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
    "timeframe": "1d"
  }'

Example

Request

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

Response

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

Endpoint

Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.88/ 1.00

Full OpenAPI 3.1.0 schema with detailed request/response models, clear pricing ($0.01 via x402, 1 credit pro), and confirmed live 402 MPP challenge. Deducted slightly because no actual response sample was captured from the probe (only schema-level examples) and crawled docs pages returned 404s.

Warnings

  • No dedicated documentation pages were reachable (api.nansen.ai/docs returned 404); all information derived from OpenAPI spec.
  • Example response is constructed from schema examples, not a captured live response.

Citations

Provenance

Indexed frommpp_dev
Enriched2026-04-19 15:53:38Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access

Comprehensive token metadata including market cap, volume, holders, and spot metrics via Nansen's blockchain analytics API. — Clawmart · Clawmart