For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Use case 6: Finding FOMO Traders

1. Scenario

Find the wallets that trade a token through the FOMO app, see how they trade it, and check whether a given wallet belongs to a FOMO user.

Nansen labels wallets that trade on the FOMO app with the trader's FOMO handle. Coverage includes Solana, Base and Robinhood, and grows as Nansen matches more wallets. These labels come through existing endpoints and fields. There is no FOMO-specific endpoint.

2. Solution

Use these endpoints. For what each call costs, see Credits & Pricing.

Endpoint
Label field
FOMO label returned

trader_address_label

By default

from_address_label, to_address_label

By default

address_label

By default

address_label

Only with "premium_labels": true

trader_address_label

Only with "premium_labels": true

label, category, kind

Always

In Token God Mode responses, the label looks like this. It can start with other emoji when the wallet has more labels, for example 🔧 👀 "SKXonchain" on FOMO [8dppJhzr].

👀 "iganu" on FOMO [2k3jk299]

Plan access: FOMO labels are premium labels.

  • In Token God Mode responses, only paid plans see them. On the Free plan, the label fields leave out the FOMO handle and show the wallet's other label, or an empty string if it has none.

  • "premium_labels": true on tgm/holders and tgm/pnl-leaderboard requires a paid plan. See Premium Labels Default Change.

  • profiler/address/premium-labels returns FOMO labels on every plan.

3. Step-by-Step Guide

The examples read your API key from the NANSEN_API_KEY environment variable. Set it before running them.

Step 1: Find FOMO traders on a token

Pass the pattern %on FOMO% to the label filter to return only FOMO traders. Label filters require a paid plan; on the Free plan the request returns HTTP 400.

Process the response:

  • Each row is one trade. trader_address is the wallet, and trader_address_label carries the FOMO handle.

  • Group by trader_address to get each FOMO trader's buys and sells.

The same pattern works on from_address_label and to_address_label in tgm/transfers, which also requires a paid plan for label filters.

Step 2: Rank FOMO traders by PnL

Add "premium_labels": true, then filter on trader_address_label:

To see which FOMO traders still hold the token, call tgm/holders with "premium_labels": true and "filters": {"address_label": "%on FOMO%"}. Leave out date: holders returns current balances, and a request with date fails with HTTP 422. Like tgm/pnl-leaderboard, it costs more with premium_labels.

Step 3: Check a single wallet

A FOMO wallet returns two labels:

Process the response: the wallet is a FOMO trader if any label has unique-identifier/fomo-trader in kind. Don't match on the label text. It is display text, and its format varies, for example with extra emoji.

4. Limits

  • profiler/address/premium-labels costs much more per call than the Token God Mode endpoints. Use it for single-wallet checks, and use the Token God Mode endpoints to find FOMO traders in bulk.

  • profiler/address/labels doesn't return FOMO labels.

  • On tgm/who-bought-sold, the address_label filter with %on FOMO% can time out on busy tokens. Fetch the rows without it and filter address_label in your own code.

Last updated

Was this helpful?