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​
| Parameter | Type | Description | Mandatory |
|---|---|---|---|
| addresses | array[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.
| Parameter | Description |
|---|---|
| Address | The blockchain address for which the ETH balance is returned. |
| Amount | The ETH balance held at the specified address. |
Example Response Body:​
[
{
"Address": "0x5833bbfd8ce0192cf3bb4e7501148d9cd47f5c91",
"Amount": "0.5421"
},
{
"Address": "0x9f114da25b61b77606d47eab414b9360f8783979",
"Amount": "12.0315"
}
]
Response Codes​
| Code | Description |
|---|---|
| 200 | Balances successfully retrieved. |
| 401 | Unauthorized. |