Fomo API logoFOMO APIDOCS

Documentation

IntroductionAuthenticationQuickstartGETHealthGETLeaderboardGETResolve traderGETTrader balancesGETTrader spotlightGETTrader swapsGETTrader rankingGETAggregated snapshotWSTrade stream

[ API reference ]

Leaderboard

Returns ranked Fomo Family traders for a selected time window, including profile information, wallet addresses, PnL, trading volume and top holdings.

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 results. Accepted range is 1 to 150. The all window is capped at 100.
03

Response fields

successbooleanIndicates whether the request succeeded.
messagestringHuman-readable response message.
responseObjectobjectContainer for the leaderboard response.
responseObject.leaderboardarrayOrdered list of ranked traders.
responseObject.leaderboard[].idstringUnique Fomo trader identifier.
responseObject.leaderboard[].addressstringTrader Solana wallet address.
responseObject.leaderboard[].evmAddressstring | nullTrader EVM wallet address.
responseObject.leaderboard[].displayNamestring | nullPublic trader display name.
responseObject.leaderboard[].userHandlestringPublic Fomo Family user handle.
responseObject.leaderboard[].pnl24hnumberProfit and loss over the last 24 hours.
responseObject.leaderboard[].totalVolumenumberTotal indexed trading volume.
responseObject.leaderboard[].totalHoldingsintegerNumber of indexed token holdings.
responseObject.leaderboard[].topHoldingsarrayHighest-value token positions held by the trader.
statusCodeintegerHTTP status represented in the response.
04

JSON response

A successful request returns the following response structure.

response.json

{
  "success": true,
  "message": "24H Leaderboard found",
  "responseObject": {
    "leaderboard": [
      {
        "id": "6d8c0bf3-5d42-506c-a0ea-9e1e75ff38af",
        "address": "6cerGpSGzCrA1NeHUNtyoNm4rWQx5SnK3DSAXb4e615t",
        "evmAddress": "0x2c56846e43eb73d39c5d3791f8ff1e02f10ba596",
        "displayName": "point farm capital",
        "userHandle": "pointfarmcap",
        "pnl24h": 2947532.39,
        "totalVolume": 11254462.78,
        "totalHoldings": 200,
        "topHoldings": [
          {
            "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx",
            "networkId": 1399811149,
            "humanAmount": 35754304.47,
            "price": 0.268,
            "value": 9582174.82,
            "pnl": 9112737.78
          }
        ]
      }
    ]
  },
  "statusCode": 200
}

Rate limits and retry

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