Skip to main content

Get ETH balances

Retrieves the ETH balances for one or multiple wallet addresses.
This endpoint allows you to check how much Ether (ETH) each specified blockchain address holds.

📘 Learn more about natural units of measure and Sparks.

Request Endpoint:

GET /odata/v1.0/Balances/GetEthBalances(addresses={addresses})

Parameters​

ParameterTypeDescriptionMandatory
addressesarray[string]List of wallet addresses for which ETH balances will be retrieved.✅

Example Request:​

GET /Balances/GetEthBalances(
addresses=['0x5833bbfd8ce0192cf3bb4e7501148d9cd47f5c91','0x9f114da25b61b77606d47eab414b9360f8783979']
)

Response Body​

application/json — Returns a list of ETH balances for the requested addresses.

ParameterDescription
AddressThe blockchain address for which the ETH balance is returned.
AmountThe ETH balance held at the specified address.

Example Response Body:​

[
{
"Address": "0x5833bbfd8ce0192cf3bb4e7501148d9cd47f5c91",
"Amount": "0.5421"
},
{
"Address": "0x9f114da25b61b77606d47eab414b9360f8783979",
"Amount": "12.0315"
}
]

Response Codes​

CodeDescription
200Balances successfully retrieved.
401Unauthorized.