Fomo API logoFOMO APIDOCS

Documentation

IntroductionAuthenticationQuickstartGETHealthGETLeaderboardGETResolve traderGETTrader balancesGETTrader followersGETTrader followingGETTrader spotlightGETTrader swapsWSTrade stream

[ API reference ]

Trader following

Returns public profiles followed by the selected trader.

GET/api/users/{handle}/following

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

01

Request

curl

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

Parameters

handlepathstringPublic Fomo trader handle. The leading @ character is optional.
03

Response fields

errorstringReturned when the Fomo service is unavailable or times out.
countintegerNumber of followed profiles returned.
truncatedbooleanWhether the following list was truncated.
completebooleanWhether the response contains the complete following list.
partialbooleanWhether the upstream request stopped before completion.
retryablebooleanWhether the request can be repeated to retrieve remaining data.
followingarrayProfiles followed by the selected trader.
following[].handlestringFollowed trader handle.
following[].displayNamestring | nullFollowed trader display name.
following[].followersintegerFollowed trader's follower count.
following[].followingintegerFollowed trader's following count.
following[].tradesintegerFollowed trader's lifetime trade count.
following[].swapCountintegerFollowed trader's lifetime swap count.
following[].volumeUsdnumberFollowed trader's lifetime trading volume.
following[].pnl24hnumberFollowed trader's 24-hour PnL in USD.
following[].verifiedbooleanWhether the followed trader is verified by Fomo.
following[].privatebooleanWhether the followed trader profile is private.
04

JSON response

A successful request returns the following response structure.

response.json

{
  "count": 1,
  "truncated": false,
  "complete": true,
  "partial": false,
  "retryable": false,
  "following": [
    {
      "handle": "CryptoKaleo",
      "displayName": "K A L E O",
      "followers": 19967,
      "following": 91,
      "trades": 73,
      "swapCount": 184,
      "volumeUsd": 119165.42,
      "pnl24h": 8231,
      "verified": true,
      "private": false
    }
  ]
}

Rate limits and retry

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