femtos

HyperCore · Balances

Batch balances

Up to 100 addresses on HyperCore in one call, the same answer for each.

POST https://api.femtos.xyz/v1/balances/batch

Parameters

ParamInExample or values
addressesbody<address>,<creator>
layerbodyhypercore
tokensbody(optional)
minUsdbody1

Example

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}'

Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.

Response fields

FieldTypeMeaning
layerstringLayer(s) read
countintAddresses answered
results[]objectOne answer per distinct address, in the order asked: {address, layer, balances, count, total, totalUsd, totalUsdComplete, perp, layers, includeSpam, spamHidden, entity}
billingheavyone heavy unit per 20 addresses

Related: Balances

  • Balances GET /v1/balances/{address}
    Every token an address holds on HyperCore, with USD value and the block it is read at.
  • Token balance GET /v1/balances/{address}/{token}
    One token of one address on HyperCore: 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.

More