Data
A FOMO Trader's Live Portfolio, Including Perps
The balances endpoint returns a FOMO trader's live holdings with total portfolio value, plus perp PnL where FOMO exposes it, in a single call.
To copy a trader, or just to understand one, you need their current book: what they hold right now, how big it is, and whether they are running perps on top of spot. The API returns that in one call.
The endpoint
curl https://api.fomoapi.io/v2/users/{handle}/balances
You get the live holdings, each with the token, the amount, the unit price, the position value, and the 24h move. Alongside the holdings you get portfolio-level fields:
- totalValueUsd: the sum of the holdings, the size of the book.
- livePerpPnl and hyperliquidPerps: perp positions and their PnL, where FOMO exposes them.
What it is for
- Mirror positions. Read a trader's current holdings and match them.
- Size against reality. A position is easier to judge next to the total book it sits in. A large-looking buy is small if the portfolio is large.
- See the whole picture. Spot holdings alone miss perps. When they are present, you get both.
Pair it with the trade history at /v2/users/{handle}/trades and the leaderboard PnL, and you move from a single snapshot to a full view of how a trader is positioned.
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