A Coin's Top Holders and What They Think

By FOMO API · 2026-09-01 · Updated 2026-09-20 · 3 min read

Search a coin, list its top holders, read their theses, and check their track records, all in one short chain of real endpoints: /token/{address}/holders to /v2/thesis/token/{mint} to /v2/users/{handle}.

Pixel-art token ownership network highlighting connected wallets and a smart-money cluster.

Before you touch a coin, three questions matter: who holds it, why they hold it, and whether they are any good. The FOMO API answers all three in one short workflow. This is the exact chain of calls, starting from a symbol.

Find the coin

If you only have a ticker, resolve it to a contract address:

curl "https://api.fomoapi.io/v2/tokens/search?q=ANSEM" \
  -H "authorization: Bearer YOUR_API_KEY"

That returns {symbol, address, name, marketCapUsd, networkId}. Keep the address.

Who holds it

The holders endpoint lists which of the traders FOMO tracks hold the token, and how much:

curl "https://api.fomoapi.io/token/<address>/holders?limit=50" \
  -H "authorization: Bearer YOUR_API_KEY"

Each row is {handle, amount, valueUsd, priceUsd}. This is scoped to named FOMO traders, so it is a smart-money holder list rather than a raw dump of every wallet on chain. If a token has not been indexed yet you get available:false with a 200, not an error, so handle that case in code.

Why they hold it

For each notable holder, read the reasoning traders attached to this specific coin:

curl "https://api.fomoapi.io/v2/thesis/token/<address>?limit=25" \
  -H "authorization: Bearer YOUR_API_KEY"

Each thesis carries text, handle, tradeUsd, equity, likes, and replies. Reading several together tells you the narrative forming around the coin, in the traders' own words.

Whether they are any good

A conviction thesis from a wallet with no track record is noise. Resolve each holder's handle:

curl "https://api.fomoapi.io/v2/users/<handle>" \
  -H "authorization: Bearer YOUR_API_KEY"

You get wallets{solana,evm}, verified pnl:{24h,7d,30d,all}, trades, and accountAgeDays. Weight the theses by the track record behind them. Because every author carries their wallets, that weighting is based on a record you can check.

Put together: search the coin, list its holders, read their theses, check their records. To go the other direction and start from the wallets themselves, see Find the wallets that found the last 100x, or See who holds a coin, and why for the same idea framed as a narrative tool.

Get a free key at the dashboard and read the docs.

FOMO API is an independent, unofficial data layer for fomo.family. It is not affiliated with, endorsed by, or sponsored by FOMO or Robinhood.

Ship on fomo.family trader data

Both-chain wallets, PnL and holdings, plus two live streams: the app feed on every plan, the on-chain stream on Growth. One API.

Get an API key

FAQ

How do I see who holds a token and why?

Start from the token address (use GET /v2/tokens/search for a symbol). Call GET /token/{address}/holders for the tracked traders holding it, then GET /v2/thesis/token/{mint} for the theses written about that coin. Resolve each holder with GET /v2/users/{handle} to check their record.

What does the token holders endpoint return?

GET /token/{address}/holders returns which of the traders FOMO tracks hold the token, each as {handle, amount, valueUsd, priceUsd}. It is scoped to named FOMO traders, so it is a smart-money holder list, not every anonymous wallet. Un-indexed tokens return available:false with a 200.

What is in a token thesis?

GET /v2/thesis/token/{mint} returns theses about one coin, each carrying text, handle, tradeUsd, equity, likes, and replies. Read several together to see the narrative forming around the coin, written by the traders themselves.

How do I weight a thesis by the trader's skill?

Resolve the author's handle with GET /v2/users/{handle} and read pnl:{24h,7d,30d,all}, trades, and accountAgeDays. Because every thesis carries the author's wallets, you can weight it by a track record you can check rather than by how confident it sounds.

Is this affiliated with FOMO?

No. FOMO API is an independent, unofficial data layer for fomo.family and is not affiliated with, endorsed by, or sponsored by FOMO or Robinhood.