API reference · Named wallets

Named wallets

Every named entity, its X account, kinds, sources and wallets.

GET https://api.femtos.xyz/v1/entities

Parameters

Param	In	Example or values	Meaning
`q`	query	(optional)	Name, X handle, alias, wallet address or handle
`kind`	query	(optional)	Entities: named (people, funds, pseudonyms from public sources), cluster (anonymous smart-money clusters: HyperCore traders selected on their results), all, or a kind it contains (whale, market maker…). Default: all
`confidence`	query	`(empty)`, `high`, `medium`, `low`, `unrated`	Entities with at least one wallet of this confidence
`via`	query	`(empty)`, `list`, `bridge`, `subaccount`, `transfer`, `vault-leader`, `self-declared`, `smart-money`, `smart-money-link`	Entities with at least one wallet found this way (`via` of the wallets)
`sort`	query	`default`, `wallets`, `name`, `pnl`	default: the registry order (our research first); wallets: most wallets first; name; pnl: smart-money net PnL first
`cursor`	query	(optional)	Next page: `next_cursor` of the previous answer

Elysium, HyperCore, HyperEVM

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

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

Field	Type	Meaning
`entities[]`	object	{id, name, x, kinds, confidence, aliases, sources, wallets, smartMoney}
`entities[].wallets[].address`	string	Wallet: 0x address, or a named wallet's handle
`entities[].wallets[].via`	list \| bridge \| subaccount \| transfer \| vault-leader \| self-declared \| smart-money \| smart-money-link	How the wallet was found: list (a public list or our research names it), bridge (cross-chain bridges with a wallet of the entity, Solana ones included), subaccount (a HyperCore sub-account), transfer (HyperCore sends both ways), vault-leader (leads the vault), self-declared (verified on Farcaster by the X account), smart-money (selected on its HyperCore results), smart-money-link (linked to such a wallet)
`total`	int	Entities matching
`facets`	object	Counts over the entities matching `q` and `kind`, before the `confidence` and `via` filters: what each filter value would select: {entities, wallets, groups, confidence, via}
`next_cursor`	string \| null	Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page

Next page: cursor = the next_cursor of the previous answer, the same on every list (pagination).

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.
KOL stream WS kol.activity Elysium, HyperCore, HyperEVM
Every fill, liquidation, EVM swap, transfer and bridge leg of a named wallet, live.