Fomo API logoFOMO APIDOCS

Documentation

IntroductionAuthenticationQuickstartGETHealthGETLeaderboardGETResolve traderGETTrader balancesGETTrader followersGETTrader followingGETTrader spotlightGETTrader swapsWSTrade stream

[ API reference ]

Resolve trader

Resolves a public Fomo handle into a trader profile containing wallet addresses, social information and trading statistics.

GET/api/users/{handle}

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

01

Request

curl

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

Parameters

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

Response fields

handlestringPublic Fomo trader handle.
displayNamestring | nullPublic display name.
pnlUsdnumberTotal profit and loss in USD.
pnlobjectPnL values grouped by time window.
pnl.24hnumberProfit and loss over the last 24 hours.
pnl.7dnumberProfit and loss over the last 7 days.
pnl.30dnumberProfit and loss over the last 30 days.
pnl.allnumberAll-time profit and loss.
volumeUsdnumberLifetime trading volume in USD.
tradesintegerLifetime trade count.
followersintegerFollower count.
followingintegerFollowing count.
holdingsintegerNumber of token holdings.
solanastring | nullSolana wallet address.
evmstring | nullEVM wallet address.
profileobjectAdditional Fomo profile statistics.
numTradesintegerLifetime trade count.
swapCountintegerLifetime swap count.
totalVolumenumberLifetime trading volume.
averageHoldTimeSecondsnumber | nullAverage position holding time in seconds.
createdAtstring | nullFomo account creation time.
accountAgeDaysintegerFomo account age in days.
descriptionstring | nullPublic trader biography.
clanobject | nullTrader clan information.
activatedbooleanWhether the account is activated.
privatebooleanWhether the profile is private.
isRestrictedbooleanWhether the account is restricted.
isReferredbooleanWhether the trader was referred.
verifiedbooleanWhether the trader is verified by Fomo.
04

JSON response

A successful request returns the following response structure.

response.json

{
  "handle": "CryptoKaleo",
  "displayName": "K A L E O",
  "pnlUsd": 151383,
  "pnl": {
    "24h": 8231,
    "7d": 54120,
    "30d": 142900,
    "all": 151383
  },
  "volumeUsd": 119165,
  "trades": 73,
  "followers": 19967,
  "following": 91,
  "holdings": 4,
  "solana": "5AhfPStn66hRYoNNDfJHSDgCH7fBbwMQZUECRrhTo62F",
  "evm": "0x7b4d16237683fe1765e727eadf99c6f02adf0b59",
  "profile": {
    "followers": 19967,
    "averageHoldTimeSeconds": 63613,
    "fomoCreatedAt": "2025-09-03T23:25:33.441Z",
    "accountAgeDays": 360
  },
  "numTrades": 73,
  "swapCount": 184,
  "totalVolume": 119165.42,
  "averageHoldTimeSeconds": 63613,
  "createdAt": "2025-09-03T23:25:33.441Z",
  "accountAgeDays": 360,
  "description": "trader bio",
  "clan": {
    "id": "659b...",
    "name": "Ender",
    "icon": "...",
    "role": "member"
  },
  "activated": false,
  "private": false,
  "isRestricted": false,
  "isReferred": true,
  "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.