API reference · Balances
Batch balances
- Elysium: Up to 100 addresses on Elysium in one call, the same answer for each.
- HyperCore: Up to 100 addresses on HyperCore in one call, the same answer for each.
- HyperEVM: Up to 100 addresses on HyperEVM in one call, the same answer for each.
POST https://api.femtos.xyz/v1/balances/batch
Parameters
| Param | In | Example or values | Meaning |
|---|---|---|---|
addresses | body | <creator>,<owner> (Elysium); <address>,<creator> (HyperCore); <owner>,<address> (HyperEVM) | Addresses (or named-wallet handles) |
layer | body | elysium (Elysium); hypercore (HyperCore); hyperevm (HyperEVM) | Layer(s) read |
tokens | body | (optional) | EVM token addresses (`native`) and HyperCore coin names, an array or a comma list |
minUsd | body | 1 | Leave out holdings worth less (and unpriced ones) |
Example
Elysium
curl -X POST -H "Authorization: Bearer $FEMTOS_KEY" -H "Content-Type: application/json" "https://api.femtos.xyz/v1/balances/batch" \
-d '{"addresses":["<creator>","<owner>"],"layer":"elysium","minUsd":1}'HyperCore
curl -X POST -H "Authorization: Bearer $FEMTOS_KEY" -H "Content-Type: application/json" "https://api.femtos.xyz/v1/balances/batch" \
-d '{"addresses":["<address>","<creator>"],"layer":"hypercore","minUsd":1}'HyperEVM
curl -X POST -H "Authorization: Bearer $FEMTOS_KEY" -H "Content-Type: application/json" "https://api.femtos.xyz/v1/balances/batch" \
-d '{"addresses":["<owner>","<address>"],"layer":"hyperevm","minUsd":1}'Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
layer | string | Layer(s) read |
count | int | Addresses answered |
results[] | object | One answer per distinct address, in the order asked: {address, layer, balances, count, total, totalUsd, totalUsdComplete, perp, layers, includeSpam, spamHidden, entity} |
billing | heavy | one heavy unit per 20 addresses |
Related: Balances
- Balances GET /v1/balances/{address} Elysium, HyperCore, HyperEVM
Every token an address holds on HyperCore, with USD value and the block it is read at. - Token balance GET /v1/balances/{address}/{token} Elysium, HyperCore, HyperEVM
One token of one address on HyperCore: 0 when not held, now or at a past block. - Balances, all layers GET /v1/balances/{address} Elysium, HyperCore, HyperEVM
One address on HyperCore, HyperEVM and Elysium in one list, with totals per layer.
More
- This page as Markdown
- The whole API reference
- What Elysium serves
- What HyperCore serves
- What HyperEVM serves
- The whole API in one Markdown file
- OpenAPI 3.1 document
Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog