HyperCore · Balances

Balances

Every token an address holds on HyperCore, with USD value and the block it is read at.

GET https://api.femtos.xyz/v1/balances/{address}

Parameters

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/balances/<address>?layer=hypercore"

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

Field	Type	Meaning
`address`	string	The address: 0x address, or a named wallet's handle
`layer`	hypercore \| hyperevm \| elysium \| all	Layer(s) read
`balances[]`	object	Holdings, largest USD first (sort=amount: largest amount); spam left out unless includeSpam: {layer, kind, asset, symbol, name, decimals, raw, amount, priceUsd, priceSource, usd, spam, …}
`count`	int	Rows listed
`total`	int	Rows matching before `limit`
`totalUsd`	decimal \| null	USD of every holding (spam never counts; tokens= narrows it, minUsd and limit do not) + HyperCore perp account values; Elysium testnet not valued; null on a past read
`totalUsdComplete`	boolean	Every holding had a price and every layer asked answered
`perp`	object \| null	HyperCore perp accounts (layer hypercore / all): kept apart from the token rows; null with tokens= or a past read: {dex, collateral, accountValue, withdrawable, totalMarginUsed, totalNtlPos, positions, usd, dexes, totalUsd, abstraction, inSpot}
`layers.<layer>`	object	Per layer asked: source, height, asOf (provenance), usd, count, verify: {source, height, asOf, network, chainId, testnet, syncing, dataUntil, requested, usd, usdComplete, count, …}
`includeSpam`	boolean	Spam tokens listed (the includeSpam asked)
`spamHidden`	int	Spam holdings left out
`entity`	object	Named wallet (labels), when known

Token balance GET /v1/balances/{address}/{token}
One token of one address on HyperCore: 0 when not held, now or at a past block.
Batch balances POST /v1/balances/batch
Up to 100 addresses on HyperCore 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.