API reference, Named wallets

Named positioning

How KOLs, traders and funds are positioned on each perp: long vs short, entry, PnL, liquidation risk and 1 h / 24 h flows.

Not on Elysium or HyperEVM: positions are HyperCore perps; on the EVM layers the named wallets swap and hold tokens: the KOL leaderboard and moves of {layer}

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

Parameters

Param	In	Example or values	Meaning
`kind`	query	`named`, `cluster`, `all`	Entities: named (people, funds, pseudonyms from public sources), cluster (anonymous smart-money clusters), all. Default: named
`coin`	query	(optional)	One perp market only
`limit`	query	`20`	Markets, largest gross notional first
`top`	query	(optional)	Largest entities listed per side

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/kols/positioning?kind=named&limit=20"

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

Field	Type	Meaning
`rows[]`	object	Per perp market, largest gross notional first: {coin, markPx, gross, net, long, short, netSzChange1h, netSzChange24h, netChange1h, netChange24h, closestLiq}
`rows[].long`	object	{notional, size, entities, wallets, avgEntryPx, upnl, top}
`rows[].long.top[]`	object	Largest entities on this side, by notional (`top` of them): {entity, wallet, wallets, size, notional, entryPx, liqPx, liqDistancePct, leverage, upnl}
`rows[].closestLiq`	object \| null	The named position closest to its liquidation price on this coin; null when none has one: {side, entity, wallet, liqPx, distancePct}
`rows[].netChange1h`	decimal	netSzChange1h × mark, USD: the positioning move valued at the current mark, without the price move
`rows[].netChange24h`	decimal	netSzChange24h × mark, USD
`asOf`	ms	Time of the positions cut (its block)
`changeAsOf`	int \| null	End of the 1 h / 24 h change windows (Unix ms, at most ~1 min old); null when the fills could not be read (changes then 0)
`coins`	int	Perp markets with open positions of the group (before coin / limit)

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.
Entity PnL curve GET /v1/entities/{id}/pnl HyperCore
One named entity's HyperCore PnL per hour or day: realized, fees, funding, net and cumulative.
KOL leaderboard GET /v1/kols/leaderboard Elysium, HyperCore, HyperEVM
KOLs, traders and funds ranked by their HyperCore PnL, volume and open positions.
Named positioning stream WS kol.positioning HyperCore
The GET /v1/kols/positioning answer (named wallets long vs short per perp, entry, PnL, liquidation risk, 1 h / 24 h flows), pushed on subscribe, then on each roll of the live positions (every 5 s) when it changes.
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.