Trader profiles
Handle to both on-chain wallets, PnL over 24h / 7d / 30d / all-time, account age, average hold time. /v2/users/{handle}
// pricing
Start free. Pay when it matters.
Every endpoint on every plan, including free. You pay for volume, not for features.
Free
$0
a taste of everything
- 250,000 credits / mo (1,000 calls)
- Every endpoint, both chains
- App feed stream · realtime 7 days, then 15s delayed
- 1 API key · +500,000 credits for adding a card
Starter popular
$49.99
/ month
- 2,500,000 credits / mo (10,000 calls)
- App feed stream
/ws/alerts· realtime - On-chain stream · not included
- 5 API keys · Telegram support
Growth
$599
/ month
- 37,500,000 credits / mo (150,000 calls)
- On-chain stream
/ws/trades· ~15s early - OHLCV candles (down to 1s)
- 5 API keys · priority support
Scale
$1,500
/ month
- 112,500,000 credits / mo (450,000 calls)
- On-chain stream + everything
- Highest throughput
- 10 API keys · dedicated support
On every plan, including free
Plans differ by how much you pull, not which data you reach. Every endpoint below is open on all tiers, free included. You upgrade for volume, rate, and always-on streaming, never to unlock a feature.
Live portfolio
Open positions, token balances, total USD value, and Hyperliquid perp PnL. /v2/users/{handle}/balances
Per-trader trades
Every buy, sell, and transfer a trader has made, with token, size, and time. /v2/users/{handle}/trades
Leaderboards
Top traders by PnL over any window, plus trending, most-held, and graduated token boards. /v2/leaderboard
Theses
The written reason a trader gives when they take a position, by token or by trader. /v2/thesis
App feed stream
FOMO's trade data as the app publishes it: every buy, sell and thesis, the moment users see it. One trader by username, or the full firehose. wss://api.fomoapi.io/ws/alerts
| Limit | Free | Starter | Growth | Scale |
|---|---|---|---|---|
| Credits | ||||
| Price | $0 | $49.99/mo | $599/mo | $1,500/mo |
| Credits / month | 250,000 | 2,500,000 | 37,500,000 | 112,500,000 |
| Normal call search, trades, balances, token holders | 250 | 250 | 250 | 250 |
| Thesis call | 1,250 | 1,250 | 1,250 | 1,250 |
| Wallet resolution handle → Solana + EVM wallets | 2,500 | 2,500 | 2,500 | 2,500 |
| Leaderboards | 250 | 250 | 250 | 250 |
Activity feed /v2/alerts | 125 | 125 | 125 | 125 |
| Following pull 250 per page walked, up to 6 (the 300-name cap) | 250 / page | 250 / page | 250 / page | 250 / page |
| Card subscription renews monthly | - | Yes | Yes | Yes |
| API keys | 1 | 5 | 5 | 10 |
| The two WebSockets (different streams, do not mix them up) | ||||
App feed stream /ws/alertswhat the app shows, when the app shows it | realtime 7d, then 15s | realtime | realtime | realtime |
| Streams held open never metered by the minute, on any tier | Unmetered | Unmetered | Unmetered | Unmetered |
| Per-trader subscribe | Yes | Yes | Yes | Yes |
| Full firehose | Yes | Yes | Yes | Yes |
On-chain stream /ws/tradesread off the chain, ~15s BEFORE the app | - | - | Yes | Yes |
| Data endpoints | ||||
| Leaderboards + token boards | Yes | Yes | Yes | Yes |
| Trader profiles + PnL | Yes | Yes | Yes | Yes |
| Live portfolio + perps | Yes | Yes | Yes | Yes |
| Per-trader trades | Yes | Yes | Yes | Yes |
| Theses | Yes | Yes | Yes | Yes |
| Who a trader follows | Yes | Yes | Yes | Yes |
OHLCV candles /v2/token/{addr}/candlesdown to 1-second resolution | - | - | Yes | Yes |
| Support | ||||
| Channel | Community | Telegram | Priority TG | Dedicated |
Credits: pay for what you use
A monthly credit bucket that refills every billing period. Run past it and you move up a tier by card, effective immediately. Out of credits, paid endpoints return 402 with the link.
Renew early and it extends your expiry rather than resetting it. No paid time wasted.
On the free tier, adding a payment method grants 500,000 credits - 2,000 more calls, free, and nothing is charged for it.
Same money, ten times the calls
No standard credit exists in this category, so headline numbers rarely mean the same thing. The only comparison that matters is how many API calls a plan actually buys. Closest comparable provider below, at their published prices, against ours. Unnamed; every figure is from their own public pricing.
| Tier | Them | Us | You get |
|---|---|---|---|
| Entry | $79 1,000 calls |
$49.99 10,000 calls |
10x the calls and $29 less |
| Mid | $795 26,000 calls |
$599 150,000 calls |
5.8x the calls and $196 less |
| Top self-serve | $1,395 60,000 calls |
$1,500 450,000 calls |
7.5x the calls for $105 more |
| Free | none | 1,000 calls / month | every endpoint wallet resolution included |
Their cheapest call is 250 units, a handle lookup 2,500, the same scale we use. These counts are their own published costs divided into their own allowances. Nothing adjusted in our favour.
Two more things that decide a real bill, and neither shows up in a credit total:
- The websocket meter. Realtime streams here are commonly billed per minute held
open, around 20,000 units a minute, roughly 1.2 million an hour, more in a day than a whole
monthly plan. Ours is not metered at all on any tier, free included: open
/ws/alertsand leave it open. - What a miss costs. A handle we cannot resolve is one ordinary call, not the resolution price. Finding nothing costs us nothing.
License the complete FOMO dataset
Separate from the API plans. The complete FOMO dataset, every fomo.family username mapped to its verified Solana and EVM wallet, licensed as a one-off. Enterprise-grade, priced accordingly. Serious buyers inquire on Telegram.
Inquire about the datasetEnterprise
Higher volume than Scale, redistribution rights, a private feed, or an SLA. Building a product on this and need a custom plan? We size one to it.
Talk to usTwo streams: be first, or see what the app shows Growth
On-chain stream (Growth and Scale): every FOMO trade read straight off the chain, about 15 seconds before the app. The window to act before the crowd sees the alert. wss://api.fomoapi.io/ws/trades?key=YOUR_API_KEY&chain=robinhood
App feed stream (every plan): wss://api.fomoapi.io/ws/alerts gives you exactly what people see in the app, when they see it. React to what the crowd is seeing.
How credits work
Wallet resolution /v2/users/{handle} | 2,500 |
|---|---|
| Thesis call the written "why" behind a trade | 1,250 |
| Normal call leaderboard, search, trades, balances, holders | 250 |
Activity feed /v2/alerts | 125 |
| A handle we cannot resolve finding nothing costs us nothing, so you pay one normal call, not 2,500 | 250 |
Health check /health, /v1, /v2/me point your uptime monitor at it freely | 0 |
Balance is on /v2/me and the x-credits-remaining header. Out of credits, paid endpoints return 402.
FAQ
Is there really a free plan?
Yes. Get a key and start pulling data, including the app feed stream
/ws/alerts, at no cost. (The on-chain stream /ws/trades is Growth and up.) Upgrade when you outgrow the limits.Does Starter include the on-chain stream?
No. Starter includes the app feed stream (
/ws/alerts) in realtime - that is the "realtime WebSocket" on the plan card. The on-chain stream (/ws/trades), which arrives about 15 seconds earlier because it reads the chain directly, starts at Growth. Two different streams, two different URLs.How much WebSocket streaming do I get?
The trade WebSocket (wss://api.fomoapi.io/ws/alerts) is available on every plan, free included - just connect with your API key (
?key=YOUR_API_KEY), scoped to one trader by username or the full firehose. Every tier receives every event with identical fields; a plan only buys freshness. Paid plans are realtime (0s). A free key is realtime for its first 7 days, then the stream is delayed 15 seconds. What is the on-chain stream and why is it Growth-only?
A second WebSocket (
wss://api.fomoapi.io/ws/trades) that reads FOMO trades straight off the chain instead of waiting for the app's feed, so you get them about 15 seconds earlier. Being first is the whole point, which is why it sits on Growth and Scale. If you want what people actually see in the app at the same time they see it, use /ws/alerts, which is on every plan.Do all plans get the same data?
Yes. Every endpoint - profiles, PnL, live portfolio, trades, theses, leaderboards, and the WebSocket - is open on all tiers, free included. Plans differ only by how many credits you get and, for the on-chain stream, the speed edge on Growth and Scale. Even the free tier can resolve a wallet and read real PnL - it just has a tiny credit bucket.
What is a credit?
A usage unit, weighted by value. A leaderboard or normal call (search, trades, balances, token holders) is 250 credits; the
/v2/alerts feed is 125. Two calls cost more: a thesis call is 1,250 per page and a wallet resolution (/v2/users/{handle}) is 2,500. The following pull is 250 per page we walk (about 50 names/page, up to 6 for a full pull - the 300-name cap).Do I get anything for adding a card without upgrading?
Yes - 500,000 credits, free. Adding a payment method on the free tier grants them immediately and charges you nothing; it is there so you can keep building past the first bucket without picking a plan yet. That is 2,000 more ordinary calls on top of the 250,000 you start with.
What happens when I run out of credits?
Paid endpoints return a
402 with the link. Move up a tier by card and the new bucket is live immediately; you can also top up in prepaid USDC. Nothing shuts off by surprise - your balance is in every response as x-credits-remaining and in /v2/me.How many API keys do I get?
Free includes 1 key, Starter and Growth 5, and Scale 10. Keys on the same plan share one credit balance, so you can separate a dev key from production without buying credits twice. Rotate any key instantly from the dashboard.
Can I try before paying?
Yes - that is what the free tier is for. A free key reaches every endpoint, including wallet resolution and real PnL, on a 250,000-credit monthly bucket - roughly 100 wallet resolutions, or 200 theses, or 1,000 normal calls. Upgrade when you are ready - and the price on the card is the total. We cover the tax, so $49.99 means $49.99.
How do I pay?
By card, on a hosted checkout. Pick a plan above, type an email, and you are on the payment page - there is no account to create first; the key is made from that email and emailed to you the moment the payment clears. The plan renews monthly at the same price and you can cancel any time. The listed price is the total - we cover the tax, nothing is added at checkout. Prefer crypto? You can still pay once in USDC on Solana - no card, no KYC - but that buys one month and does not renew.
Do I need an account to buy?
No. The pricing page takes an email and goes straight to checkout; your key and account are created from that email afterwards, and the key arrives by email. Come back later and the remembered address takes you to checkout in one click.
What happens if I renew before my plan expires?
The time is added on. Renewing early extends the expiry you already have on that tier rather than resetting the clock, so you never lose days by paying ahead.
Can I license the full wallet dataset?
Yes, as a separate one-off - it is not part of any API plan. The complete FOMO dataset (every username mapped to its verified Solana + EVM wallet) is available to license. Inquire on Telegram.