Token Overview

tgm/flow-intelligence

post

This endpoint provides detailed analysis of token flows across different label segments during the selected time period such as smart money, whales, exchanges, etc.

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/tgm/flow-intelligence HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 142

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    }
  }
}

[
  {
    "tokenAddress": "text",
    "publicFigureFlow": "text",
    "prevPublicFigureFlow": "text",
    "publicFigureFlowChangePct": "text",
    "publicFigureWallets": "text",
    "publicFigureFlowGrade": "text",
    "topPnlFlow": "text",
    "prevTopPnlFlow": "text",
    "topPnlFlowChangePct": "text",
    "topPnlWallets": "text",
    "topPnlFlowGrade": "text",
    "whaleFlow": "text",
    "prevWhaleFlow": "text",
    "whaleFlowChangePct": "text",
    "whaleWallets": "text",
    "whaleFlowGrade": "text",
    "smartTraderFlow": "text",
    "prevSmartTraderFlow": "text",
    "smartTraderFlowChangePct": "text",
    "smartTraderWallets": "text",
    "smartTraderFlowGrade": "text",
    "exchangeFlow": "text",
    "prevExchangeFlow": "text",
    "exchangeFlowChangePct": "text",
    "exchangeWallets": "text",
    "exchangeFlowGrade": "text",
    "freshWalletsFlow": "text",
    "prevFreshWalletsFlow": "text",
    "freshWalletsFlowChangePct": "text",
    "freshWalletsWallets": "text",
    "freshWalletsFlowGrade": "text"
  }
]

tgm/who-bought-sold

post

This endpoint provides an aggregated summary of recent buyers and sellers on DEXs for a specific token. The parameter buy_or_sell decides if the endpoint should output aggregated data for buys or sells. The trades are then aggregated by address to compute the total trade volume in USD.

Parameters

Parameter	Type	Description
date_from	String	Datetime range start input.
date_to	String	Datetime range end input.
token_address	String	token address input
buy_or_sell	String	are we checking buys or sells

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/tgm/who-bought-sold HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 165

{
  "parameters": {
    "chain": "ethereum",
    "buyOrSell": "BUY",
    "timeRange": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  }
}

[
  {
    "address": "text",
    "addressLabel": "text",
    "isSmartMoney": "text",
    "boughtTokenVolume": "text",
    "soldTokenVolume": "text",
    "tokenTradeVolume": "text",
    "boughtVolumeUsd": "text",
    "soldVolumeUsd": "text",
    "tradeVolumeUsd": "text"
  }
]