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
Starter popular
$49.99
/ month
- 2,500,000 credits / mo (10,000 calls)
- +20% by card subscription (3,000,000 / mo)
- App feed stream
/ws/alerts· realtime - On-chain stream · not included
- 5 API keys · Telegram support
Builder
$199.99
/ month
- 12,500,000 credits / mo (50,000 calls)
- +20% by card subscription (15,000,000 / mo)
- 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)
- +20% by card subscription (45,000,000 / mo)
- On-chain stream
/ws/trades· no minimum trade size - OHLCV candles (down to 1s)
- 5 API keys · priority support
Scale
$1,500
/ month
- 112,500,000 credits / mo (450,000 calls)
- +20% by card subscription (135,000,000 / mo)
- On-chain stream + everything
- Highest throughput
- 10 API keys · dedicated support
Card prices are in USD, before sales tax or VAT. Whop adds it at checkout where your location requires it. A one-month USDC payment costs 20% more, gets the base credits without the card +20%, and does not renew.
On every plan, including free
Every plan includes the REST data endpoints below and the app feed stream, subject to source coverage and history limits. Plans differ in credits and access limits. Growth and Scale additionally include the on-chain stream and OHLCV candles.
Live portfolio
Open positions, token balances, total USD value, and Hyperliquid perp PnL. /v2/users/{handle}/balances
Per-trader trades
Available trader positions and recent trade history, with pagination and source limits; not a complete archive. /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
Published app activity, including large trades and theses; smaller events can be absent. Filter by trader or subscribe without filters. wss://api.fomoapi.io/ws/alerts
| Limit | Free | Starter | Builder | Growth | Scale |
|---|---|---|---|---|---|
| Credits | |||||
| Price | $0 | $49.99/mo | $199.99/mo | $599/mo | $1,500/mo |
| Credits / month | 250,000 | 2,500,000 | 12,500,000 | 37,500,000 | 112,500,000 |
| Normal call search, trades, balances, token holders | 250 | 250 | 250 | 250 | 250 |
| Thesis call | 1,250 | 1,250 | 1,250 | 1,250 | 1,250 |
| Wallet resolution handle → Solana + EVM wallets | 2,500 | 2,500 | 2,500 | 2,500 | 2,500 |
| Leaderboards | 250 | 250 | 250 | 250 | 250 |
Activity feed /v2/alerts | 125 | 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 | 250 / page |
| Card subscription renews monthly | - | Yes | Yes | Yes | Yes |
| API keys | 1 | 5 | 5 | 5 | 10 |
| The two WebSockets (different streams, do not mix them up) | |||||
App feed stream /ws/alertspublished app activity; smaller events can be absent | realtime 7d, then 15s | realtime | realtime | realtime | realtime |
| Streams held open never metered by the minute, on any tier | Unmetered | Unmetered | Unmetered | Unmetered | Unmetered |
| Per-trader subscribe | Yes | Yes | Yes | Yes | Yes |
| Unfiltered app-feed subscription | Yes | Yes | Yes | Yes | Yes |
On-chain stream /ws/tradesSolana, Robinhood Chain + BNB Chain, no minimum trade size; coverage and latency vary | - | - | - | Yes | Yes |
| Data endpoints | |||||
| Leaderboards + token boards | Yes | Yes | Yes | Yes | Yes |
| Trader profiles + PnL | Yes | Yes | Yes | Yes | Yes |
| Live portfolio + perps | Yes | Yes | Yes | Yes | Yes |
| Per-trader trades | Yes | Yes | Yes | Yes | Yes |
| Theses | Yes | Yes | Yes | Yes | Yes |
| Who a trader follows | Yes | Yes | Yes | Yes | Yes |
OHLCV candles /v2/token/{addr}/candlesdown to 1-second resolution | - | - | - | Yes | Yes |
| Support | |||||
| Channel | Community | Telegram | 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.
Unused credits on a paid plan roll over. When your bucket refreshes, on renewal (early or on time) or at the start of a month, whatever is left moves to your prepaid balance, which never expires. You start the new period with a full bucket plus everything you had not spent.
The Free plan includes 250,000 credits per month. Add a card on your dashboard (nothing charged, no subscription) and a free key gets 500,000 bonus credits, once per card.
Subscribe by card and get 20% more credits every month. Card subscriptions renew automatically, and each paid plan's monthly bucket is 20% bigger than the base allowance shown above; a one-month USDC plan costs 20% more and gets the base allowance.
More credits per dollar, and no per-minute ceiling
Closest comparable provider below, against ours. Every figure is taken from their own public pricing page, checked 25 September 2026. They publish plan credits and a requests-per-minute limit but not a per-endpoint credit cost, so this compares the two things both sides actually publish - credits and throughput - rather than converting either into "calls".
| Tier | Them | Us | You get |
|---|---|---|---|
| Entry | $99 1,000,000 credits 150 req/min |
$49.99 2,500,000 credits no per-minute cap |
2.5x the credits at half the price |
| Builder | $299 5,000,000 credits 300 req/min |
$199.99 12,500,000 credits no per-minute cap |
2.5x the credits and $99 less |
| Mid | $899 20,000,000 credits 600 req/min |
$599 37,500,000 credits no per-minute cap |
1.9x the credits and $300 less |
| Top self-serve | $2,499 75,000,000 credits 1,200 req/min |
$1,500 112,500,000 credits no per-minute cap |
1.5x the credits and $999 less |
| Credits per $ | 10,101 · 16,722 · 22,247 · 30,012 | 50,010 · 62,503 · 62,604 · 75,000 | 2.5x to 5x across every tier |
| Free | 25,000 credits once |
250,000 credits every month, no card |
recurring not a one-off trial |
On throughput. Their plans ladder a requests-per-minute limit: 150 on entry up to 1,200 at the top. Paid plans here are not rate-capped per minute at all - paid usage is metered in credits against a daily ceiling, so a burst is bounded by your balance rather than by a per-minute gate you have to buy your way out of. The per-minute cap applies to free keys only, at 20 requests a minute.
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, different coverage Growth
On-chain stream (Growth and Scale): detected FOMO trades on Solana, Robinhood Chain and BNB Chain, with no minimum trade size. Coverage depends on wallet attribution and ingestion; this is not a complete trade archive. Historical measurements found it ahead of the app feed, but delivery can be delayed and no timing guarantee is offered. wss://api.fomoapi.io/ws/trades?key=YOUR_API_KEY&chain=robinhood
App feed stream (every plan): wss://api.fomoapi.io/ws/alerts carries FOMO's published activity feed, including large trades and theses. Smaller events can be absent upstream; filters cannot recover them.
Check live service status before testing. See the stream documentation for coverage, timestamps and replay limits.
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), which carries FOMO's published activity subset. The separate on-chain stream (/ws/trades) starts at Growth and covers detected trades on Solana, Robinhood Chain and BNB Chain with no minimum trade size. Coverage and delivery latency vary.How much WebSocket streaming do I get?
The app feed WebSocket (
wss://api.fomoapi.io/ws/alerts) is available on every plan, free included. Connect with your API key (?key=YOUR_API_KEY), filter by trader or subscribe without filters. It carries the published app-feed subset; smaller events can be absent upstream. Paid plans have no added plan delay. A free key has no added plan delay for its first 7 days, then adds 15 seconds. Upstream and capture delays can affect every plan.What is the on-chain stream and why is it Growth-only?
A separate WebSocket (
wss://api.fomoapi.io/ws/trades) on Growth and Scale for detected FOMO trades on Solana, Robinhood Chain and BNB Chain, with no minimum trade size. Coverage depends on wallet attribution and ingestion. Historical speed measurements do not guarantee current latency, complete coverage or gap recovery; check live service status. For FOMO's published activity feed and theses, use /ws/alerts on any plan; smaller events can be absent upstream.Do all plans get the same data?
All plans include REST profiles, PnL, portfolio, trades, theses and leaderboards, plus the app feed stream. Growth and Scale additionally include the on-chain stream and OHLCV candles. Plans differ in credits and access limits; source coverage and history limits still apply.
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. Add a card from your dashboard with no subscription and nothing charged, and a free key gets 500,000 bonus credits (about 2,000 calls), once per card. It also makes upgrading later one click. And if you subscribe by card, every paid plan gets 20% more credits each month than the base allowance.
Can I buy credits by card, or top up automatically?
Yes. One-time card packs from your dashboard: $10 = 250,000, $25 = 650,000, $50 = 1,400,000, $100 = 3,000,000 credits. Pack credits never expire and stack on top of any plan. Once a card is saved you can turn on auto top-up: when your balance drops below a threshold you set, we charge the saved card for the pack you picked, at most 3 times a day. Turn it off any time.
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, Builder 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. Card prices are before sales tax or VAT, which Whop adds at checkout where your location requires it.
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. Listed prices are before sales tax or VAT, which is added at checkout where your location requires it. Prefer crypto? You can still pay once in USDC on Solana - no card, no KYC - but it costs 20% more (Starter 59.99, Builder 239.99, Growth 719, Scale 1,800 USDC), gets the base credits, and buys one month that 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.