Token Overview

tgm/flow-intelligence

post

This model 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.

Authorizations

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
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "timeframe": "1d"
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "publicFigureFlow": "text",
    "publicFigureAvgAbsFlow": "text",
    "publicFigureWallets": "text",
    "topPnlFlow": "text",
    "topPnlAvgAbsFlow": "text",
    "topPnlWallets": "text",
    "whaleFlow": "text",
    "whaleAvgAbsFlow": "text",
    "whaleWallets": "text",
    "smartTraderFlow": "text",
    "smartTraderAvgAbsFlow": "text",
    "smartTraderWallets": "text",
    "exchangeFlow": "text",
    "exchangeAvgAbsFlow": "text",
    "exchangeWallets": "text",
    "freshWalletsFlow": "text",
    "freshWalletsAvgAbsFlow": "text",
    "freshWalletsWallets": "text"
  }
]

tgm/who-bought-sold

post

This model provides an aggregated summary of trade volumes in USD. addresses involved in DEX (Decentralized Exchange) trades for a specific token. The parameter buy_or_sell decides if the model should output aggregated data for buys or sells. The trades are then aggregated by address to compute the total trade volume in USD for each participating address. When user selects BUY, we only show the addresses whose net flow is positive and vice-versa for SELL. This model could answer the following questions:

Questions

1. Who are the top 5 addresses by trading volume in USD for a LDO token in the past 24 hours?

2. What are the addresses that have sold the most BLUR tokens in the past 7 days?

3. How has the 24-hour trading behavior of a specific address changed in terms of volume when trading a specific token?

4. Which addresses have bought the most PEPE tokens in the last 7 days?

Authorizations

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
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 210

{
  "parameters": {
    "chain": "ethereum",
    "buyOrSell": "BUY",
    "timeRange": {
      "from": "2025-05-01",
      "to": "2025-05-02"
    },
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

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