GET
/
addresses
/
balances
Account & Token Balances Latest Batch - Multiple Wallets
curl --request GET \
  --url https://api.amberdata.com/blockchains/addresses/balances \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "totalRecords": 2,
    "records": [
      {
        "address": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
        "balance": "59778459582703547487",
        "balanceIn": "2.875808647567209816669e+22",
        "balanceOut": "2.8698308016089394619203e+22",
        "price": {
          "balance": {
            "currency": "usd",
            "quote": "241.562150842",
            "total": "14129.3470847396809724208003882"
          }
        },
        "tokens": [
          {
            "address": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
            "amount": "187720361680000000000",
            "decimals": 18,
            "milliseconds": 1559665587000,
            "name": "Maker",
            "symbol": "MKR",
            "timestamp": 1559665587000,
            "price": {
              "amount": {
                "currency": "usd",
                "quote": "680.815866247",
                "total": "127803.0006493693442149600000000"
              }
            }
          }
        ]
      }
    ]
  }
}

Authorizations

x-api-key
string
header
required

Headers

x-amberdata-blockchain-id
enum<string>
default:ethereum-mainnet

The id of the blockchain

Available options:
bitcoin-mainnet,
bitcoin-abc-mainnet,
ethereum-mainnet,
litecoin-mainnet,
polygon-mainnet

Query Parameters

addresses
string
default:0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE,0xF02e86D9E0eFd57aD034FaF52201B79917fE0713
required

A comma separated list of addresses. NOTE: Max 200 addresses per request!

blockNumber
string

Get balances for addresses at a specific block height. (NOTE: does not support token holdings for Ethereum at this time.)

includePrice
boolean
default:false

Indicates whether or not to include price data with the results. Options: true, false.

currency
string

The currency of the price information (usd or btc.) - only used in conjunction with includePrice.

timeFormat
string

[Optional] Time format of the timestamps in the return payload.<BR/>[Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Response

200
application/json

OK

The response is of type object.