API reference, Named wallets
Named positioning stream
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.
- Elysium: not served
- HyperCore
- HyperEVM: not served
- Not on Elysium or HyperEVM: positions are HyperCore perps: the KOL stream carries the EVM moves of the named wallets
WebSocket channel kol.positioning on wss://api.femtos.xyz/v1/ws
Parameters
| Param | In | Example or values | Meaning |
|---|---|---|---|
kind | filter | (optional) | named (default), cluster (smart-money clusters) or all |
coin | filter | (optional) | One perp market only |
limit | filter | 20 | Markets, largest gross notional first, default 50 (1..500) |
top | filter | (optional) | Largest entities listed per side (0..20), default 5 |
Subscribe
{"op":"subscribe","channel":"kol.positioning","filter":{"limit":"20"}}Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
snapshot: true | object | the full GET /v1/kols/positioning answer: the first frame, and any frame sent whole |
patch: true | JsonPatch | with "patch": true on subscribe: the operations, in order, that turn the previous answer into this one |
Related: Named wallets
- 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 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. - 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.
More
- This page as Markdown
- The whole API reference
- What HyperCore serves
- The whole API in one Markdown file
- OpenAPI 3.1 document
Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog