femtosHyperEVM · Balances
Batch balances
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 |
|---|---|---|
addresses | body | <owner>,<address> |
layer | body | hyperevm |
tokens | body | (optional) |
minUsd | body | 1 |
Example
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}
Every token an address holds on HyperEVM, with USD value and the block it is read at. - Token balance GET /v1/balances/{address}/{token}
One token of one address on HyperEVM: 0 when not held, now or at a past block. - Balances, all layers GET /v1/balances/{address}
One address on HyperCore, HyperEVM and Elysium in one list, with totals per layer.