Fomo API logoFOMO APIDOCS

Documentation

IntroductionAuthenticationQuickstartGETHealthGETLeaderboardGETResolve traderGETTrader balancesGETTrader followersGETTrader followingGETTrader spotlightGETTrader swapsWSTrade stream

[ API reference ]

Leaderboard

Returns ranked Fomo traders for a selected time window. Leaderboard responses are cached and the last saved response is returned when the upstream service is unavailable.

GET/api/leaderboard/{window}

This endpoint requires an API key using X-API-Key or Bearer authorization.

01

Request

curl

curl "https://getfomoapi.fun/api/leaderboard/{window}" \
  -H "X-API-Key: YOUR_API_KEY"
02

Parameters

windowpathstringRanking window. Accepted values are 24h, 7d, 30d and all.
limitqueryintegerMaximum number of traders to return. Accepted range is 1 to 150. The all window is capped at 50.
03

Response fields

windowstringLeaderboard ranking window.
countintegerNumber of traders returned.
tradersarrayOrdered list of ranked traders.
traders[].rankintegerTrader rank for the selected window.
traders[].handlestringPublic Fomo trader handle.
traders[].userIdstringUnique Fomo trader identifier.
traders[].displayNamestring | nullPublic trader display name.
traders[].pnlUsdnumberProfit and loss in USD.
traders[].volumeUsdnumberTrading volume in USD.
traders[].tradesintegerNumber of indexed trades.
traders[].followersintegerTrader follower count.
traders[].holdingsintegerNumber of token holdings.
traders[].solanastring | nullTrader Solana wallet address.
traders[].evmstring | nullTrader EVM wallet address.
traders[].topTokensarrayAddresses of the trader's top tokens.
traders[].verifiedbooleanWhether the trader is verified by Fomo.
04

JSON response

A successful request returns the following response structure.

response.json

{
  "window": "7d",
  "count": 1,
  "traders": [
    {
      "rank": 1,
      "handle": "CryptoKaleo",
      "userId": "1f08e6ab-5c73-5443-9225-bfc496cde51f",
      "displayName": "K A L E O",
      "pnlUsd": 54120,
      "volumeUsd": 119165,
      "trades": 73,
      "followers": 19967,
      "holdings": 4,
      "solana": "5AhfPStn66hRYoNNDfJHSDgCH7fBbwMQZUECRrhTo62F",
      "evm": "0x7b4d16237683fe1765e727eadf99c6f02adf0b59",
      "topTokens": [
        "0x7fe995",
        "0x51fb76"
      ],
      "verified": true
    }
  ]
}

Rate limits and retry

Pro keys allow 5 requests per second. On a 429 response, wait for the Retry-After value before retrying.