Flow Intelligence

Get TGM Flow Intelligence Data

post

This endpoint provides comprehensive flow intelligence analytics, including inflows, outflows, and net flows for a specific token, broken down by various holder segments (Exchanges, Smart Money, Public Figures, Whales) with time-based statistics and trends. It can be used for identifying accumulation/distribution patterns across different holder segments.

Authorizations

ApiKeyAuth

Body

application/json

Request model for TGM flow-intelligence endpoint.

This endpoint provides detailed token flow intelligence for analyzing token movements across different chains. It helps track and categorize token transfers, identifying patterns such as exchange deposits, withdrawals, and transfers between different types of wallets.

chainstring · enumRequired

Blockchain chain

Example: ethereumPossible values:

token_addressstringRequired

Token address

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

timeframestring · enumOptional

Time window for the flow intelligence data

Default: 1dPossible values:

filtersany ofOptional

Additional filters to apply to the query.

Example: {"whale_wallet_count":{"min":1}}

Responses

200

TGM flow intelligence data

application/json

400

Bad Request

application/json

401

Unauthorized

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

post

HTTPcURLJavaScriptPython

POST /api/v1/tgm/flow-intelligence HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "chain": "ethereum",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "timeframe": "1d",
  "filters": {
    "whale_wallet_count": {
      "min": 1
    }
  }
}

{
  "data": [
    {
      "public_figure_net_flow_usd": 1000000.5,
      "public_figure_avg_flow_usd": 50000.25,
      "public_figure_wallet_count": 10,
      "top_pnl_net_flow_usd": 2000000.75,
      "top_pnl_avg_flow_usd": 100000.5,
      "top_pnl_wallet_count": 15,
      "whale_net_flow_usd": 5000000.25,
      "whale_avg_flow_usd": 250000.75,
      "whale_wallet_count": 25,
      "smart_trader_net_flow_usd": 1500000.5,
      "smart_trader_avg_flow_usd": 75000.25,
      "smart_trader_wallet_count": 20,
      "exchange_net_flow_usd": 3000000.75,
      "exchange_avg_flow_usd": 150000.5,
      "exchange_wallet_count": 5,
      "fresh_wallets_net_flow_usd": 500000.25,
      "fresh_wallets_avg_flow_usd": 25000.75,
      "fresh_wallets_wallet_count": 100
    }
  ]
}