Flows

Get TGM Flows Data

post

Analyze aggregated token flows by holder category over time. Shows hourly snapshots of balances, inflows, and outflows for specific holder groups: smart money, public figures, whales, and exchanges.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for TGM flows endpoint.

This endpoint provides comprehensive token flow analytics showing inflow and outflow patterns from various holder segments including Exchanges, Smart Money addresses, Public Figures, and Whales with time-based statistics and trends.

chainstring · enumRequired

Blockchain chain

Example: solanaPossible values:

token_addressstringRequired

Token address

Example: 2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv

labelstring · enumOptional

Label type for filtering flows

Default: top_100_holdersExample: smart_moneyPossible values:

filtersany ofOptional

Additional filters to apply to the query.

Example: {"price_usd":{"max":1000,"min":0.01},"value_usd":{"min":10000}}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering.

Examples:

• [{"field": "date", "direction": "DESC"}] - Sort by date descending (most recent first)
• [{"field": "total_inflows_usd", "direction": "ASC"}] - Sort by total inflows ascending
• [{"field": "total_outflows_usd", "direction": "DESC"}] - Sort by total outflows descending

Responses

200

TGM flows 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

/api/v1/tgm/flows

HTTPcURLJavaScriptPython

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

{
  "chain": "solana",
  "token_address": "2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv",
  "date": {
    "from": "2025-05-01",
    "to": "2025-05-03"
  },
  "label": "smart_money",
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "filters": {
    "price_usd": {
      "max": 1000,
      "min": 0.01
    },
    "value_usd": {
      "min": 10000
    }
  },
  "order_by": [
    {
      "field": "date",
      "direction": "ASC"
    }
  ]
}

{
  "data": [
    {
      "date": "text",
      "price_usd": 1,
      "token_amount": 1,
      "value_usd": 1,
      "holders_count": 1,
      "total_inflows_count": 1,
      "total_outflows_count": 1
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}

Using /flows Endpoint

The /flows endpoint allows you to analyze historical inflows and outflows of token holdings across specific wallet labels (e.g., Smart Money, Whales, Public Figures, etc.) on supported blockchains. This enables powerful workflows to investigate token accumulation or distribution trends by high-signal wallet groups over time.

This guide walks through how to use the endpoint in a workflow to explore Smart Money behavior for a given token on a given chain.

Usecase 1: Track Smart Money Accumulation Trends

This workflow helps you:

• Identify what tokens Smart Money is holding (e.g., via /holdings or /inflows)

• Investigate how inflows/outflows of Smart Money have evolved over time

• Combine historical activity with price trends for better decision-making

Step by Step Guide:

1. Start with /holdings endpoint to identify what tokens Smart Money is holding.

2. Pick a token of interest based on value and activity patterns.

3. Use the /flows endpoint with the token address and smart_money label to view inflow/outflow trends.

4. Specify timeframe (e.g., last 30 days) and examine how Smart Money behavior is evolving.

Usecase 2: Monitor Exchange Flows

This workflow helps you:

• Track how much of a token is being sent to or from exchange wallets

• Spot accumulation or distribution trends by observing net exchange flow

• Correlate token price movement with CEX behavior patterns

Step by Step Guide:

1. Identify the token of interest (e.g., USDC, ETH, SOL).

2. Choose the chain where it is active.

3. Use label: "exchange" to track exchange wallets.

4. Analyze net flows:

   • High inflow = Possible sell pressure

   • High outflow = Possible accumulation

5. Correlate flow data with price action or events (e.g., listings, unlocks, news).