# Leaderboards & boards

## Trader leaderboard by PnL (24h/7d/30d/all)

`stalkchain_fomo_leaderboard` · **250 credits**

> Ask: *"Who made the most money in the last 7 days?"*

Who made the most money — the trader rich list for a window. Answers 'top earners', 'who is up the most', 'best performers this month'. Answers 'who is up the most in 24h/7d/30d/all time', 'top traders right now', 'biggest gainers'. Ranked traders: rank, handle, userId, displayName, pnlUsd (for the window), volumeUsd, trades, followers, holdings, wallets {solana, evm}, topTokens, verified. 250 credits per call at ANY limit, so ask for the full board (150; 100 on 'all') and filter locally. Answers 'who made the most money in the last 24h/7d/30d'. Arbitrary date ranges are NOT supported by the API - only these four windows. Cached 5 min.

| Input | Type | Required | Description |
|---|---|---|---|
| `window` | `24h` \| `7d` \| `30d` \| `all` | yes | Ranking window |
| `limit` | integer | no | Rows to RETURN to you (the API is always asked for the full board) |
| `minPnlUsd` | number | no | Local filter: only rows with pnlUsd >= this |
| `verifiedOnly` | boolean | no | Local filter: only verified traders |

REST: `POST /api/v1/tools/stalkchain_fomo_leaderboard` with the inputs as a JSON body, or `GET /api/v1/tools/stalkchain_fomo_leaderboard?…`.

## Token boards: trending / most-held / graduated

`stalkchain_fomo_token_board` · **250 credits**

> Ask: *"What tokens are trending right now? Which are most held?"*

Which coins are hot right now — the token boards. Answers 'what is trending', 'what is everyone buying', 'what just graduated'. Returns a ranked list only; to also analyse them use stalkchain_fomo_trending_analysis. trending = what the provider users are trading right now; most-held = tokens held by the most users (the provider's board is 25, dominated by large caps, holders is null there); graduated = early-stage tokens that graduated (usually < $1M mcap). Each token: rank, token {name, symbol, address}, holders, network, priceUsd, change24h, marketCapUsd, fdvUsd, liquidityUsd, volume24hUsd. The ranking is pulled live from the provider behind a 5-min cache; source='captured' + stale=true only when the provider did not answer. priceUsd and marketCapUsd are replaced with live market data (circulating where known; marketCapBasis says circulating or fully diluted, marketCapSource where it came from), because the board's own figures can be hours old. 250 credits.

| Input | Type | Required | Description |
|---|---|---|---|
| `board` | `trending` \| `most-held` \| `graduated` | yes |  |
| `limit` | integer | no |  |

REST: `POST /api/v1/tools/stalkchain_fomo_token_board` with the inputs as a JSON body, or `GET /api/v1/tools/stalkchain_fomo_token_board?…`.