[ Get started ]
Introduction
Fomo API is a developer interface for Fomo Family social trading data. It converts trader profiles, wallet positions, swaps, rankings, PnL and social conviction into consistent JSON for dashboards, bots, alerts and AI agents.
Base URL
https://getfomoapi.funHTTPSWhat the API provides
Trader discovery
Resolve public handles and rank traders across multiple performance windows.
Portfolio intelligence
Read balances, token metadata, equity, cost basis and current positions.
Trading activity
Retrieve normalized swaps, token amounts, providers and USD values.
Social context
Discover public comments, best trades, reactions and trader profiles.
API conventions
Protocol
All requests use HTTPS. Unencrypted HTTP requests are not supported.
Format
Request and response bodies use JSON with UTF-8 encoding.
Authentication
Protected routes require an API key through X-API-Key or Bearer authorization.
Rate limit
Pro API keys support up to five requests per second.
Timestamps
Date values use ISO 8601 strings. Snapshot IDs use Unix timestamps.
Networks
Responses can include Solana and supported EVM network identifiers.
Response envelope
Most data endpoints return a common envelope. The endpoint-specific payload is available in responseObject.
response envelope
{
"success": true,
"message": "Resource found",
"responseObject": {},
"statusCode": 200
}Rate limits
5 RPS
Per API key
1 second
Rate window
429
Limit response
When a request returns 429, wait for the number of seconds provided by the Retry-After header before retrying.
Ready to make a request?
Create an API key and follow the quickstart.