Fomo API logoFOMO APIDOCS

Documentation

IntroductionAuthenticationQuickstartGETHealthGETLeaderboardGETResolve traderGETTrader balancesGETTrader followersGETTrader followingGETTrader spotlightGETTrader swapsWSTrade stream

[ API reference ]

Trader followers

Returns public profiles that follow the selected trader.

GET/api/users/{handle}/followers

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

01

Request

curl

curl "https://getfomoapi.fun/api/users/{handle}/followers" \
  -H "X-API-Key: YOUR_API_KEY"
02

Parameters

handlepathstringPublic Fomo trader handle. The leading @ character is optional.
limitqueryintegerMaximum number of followers to return. Accepted range is 1 to 200.
03

Response fields

errorstringReturned when the Fomo service is unavailable or times out.
countintegerNumber of followers returned.
followersarrayProfiles that follow the selected trader.
followers[].handlestringFollower handle.
followers[].displayNamestring | nullFollower display name.
followers[].followersintegerFollower's own follower count.
followers[].followingintegerFollower's own following count.
followers[].tradesintegerFollower's lifetime trade count.
followers[].swapCountintegerFollower's lifetime swap count.
followers[].volumeUsdnumberFollower's lifetime trading volume.
followers[].pnl24hnumberFollower's 24-hour PnL in USD.
followers[].verifiedbooleanWhether the follower is verified by Fomo.
followers[].privatebooleanWhether the follower profile is private.
followers[].twitterstring | nullFollower's linked X profile.
followers[].biostring | nullFollower's public biography.
followers[].avatarstring | nullFollower's profile image.
followers[].createdAtstringFomo account creation time.
followers[].accountAgeDaysintegerFomo account age in days.
04

JSON response

A successful request returns the following response structure.

response.json

{
  "count": 1,
  "followers": [
    {
      "handle": "exampletrader",
      "displayName": "Example Trader",
      "followers": 1200,
      "following": 83,
      "trades": 410,
      "swapCount": 925,
      "volumeUsd": 284510.42,
      "pnl24h": 1820.51,
      "verified": true,
      "private": false,
      "twitter": "exampletrader",
      "bio": "Onchain trader",
      "avatar": "https://example.com/avatar.png",
      "createdAt": "2025-05-10T12:30:00Z",
      "accountAgeDays": 501
    }
  ]
}

Rate limits and retry

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