Get aggregated balance
Fetches the aggregated balance of all supported assets for a given smart account address, with an option to filter by specific assetId
s.
Authorizations
The OneBalance API uses API keys to authenticate requests. All API requests require authentication using an API key passed in the x-api-key
header:
curl -X 'GET' \
'https://be.onebalance.io/api/path-to/endpoint' \
-H 'x-api-key: ${ONEBALANCE_API_KEY}' \
...
A public API key is available for testing purposes with limited usage: f9703eaqsbma20tmtphg2jirm0hk8z8v2hkodrfrvhfm6ziesi7p38u991bnih5f
.
All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.
Learn how to generate API access tokens at OneBalance Docs.
Query Parameters
Additional token assetIds to include, separated by commas
"eip155:1/erc20:0xae7ab96520de3a18e5e111b5eaab095312d7fe84"
The address for which to retrieve the balance (e.g., 0x123...)
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
Response
Successfully retrieved aggregated balance
The response is of type object
.