---
title: "Get \"Token God Mode\" (TGM) flow intelligence data"
method: POST
path: "/api/v1/tgm/flow-intelligence"
tags: ["Token God Mode"]
---

# Get "Token God Mode" (TGM) flow intelligence data

`POST /api/v1/tgm/flow-intelligence`

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.

## Request body

- TGMFlowIntelligenceRequest — 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.
  - `chain` 'arbitrum' | 'avalanche' | 'base' | 'bnb' | 'ethereum' | 'hyperevm' | 'injective' | 'linea' | 'mantle' | 'mantra' | 'monad' | 'near' | 'optimism' | 'plasma' | 'polygon' | 'robinhood' | 'sei' | 'solana' | 'sonic' | 'starknet' | 'sui' | 'ton' | 'tron', required — Chains supported for the TGM flow intelligence endpoint.
  - `token_address` string, required — Token address
  - `timeframe` '5m' | '1h' | '6h' | '12h' | '1d' | '7d' — TGM flow intelligence timeframe options.
  - `filters` TGMFlowIntelligenceFilters — Filters for TGM flow intelligence endpoint. These filters control the flow intelligence analysis data.
    - `public_figure_net_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `public_figure_avg_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `public_figure_wallet_count` IntegerRangeFilter — Filter for integer values with optional min/max bounds. Use for counts, numbers of items, and other whole number values. - Values between 5 and 100
      - `min` integer — Minimum value (inclusive)
      - `max` integer — Maximum value (inclusive)
    - `top_pnl_net_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `top_pnl_avg_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `top_pnl_wallet_count` IntegerRangeFilter — Filter for integer values with optional min/max bounds. Use for counts, numbers of items, and other whole number values. - Values between 5 and 100
      - `min` integer — Minimum value (inclusive)
      - `max` integer — Maximum value (inclusive)
    - `whale_net_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `whale_avg_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `whale_wallet_count` IntegerRangeFilter — Filter for integer values with optional min/max bounds. Use for counts, numbers of items, and other whole number values. - Values between 5 and 100
      - `min` integer — Minimum value (inclusive)
      - `max` integer — Maximum value (inclusive)
    - `smart_trader_net_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `smart_trader_avg_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `smart_trader_wallet_count` IntegerRangeFilter — Filter for integer values with optional min/max bounds. Use for counts, numbers of items, and other whole number values. - Values between 5 and 100
      - `min` integer — Minimum value (inclusive)
      - `max` integer — Maximum value (inclusive)
    - `exchange_net_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `exchange_avg_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `exchange_wallet_count` IntegerRangeFilter — Filter for integer values with optional min/max bounds. Use for counts, numbers of items, and other whole number values. - Values between 5 and 100
      - `min` integer — Minimum value (inclusive)
      - `max` integer — Maximum value (inclusive)
    - `fresh_wallets_net_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `fresh_wallets_avg_flow_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `fresh_wallets_wallet_count` IntegerRangeFilter — Filter for integer values with optional min/max bounds. Use for counts, numbers of items, and other whole number values. - Values between 5 and 100
      - `min` integer — Minimum value (inclusive)
      - `max` integer — Maximum value (inclusive)

## Response `200`

TGM flow intelligence data

- TGMFlowIntelligenceResponse — Response model for TGM flow-intelligence endpoint. Contains flow intelligence data with pagination and metadata.
  - `data` TGMFlowIntelligence[], required — List of TGM flow intelligence records
    - `public_figure_net_flow_usd` number — Net flow (USD) for addresses labeled as Public Figure
    - `public_figure_avg_flow_usd` number — Geometric mean of absolute flow for Public Figure addresses
    - `public_figure_wallet_count` integer — Unique wallet count for Public Figure addresses
    - `top_pnl_net_flow_usd` number — Net flow (USD) for addresses labeled as Top PnL
    - `top_pnl_avg_flow_usd` number — Geometric mean of absolute flow for Top PnL addresses
    - `top_pnl_wallet_count` integer — Unique wallet count for Top PnL addresses
    - `whale_net_flow_usd` number — Net flow (USD) for addresses labeled as Whale
    - `whale_avg_flow_usd` number — Geometric mean of absolute flow for Whale addresses
    - `whale_wallet_count` integer — Unique wallet count for Whale addresses
    - `smart_trader_net_flow_usd` number — Net flow (USD) for addresses labeled as Smart Trader
    - `smart_trader_avg_flow_usd` number — Geometric mean of absolute flow for Smart Trader addresses
    - `smart_trader_wallet_count` integer — Unique wallet count for Smart Trader addresses
    - `exchange_net_flow_usd` number — Net flow (USD) for addresses labeled as Exchange
    - `exchange_avg_flow_usd` number — Geometric mean of absolute flow for Exchange addresses
    - `exchange_wallet_count` integer — Always 0 — exchange wallet count is not tracked, even when exchange net flow is non-zero.
    - `fresh_wallets_net_flow_usd` number — Net flow (USD) for fresh wallets. Only available for 1d and 7d timeframes.
    - `fresh_wallets_avg_flow_usd` number — Average absolute flow (USD) for fresh wallets. Only available for 1d and 7d timeframes.
    - `fresh_wallets_wallet_count` integer — Always 0 for the 1d and 7d timeframes (null for shorter timeframes) — fresh wallet count is not tracked separately.
  - `warnings` string[] — Optional warnings about the query results. For example, if fresh_wallets fields are null due to timeframe constraints.

## Other responses

- `400` — Bad Request - Invalid request parameters or malformed request
- `401` — Authentication error - No API key found in request
- `402` — Payment Required - This endpoint supports pay-per-request via x402 and MPP. x402 responses advertise payment options in `Payment-Required`; MPP responses advertise a fresh `WWW-Authenticate: Payment ...` challenge. Successful MPP responses may include `Payment-Receipt`.
- `403` — Forbidden - User does not have required subscription tier or has exceeded credit limit
- `404` — Not Found - The requested resource was not found
- `422` — Validation error - Invalid request parameters
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/nansen/apis/nansen-api.md) · [All operations](https://skmtc.net/nansen/apis/nansen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nansen/nansen-api/revisions/02a4d2e7d827/schema)