[ API reference ]

Resolve a trader

Resolves a public Fomo Family handle into a complete trader profile with wallet addresses, social metrics and trading statistics.

GET/api/users/{handle}

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

Request

curl

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

Parameters

NameLocationTypeDescription

handlepathstringPublic Fomo Family trader handle without the @ character.

Response fields

FieldTypeDescription

successbooleanIndicates whether the request succeeded.

messagestringHuman-readable response message.

responseObject.idstringUnique Fomo trader identifier.

responseObject.addressstringSolana wallet address.

responseObject.evmAddressstring | nullEVM wallet address.

responseObject.displayNamestring | nullPublic display name.

responseObject.userHandlestringPublic user handle.

responseObject.followingintegerFollowing count.

responseObject.followersintegerFollower count.

responseObject.swapCountintegerIndexed swap count.

responseObject.numTradesintegerIndexed trade count.

responseObject.totalVolumenumberTotal indexed trading volume.

responseObject.averageHoldTimeSecondsnumberAverage position holding time in seconds.

statusCodeintegerHTTP status represented in the response.

JSON response

A successful request returns the following response structure.

response.json

{
  "success": true,
  "message": "User found",
  "responseObject": {
    "id": "6d8c0bf3-5d42-506c-a0ea-9e1e75ff38af",
    "address": "6cerGpSGzCrA1NeHUNtyoNm4rWQx5SnK3DSAXb4e615t",
    "evmAddress": "0x2c56846e43eb73d39c5d3791f8ff1e02f10ba596",
    "displayName": "point farm capital",
    "userHandle": "pointfarmcap",
    "following": 0,
    "followers": 160349,
    "swapCount": 18123,
    "numTrades": 2864,
    "totalVolume": 11265184.03,
    "averageHoldTimeSeconds": 75936
  },
  "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.