femtosHyperEVM · Balances
Token balance
One token of one address on HyperEVM: 0 when not held, now or at a past block.
GET https://api.femtos.xyz/v1/balances/{address}/{token}
Parameters
| Param | In | Example or values |
|---|---|---|
address | path | <owner> |
token | path | 0x5555555555555555555555555555555555555555 |
layer | query | hyperevm |
block | query | (optional) |
at | query | (optional) |
verify | query | (empty), true |
Example
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/balances/<owner>/0x5555555555555555555555555555555555555555?layer=hyperevm"Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
balance | object | One token held by the address on one layer: {layer, kind, asset, symbol, name, decimals, raw, amount, priceUsd, priceSource, usd, spam, …} |
balance.onchain | object | verify=true: the same balance read again on the node at the same block: {raw, match, error} |
layers.<layer> | object | Provenance of the layer read: source, height, asOf: {source, height, asOf, network, chainId, testnet, syncing, dataUntil, requested, usd, usdComplete, count, …} |
token | string | Token asked |
Related: Balances
- Balances GET /v1/balances/{address}
Every token an address holds on HyperEVM, with USD value and the block it is read at. - Batch balances POST /v1/balances/batch
Up to 100 addresses on HyperEVM in one call, the same answer for each. - Balances, all layers GET /v1/balances/{address}
One address on HyperCore, HyperEVM and Elysium in one list, with totals per layer.