API reference, Named wallets

Entity PnL curve

One named entity's HyperCore PnL per hour or day: realized, fees, funding, net and cumulative.

Not on Elysium or HyperEVM: realized PnL comes from HyperCore fills and funding; an entity's EVM activity: GET /v1/entities/{id} and the KOL leaderboard of the layer

GET https://api.femtos.xyz/v1/entities/{id}/pnl

Parameters

Param	In	Example or values	Meaning
`id`	path	`abraxascapital`	Entity id
`window`	query	`7d`, `30d`, `90d`, `all`	UTC days ending today: 7d, 30d, 90d, or all (since `dataStart`). Default 30d
`bucket`	query	`1d`, `1h`	Bucket: 1h (window 7d or 30d) or 1d. Default 1d

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/entities/abraxascapital/pnl"

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

Field	Type	Meaning
`points[]`	object	One per bucket, oldest first: {t, realizedPnl, fees, funding, netPnl, cumNetPnl, fills}
`totals`	object	The window summed: {realizedPnl, fees, funding, netPnl, fills}
`from`	ms	Window start: the first bucket
`dataStart`	ms	Start of our HyperCore history
`wallets`	int	Wallets of the entity summed
`billing`	medium	medium with window 90d or all

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.
Named positioning GET /v1/kols/positioning HyperCore
How KOLs, traders and funds are positioned on each perp: long vs short, entry, PnL, liquidation risk and 1 h / 24 h flows.
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.