Skip to main content
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": {
    "0x3f7bb687ab9f04b055f4d326977f17471270499c": {
      "balance": "492231474000",
      "balanceIn": "3182796362466409764",
      "balanceOut": "3182795870234935764",
      "price": {
        "balance": {
          "currency": "usd",
          "quote": "3045.10978468",
          "total": "0.00149890"
        }
      },
      "tokens": [
        {
          "decimals": 18,
          "name": "Sign",
          "symbol": "SIGN",
          "amount": "21000000000000000000",
          "timestamp": "2025-06-17T13:39:11.000Z",
          "address": "0x868fced65edbf0056c4163515dd840e9f287a4c3"
        },
        {
          "decimals": 0,
          "name": "Seeing Signs",
          "symbol": "$IGN",
          "amount": "0",
          "timestamp": "2025-12-04T20:03:35.000Z",
          "address": "0xbc37ee54f066e79c23389c55925f877f79f3cb84"
        },
        {
          "decimals": 18,
          "name": "Wrapped Ether",
          "symbol": "WETH",
          "amount": "0",
          "timestamp": "2025-12-04T20:12:23.000Z",
          "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
        }
      ]
    },
    "0x3b0684dcfb5c0d50e75d512b4562b440c96a1b8d": {
      "balance": "197722156918921153",
      "balanceIn": "200000003000000006",
      "balanceOut": "2277846081078853",
      "tokens": [
        {
          "decimals": 18,
          "name": "Gemini3",
          "symbol": "Gemini3",
          "amount": "10000000000000000000",
          "timestamp": "2025-11-27T10:10:59.000Z",
          "address": "0xa62c5ef5dc67b6b38b3d14c79efca2c27eca8518"
        },
        {
          "decimals": 18,
          "name": "ePEPE",
          "symbol": "ePEPE",
          "amount": "20000000000000000000",
          "timestamp": "2025-11-27T10:10:59.000Z",
          "address": "0xdc5cb57711ac6ea18bc9e07404a3fa2a9b4913e9"
        },
        {
          "decimals": 18,
          "name": "SPX",
          "symbol": "SPX",
          "amount": "10000000000000000000",
          "timestamp": "2025-11-27T09:08:23.000Z",
          "address": "0xdd0d0781fd0045ccb8c4f56ab4229a37f8e86e42"
        }
      ]
    }
  }
}

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.
[Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Response

OK

status
integer
required

HTTP status code

title
string
required

Status title

description
string
required

Status description

payload
object
required

Map of blockchain addresses to their balance and token information