Home / Blog / Data

Data

See Who Holds a Coin, and Why

For any coin, the FOMO API returns two things the chain cannot: the tracked traders who hold it, and the written theses explaining why. Together they turn a token address into a named, reasoned holder view.

A common ask in social trading is a single view of who holds a coin along with why they hold it. Traders want to open a token and see, in one place, the people in it and the reasoning behind their positions, instead of stitching that together from a block explorer and a dozen scattered posts.

The FOMO API returns both halves for any coin.

Who holds it

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

This returns the tracked FOMO traders who hold the token, each named, with their position: { handle, amount, valueUsd, priceUsd }. It is a smart-money holder list, not a column of anonymous addresses.

Why they hold it

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

This returns the theses traders wrote about that coin: the actual reasoning behind the trades, with the handle, the trader's equity in the position, and the trade size. It is the why that a raw holder list leaves out entirely.

The combined picture

Put the two together and a token stops being an address. It becomes a named group of holders, each with a stated reason for being there. You can see whether the people in a coin are traders with a track record, and you can read what they think is going to happen, straight from the person holding the bag.

That combination is the part the blockchain cannot give you. The chain shows the position. It does not show whose position it is, and it never shows why.

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

Can I see who holds a coin and their reasoning together?
Yes. GET /token/{address}/holders returns the named traders holding a coin, and GET /v2/thesis/token/{address} returns the theses they wrote about it.
What is in a holder record?
Each holder returns { handle, amount, valueUsd, priceUsd }, so you get the named trader and the size of their position.
What is a thesis?
The written reasoning a trader attached to a trade on a coin, including the trader's equity in the position and the trade size.
Is this affiliated with FOMO?
No. It is an independent, unofficial data layer for fomo.family and is not affiliated with FOMO.