FomoRadar Get API key

Guide · 7 min read

Is there a fomo.family API? Getting trader data as JSON

fomo.family has no public API. How to get its leaderboards, trader PnL and verified wallet addresses as JSON, with curl, Python and JavaScript examples and what people build with it.

Updated · FomoRadar

fomo.family does not publish a public API. Its leaderboards and trader profiles live inside its app and its public pages, with no documented way to read them from code. If you want that data in a spreadsheet, a trading bot, a Telegram alert or your own research, you need another source. The FomoRadar API is one: an independent REST and WebSocket API built for exactly this data, run separately from fomo.family. This guide shows what it returns, how to make your first calls, and how people use it.

What you can get

  • Leaderboards for 24 hours, 7 days and 30 days, with ranks, rank changes, PnL, volume, trades and each trader's wallets.
  • Trader profiles by handle, one at a time or up to 100 per call, with PnL for every window and when each part was last checked.
  • Full wallet addresses for every trader, not only the top 10 the site shows, each labelled verified or likely.
  • Reverse lookup: the fomo.family trader behind any wallet address, one or up to 100 at a time.
  • A live trade stream over WebSocket: on-chain trades by the traders you follow, or by a leaderboard's top traders, as they happen.

Getting a key

Open the dashboard and sign in with Telegram: press the button, open our bot, press Start, and type the code it sends you. There is no password and no email. A new account has its first API key ready straight away, and a plan bought from the dashboard gives it credits. Keys start with fr_live_; keep yours on your server, since whoever has it spends your credits.

Your first calls

The top of the 24-hour leaderboard:

curl "https://fomoradar.io/v2/leaderboard/24h?limit=3" \
  -H "Authorization: Bearer $FOMORADAR_KEY"

One trader, by handle, here today's 24-hour leader:

curl "https://fomoradar.io/v2/users/marvolo_hl" \
  -H "Authorization: Bearer $FOMORADAR_KEY"

Who owns a wallet:

curl "https://fomoradar.io/v2/wallets/ADDRESS" \
  -H "Authorization: Bearer $FOMORADAR_KEY"

Your plan and the credits left, which is free:

curl "https://fomoradar.io/v2/me" -H "Authorization: Bearer $FOMORADAR_KEY"

Answers are plain JSON objects with no envelope. A board answer says when its snapshot was taken; a trader answer says when the wallets, the profile and the PnL were last checked. Every billed answer also carries the credits it cost and the credits left, in the x-credits-cost and x-credits-remaining headers.

The same in Python and JavaScript

import os, requests

key = os.environ["FOMORADAR_KEY"]
r = requests.get("https://fomoradar.io/v2/leaderboard/30d",
                 params={"limit": 10},
                 headers={"Authorization": f"Bearer {key}"})
r.raise_for_status()
for t in r.json()["traders"]:
    print(t["rank"], t["handle"], round(t["pnlUsd"]))
const res = await fetch("https://fomoradar.io/v2/leaderboard/30d?limit=10", {
  headers: { Authorization: `Bearer ${process.env.FOMORADAR_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error);
const { traders } = await res.json();
for (const t of traders) console.log(t.rank, t.handle, Math.round(t.pnlUsd));

Call the API from a server or a script, not from a web page: a key in a browser can be read by anyone who opens it.

What people build with it

A daily leaderboard sheet

Read the three boards once a day, after the snapshot, and append them to a spreadsheet or a database. Over a few weeks you have each trader's rank history on every window, in a form you can sort and chart however you like. Three calls a day is all it takes.

Alerts for the traders you follow

Open the trade stream for a list of handles, or for the top of a board, and forward each trade to a Telegram chat or a webhook. Every message carries the trader, the token, the side, the size, the wallet and the transaction. The stream is part of the paid plans; opening it is free, and so are the trades it sends.

Who is behind this wallet?

If a wallet keeps buying the same tokens as you, or shows up early in a token you are researching, reverse lookup tells you whether it belongs to a ranked fomo.family trader, and who. Send up to 100 addresses in one call; any that no trader is known to use come back in a missing list, free.

Research on many traders at once

Batch calls take up to 100 handles at a time and answer from what is already known, with no wait. Combined with the boards, they let you compare traders on return on volume, trade count or chain without opening a page for each.

How billing works

Each call spends credits from a monthly allowance, and only a successful answer is charged: an error, a not-found or a lookup still in progress costs nothing. A leaderboard costs 250 credits, a trader 500, a wallet lookup 500, and a batch 250 per item it actually finds. Plans are paid, 30 days at a time, and every one reads whole leaderboards and opens the trade stream; the larger ones add credits, a higher request rate, more keys and more stream connections. See pricing for the plans.

Limits to plan around

  • Freshness. Leaderboards are captured about once a day. Reading a board every minute returns the same snapshot; read it after each capture instead.
  • Traders we have not seen. Asking for a trader who has never been on a board starts a live lookup. If it takes too long, the answer is a free 202 with a time to ask again.
  • Rate limits. Each plan has a request rate; past it, calls answer 429 with a Retry-After. A loop that respects it never sees one.

Where the data comes from

Leaderboard figures are fomo.family's own, from its public leaderboards, served as fomo.family reports them. Wallet links come from public blockchain data, and a wallet is called verified only when an on-chain transaction matches one of the trader's fomo.family trades. FomoRadar is independent and not affiliated with fomo.family. The methodology has the details, and the API reference lists every endpoint, parameter and error.

Frequently asked questions

Is there an official fomo.family API?

No. fomo.family does not publish an API. The FomoRadar API is an independent alternative serving its leaderboards and trader data as JSON.

Is the FomoRadar API free?

Signing in with Telegram and your first key cost nothing; calls spend credits from a plan, and only successful calls are charged. The pricing page lists what each plan includes, from credits to whole leaderboards and the live trade stream.

Can I get fomo.family wallet addresses through an API?

Yes. The FomoRadar API returns every trader's wallet addresses in full, each labelled verified or likely, and can resolve a wallet address back to the trader who owns it.

More guides