API reference · Named wallets

KOL leaderboard

Elysium: KOLs, traders and funds ranked by their Elysium swaps, transfers, bridge legs and holdings.
HyperCore: KOLs, traders and funds ranked by their HyperCore PnL, volume and open positions.
HyperEVM: KOLs, traders and funds ranked by their HyperEVM swaps, transfers, bridge legs and holdings.

GET https://api.femtos.xyz/v1/kols/leaderboard

Parameters

Param	In	Example or values	Meaning
`layer`	query	`elysium` (Elysium); `hyperevm` (HyperEVM)	Layer (Elysium, HyperEVM)
`window`	query	`24h`, `7d`, `30d`	Window (hypercore: 7d by default, EVM layers: 24h)
`sort`	query	`volume`, `swaps`, `transfers`, `netBuy`, `holdings`, `bridges`, `lastActivity` (Elysium, HyperEVM); `netPnl`, `realizedPnl`, `volume`, `fills`, `winRate`, `openNotional` (HyperCore)	Sort (per layer, see above; default netPnl / volume)
`limit`	query	`50`	Rows
`includeSpam`	query	`(empty)`, `true`	Show spam tokens (tokens.spam: homoglyph, impostor, fake transfers…), flagged spam / spamReason; hidden from lists and USD totals by default (Elysium, HyperEVM)

Elysium

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/kols/leaderboard?layer=elysium&window=24h&sort=volume&limit=50"

HyperCore

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/kols/leaderboard?window=7d&sort=netPnl&limit=50"

HyperEVM

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/kols/leaderboard?layer=hyperevm&window=24h&sort=volume&limit=50"

Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.

Field	Type	Meaning
`rows[]`	object	Per entity (its wallets summed), sorted: KolRow on hypercore {entity, wallets, fills, volume, realizedPnl, fees, netPnl, winRate, open…}, EvmKolRow on hyperevm / elysium {entity, swaps, volumeUsd, netBuyUsd, transfersIn, transfersOut, bridges, holdingsUsd…}: {entity, wallets, activeWallets, fills, volume, realizedPnl, fees, netPnl, winRate, closingFills, lastTradeAt, open, …}
`window`	string	Window
`scope`	object	What an EVM read covered, per kind: from which block / time to the indexed head. windowSec 30 days through an address index (indexed: true), else 24 h of blocks at most (HyperEVM until its trader / sender / recipient indexes exist).: {toBlock, to, swaps, transfers} (Elysium, HyperEVM)
`computedAt`	ms	EVM layers: when this leaderboard was computed (background, see above) (Elysium, HyperEVM)
`asOfBlock`	int	EVM layers: indexed head block it was computed at (Elysium, HyperEVM)
`holdingsAsOf`	int \| null	EVM layers: time of the holdings (indexed head) (Elysium, HyperEVM)
`entities`	int	Entities with activity
`from`	ms	Window start (HyperCore)
`positionsAsOf`	int \| null	hypercore (HyperCore)

Named wallets GET /v1/entities Elysium, HyperCore, HyperEVM
Every named entity, its X account, kinds, sources and wallets.
One entity GET /v1/entities/{id} Elysium, HyperCore, HyperEVM
One named entity: its wallets on the three layers and 30 days of HyperCore trading.
Entity proofs GET /v1/entities/{id}/graph Elysium, HyperCore, HyperEVM
How each wallet of an entity was found: the path of links back to a public source and their proofs.
KOL moves GET /v1/kols/activity Elysium, HyperCore, HyperEVM
The latest fills of the named wallets, newest first, with who traded.
KOL stream WS kol.activity Elysium, HyperCore, HyperEVM
Every fill, liquidation, EVM swap, transfer and bridge leg of a named wallet, live.