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
post
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
post
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",
    "boughtTokenVolume": "text",
    "soldTokenVolume": "text",
    "tokenTradeVolume": "text",
    "boughtVolumeUsd": "text",
    "soldVolumeUsd": "text",
    "tradeVolumeUsd": "text"
  }
]

Last updated

Was this helpful?