[ API reference ]

Trader spotlight

Returns a trader's highest-performing trades and most popular public comments, including token metadata and social reactions.

GET/api/users/{userId}/spotlight

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

Request

curl

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

Parameters

NameLocationTypeDescription

userIdpathUUIDUnique trader ID returned by the resolve trader endpoint.

Response fields

FieldTypeDescription

successbooleanIndicates whether the request succeeded.

responseObject.bestTradesarrayHighest-performing trades associated with the trader.

responseObject.bestTrades[].tradeobjectTrade amounts, prices, PnL and token metadata.

responseObject.bestTrades[].commentobject | nullPublic thesis associated with the trade.

responseObject.bestCommentsarrayMost popular public comments from the trader.

responseObject.bestComments[].comment.reactionsobjectReaction totals and authenticated-user reaction state.

statusCodeintegerHTTP status represented in the response.

JSON response

A successful request returns the following response structure.

response.json

{
  "success": true,
  "message": "User spotlight found",
  "responseObject": {
    "bestTrades": [
      {
        "trade": {
          "id": "094dd0b3-22ff-41ba-b676-f093c8293f01",
          "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx",
          "humanTokenAmount": 35755257.92,
          "avgEntryPrice": 0.0140077,
          "realizedPnlUsd": 38026.52,
          "unrealizedPnlUsd": 10003193.72
        },
        "userHandle": "pointfarmcap",
        "verified": false
      }
    ],
    "bestComments": []
  },
  "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.