femtos

Elysium · Balances

Batch balances

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

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

Parameters

ParamInExample or values
addressesbody<creator>,<owner>
layerbodyelysium
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":["<creator>","<owner>"],"layer":"elysium","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 Elysium, with USD value and the block it is read at.
  • Token balance GET /v1/balances/{address}/{token}
    One token of one address on Elysium: 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