Fomo API logoFOMO APIDOCS

Documentation

IntroductionAuthenticationQuickstartGETHealthGETLeaderboardGETResolve traderGETTrader balancesGETTrader followersGETTrader followingGETTrader spotlightGETTrader swapsWSTrade stream

[ API reference ]

Trader spotlight

Returns the trader's best-performing trades. The upstream note and bestTheses fields are excluded from the response.

GET/api/users/{handle}/spotlight

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

01

Request

curl

curl "https://getfomoapi.fun/api/users/{handle}/spotlight" \
  -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.
userIdstringUnique Fomo trader identifier.
bestTradesarrayBest-performing trades selected by Fomo.
bestTrades[].tradeIdstringUnique Fomo trade identifier.
bestTrades[].tokenobjectToken symbol and contract address.
bestTrades[].chainstringBlockchain used for the trade.
bestTrades[].avgEntryPricenumber | nullAverage entry price in USD.
bestTrades[].avgExitPricenumber | nullAverage exit price in USD.
bestTrades[].realizedPnlUsdnumberRealized PnL in USD.
bestTrades[].unrealizedPnlUsdnumberUnrealized PnL in USD.
bestTrades[].thesisstring | nullPublic thesis associated with the trade.
bestTrades[].thesisLikesintegerNumber of likes received by the thesis.
bestTrades[].openedAtstringPosition opening time.
bestTrades[].closedAtstring | nullPosition closing time, or null when open.
04

JSON response

A successful request returns the following response structure.

response.json

{
  "handle": "natan_benish",
  "userId": "4220f524-2073-5bcb-a053-1ec43b074038",
  "bestTrades": [
    {
      "tradeId": "9e994c1a-0ec5-47ae-a8df-f0c5cb6ad123",
      "token": {
        "symbol": "SOL",
        "address": "So11111111111111111111111111111111111111112"
      },
      "chain": "solana",
      "avgEntryPrice": 145.32,
      "avgExitPrice": 191.84,
      "realizedPnlUsd": 18420.51,
      "unrealizedPnlUsd": 0,
      "thesis": "Momentum continuation",
      "thesisLikes": 84,
      "openedAt": "2026-07-12T14:20:00Z",
      "closedAt": "2026-08-01T09:45:00Z"
    }
  ]
}

Rate limits and retry

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