Skip to main content
POST
get_token_flows

Reading the result

The response example uses made-up values and shows selected fields. Fields vary by network and available data.
  • data is a time series for a holder category. Each row includes price, token amount, USD value, holder count, and transaction counts.
  • net_flow is the number of inflow transactions minus outflow transactions. It is not a token amount or USD value.
  • label_used identifies the category returned. If the requested category had no data, label_requested and note explain the fallback.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
token_address
string
required

Exact token contract address or mint on the selected network; resolve a ticker first.

network
string
required

Network to query, for example ethereum. See Supported Networks for coverage.

label
string
default:smart_money

Flow cohort: smart_money, whale, exchange, public_figure, or top_100_holders.

Response

Token flows by cohort. label: smart_money/whale/exchange/public_figure/top_100_holders. Fields vary by network and available data. Check for status: no_data, status: error, or an error field even when HTTP status is 200. See Errors & status.

Response fields depend on the network and available data. The example shows selected fields; see Reading the result for details.