femtosHyperCore · Holders
Perp holders
Largest open positions of a perp, long and short.
GET https://api.femtos.xyz/v1/holders
Parameters
| Param | In | Example or values |
|---|---|---|
layer | query | hypercore |
token | query | BTC |
kind | query | positions, balances |
limit | query | 20 |
Example
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/holders?layer=hypercore&token=BTC&kind=positions&limit=20"Key: Authorization: Bearer $FEMTOS_KEY or X-API-KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
totalHolders | int | positive balances, system excluded |
top10Share | number | null | 10 largest shares, 0–1 |
holders[] | object | {address, amount, share, usd?, side?, label?} |
system[] | object | bridge, pools, fee collector… (excludeSystem=0 to count them) |
asOf · height | int | time and block of the balances |
Related: Holders
- Token holders GET /v1/holders
Spot balances of a HyperCore token, largest first. - Token registry GET /v1/coins
HyperCore tokens with their HyperEVM contract and price. - Coin detail GET /v1/coins/{layer}/{id}
One token: its links across layers, the markets it trades on, its 5 largest holders.