See who is buying or selling a token

Find out which addresses are buying or selling a token, how smart money, whales and exchanges are moving it, and who holds the most. Your agent answers with Nansen data.

Ask your agent

Copy one request into the agent you already use. Your agent asks you for the token’s contract address and chain first.

Nansen: net buyers and sellers

Ask me for a token's contract address and chain. Then show which addresses bought or sold the most of it over the last 7 days, with their net amounts, and say which period and chain the answer covers.

Nansen: flows by holder group

Ask me for a token's contract address and chain. Then show its inflows and outflows over the last 7 days for smart money, whales, exchanges and top holders, and tell me whether it is being accumulated.

Nansen: top holders

Ask me for a token's contract address and chain. Then list its top holders and their share of supply, and pass on any warnings that come with the data.

What your agent uses

flovia_endpoints finds the Nansen endpoint that fits the request.
flovia_nansen fetches the answer from Nansen: who bought or sold, flows by holder group, or top holders.

Use a source that appears in your agent’s current tool list. A source that is not listed is unavailable.

Example reply

The reply below is made up for illustration. Your replies carry your own values.

Net buyers and sellers of EXAMPLE on Base, over the last 7 days:

Address A bought a net 1,234,567 EXAMPLE.

Address B bought a net 234,567 EXAMPLE.

Address C, labeled as an exchange, sold a net 345,678 EXAMPLE.

This is one page of results for that period and chain. Data provided by Nansen.

Next steps

Look at one of these addresses with Check what a wallet holds before you send.
Add the price and market cap with Get a quick market summary.
See every request in Use cases. Free and paid use explains the free allowance and the purchased balance.

Anyone can create a Flovia account. If you have not connected yet, start with the Quickstart.