v50

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-2028153455.3 KB
Accounts

Get account balance

Retrieves account balance for coins / fungible asset (only for primary fungible asset store) for a given account, asset type and a specific ledger version. If the ledger version is not specified in the request, the latest ledger version is used.

The Lumio nodes prune account state history, via a configurable time window. If the requested ledger version has been pruned, the server responds with a 410.

get/accounts/{address}/balance/{asset_type}

Path parameters

addressstring hex required

A hex encoded 32 byte Lumio account address.

This is represented in a string as a 64 character hex string, sometimes shortened by stripping leading 0s, and adding a 0x.

For example, address 0x0000000000000000000000000000000000000000000000000000000000000001 is represented as 0x1.

Address of account with or without a 0x prefix

asset_typestring hex required

A hex encoded 32 byte Lumio account address or a struct tag.

This is represented in a string as a 64 character hex string, sometimes shortened by stripping leading 0s, and adding a 0x or Format: {address}::{module name}::{struct name}

Example:0x1::lumio_coin::LumioCoin

Query parameters

ledger_versionstring uint64

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

Example:32425224034

Ledger version to get state of account

If not provided, it will be the latest version

Response

integer required