Home / Blog / Data

Data

Who Actually Holds This Token? A Smart-Money Holder List

GET /token/{address}/holders returns which tracked FOMO traders hold a token, a named smart-money holder signal rather than an anonymous list of wallet addresses.

An on-chain holder list is a column of anonymous addresses. It tells you how many wallets hold a token, but not whether any of them are worth paying attention to. The question that actually matters is different: is smart money in this token?

The API answers it. Give it a token address and get back the tracked FOMO traders who hold it.

The endpoint

curl https://api.fomoapi.io/token/{address}/holders

Each holder comes back named, with their position:

  • handle: the FOMO trader holding it.
  • amount: how much they hold.
  • valueUsd: the position value in USD.
  • priceUsd: the current unit price.

Add ?limit=N to bound the list.

Why a named holder list is different

A raw holder list treats every wallet the same. This one does not. When a token shows up in the holdings of several ranked traders, that is a signal you cannot get from the chain alone, because the chain does not know which addresses belong to traders with a track record.

It also runs in the direction most tools do not. Most trader data goes from a trader to their holdings. This goes from a token back to the traders, so you can start with a token you are watching and see who is already in it.

FOMO API is an independent, unofficial data layer for fomo.family. It is not affiliated with FOMO.

Ship on verified trader data

Both-chain wallets, real PnL, and a realtime feed. One API.

Get an API key

FAQ

What does the token holders endpoint return?
GET /token/{address}/holders returns the tracked FOMO traders who hold that token, each with handle, amount, valueUsd, and priceUsd.
How is this different from an on-chain holder list?
An on-chain list is anonymous addresses. This one is named traders with track records, so you can see whether smart money is actually in a token.
Can I start from a token instead of a trader?
Yes. This endpoint goes from a token back to the traders who hold it, the reverse of most trader-data tools.
Is this affiliated with FOMO?
No. FOMO API is an independent, unofficial data layer for fomo.family and is not affiliated with FOMO.