API reference · Named wallets

KOL stream

Elysium: Every Elysium swap, transfer and bridge leg of a named wallet, on each indexed block.
HyperCore: Every fill, liquidation, EVM swap, transfer and bridge leg of a named wallet, live.
HyperEVM: Every HyperEVM swap, transfer and bridge leg of a named wallet, on each indexed block.

WebSocket channel kol.activity on wss://api.femtos.xyz/v1/ws

Parameters

Param	In	Example or values	Meaning
`layer`	filter	`elysium` (Elysium); `hyperevm` (HyperEVM)	hypercore \| hyperevm \| elysium (Elysium, HyperEVM)
`kind`	filter	`(empty)`, `swap`, `transfer`, `bridge`	trade \| liquidation \| swap \| transfer \| bridge (Elysium, HyperEVM)
`min_notional`	filter	`1000`	Minimum notional, USD (HyperCore)

Elysium

{"op":"subscribe","channel":"kol.activity","filter":{"layer":"elysium"}}

HyperCore

{"op":"subscribe","channel":"kol.activity","filter":{"min_notional":"1000"}}

HyperEVM

{"op":"subscribe","channel":"kol.activity","filter":{"layer":"hyperevm"}}

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

Field	Type	Meaning
`snapshot: true`	KolItem[]	last 50 moves of the named wallets seen, chronological
`data`	KolItem	one KolItem per move of a named wallet: HyperCore fills and liquidations as hl-flows sees them; HyperEVM / Elysium swaps and ERC-20 transfers on each block the indexer commits; bridge legs (core_evm, evm_elysium) on each state change: {layer, kind, t, wallet, entity, walletChain, coin, pair, base, quote, side, px, …}

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 leaderboard GET /v1/kols/leaderboard Elysium, HyperCore, HyperEVM
KOLs, traders and funds ranked by their HyperCore PnL, volume and open positions.
KOL moves GET /v1/kols/activity Elysium, HyperCore, HyperEVM
The latest fills of the named wallets, newest first, with who traded.