What is the Fomo Api base URL?

https://api.fomo-api.com. Every endpoint is versioned under /v1, for example https://api.fomo-api.com/v1/leaderboard.

How do I authenticate with Fomo Api?

Send your key as a Bearer token: Authorization: Bearer . Keys are created in the developer console. The leaderboard also answers without a key, limited to 10 rows.

What are the Fomo Api rate limits?

Per key, per minute: 10 on Free, 60 on Starter, 180 on Pro and 600 on Growth. Monthly quotas are 1,500, 75,000, 300,000 and 1.5 million calls. GET /v1/plans always has the current figures.

REFERENCE

Fomo Api docs: every endpoint, parameter and error

The Fomo Api reference on one page: base URL, auth, the leaderboard, trader trades and wallet endpoints, every query parameter, rate-limit headers and error codes.

Published October 28, 2026 · 6 min read

This is the whole Fomo Api surface on one page: what to call, what to send, and what comes back when something's wrong. The full interactive docs have response examples for every field; this page is the map.

Base URL and auth

Every endpoint lives under https://api.fomo-api.com/v1. Authenticate with one header:

Authorization: Bearer <API_KEY>

Create a key in the console. It's shown once, so copy it then. Keep it server-side; a key in a browser bundle is a key anyone can use.

Endpoints

ENDPOINT	KEY	WHAT IT RETURNS
`GET /v1/leaderboard`	Optional	FOMO's traders ranked for a window, with wallets and top holdings
`GET /v1/traders/:traderId/trades`	Required	One trader's trades from the last 30 days
`GET /v1/wallet/:address`	Required	One Solana wallet's realized PnL, return, volume and coverage
`GET /v1/wallet/:address/trades`	Required	The swaps behind that wallet's numbers, newest first
`GET /v1/plans`	No	Plans, quotas and rate limits
`GET /v1/status`	No	Live component status, the feed behind the status page

GET /v1/leaderboard

window: 24h, 7d or 30d. Defaults to 30d.
board: fomo-parity (the default, FOMO's figures as reported) or solana (realized PnL we compute from on-chain swaps). The two return different row shapes: fomo-parity rows are keyed by traderId, solana rows by wallet address.
limit: 1 to 200, capped by plan. No key gets 10 rows, a free key 20, a paid plan the full top 150.
cursor: pass back pageInfo.nextCursor for the next page while pageInfo.hasMore is true.

Read source (fomo or computed), pnlBasis and syncedAt on every response. The leaderboard guide covers every row field.

GET /v1/traders/:traderId/trades

traderId: the UUID from a leaderboard row.
source: both (default), onchain (trades with a tx hash) or fomo (trades FOMO reports that we don't hold on-chain).
limit 1 to 200 (default 50), offset 0 or more. Both apply to each source separately; counts has each side's total.

Details in the trader trades guide.

GET /v1/wallet/:address and /trades

address is a base58 Solana address. The summary uses a 30-day window. /trades takes limit (1 to 200, default 50) and offset, and returns total and windowDays so you know how far pagination goes. Walkthrough in the wallet PnL quickstart.

Rate limits and quotas

PLAN	CALLS / MONTH	REQUESTS / MINUTE
Free	1,500	10
Starter	75,000	60
Pro	300,000	180
Growth	1,500,000	600

Every keyed response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-Quota-Limit and X-Quota-Remaining. A 429 carries Retry-After in seconds. One HTTP request is one call, however many rows it returns. Quotas reset on the first of the month, UTC.

Errors

Every error has the same shape:

{ "error": { "code": "invalid_query", "message": "limit must be 1-200 and offset must be >= 0." } }

400: a bad parameter. message names the one that's wrong.
401: missing or invalid key.
403: the feature isn't on your plan.
404: no such trader, or a wallet that isn't on our ranked 30-day Solana board.
429: rate limit or monthly quota. Wait Retry-After seconds.
5xx: our fault. Back off exponentially and check status.

New here? What is Fomo Api is the two-minute overview.

Frequently asked questions

What is the Fomo Api base URL?: https://api.fomo-api.com. Every endpoint is versioned under /v1, for example https://api.fomo-api.com/v1/leaderboard.
How do I authenticate with Fomo Api?: Send your key as a Bearer token: Authorization: Bearer <API_KEY>. Keys are created in the developer console. The leaderboard also answers without a key, limited to 10 rows.
What are the Fomo Api rate limits?: Per key, per minute: 10 on Free, 60 on Starter, 180 on Pro and 600 on Growth. Monthly quotas are 1,500, 75,000, 300,000 and 1.5 million calls. GET /v1/plans always has the current figures.