> ## Documentation Index > Fetch the complete documentation index at: https://docs.amberdata.io/llms.txt > Use this file to discover all available pages before exploring further. # Account & Token Balances Latest Batch - Multiple Wallets > Retrieves the latest account and token balances for the specified addresses. This is useful if you want to get an entire portfolio's summary in a single call. Get totals for ETH & all token amounts with market prices. ## OpenAPI ````yaml get /addresses/balances openapi: 3.1.0 info: title: blockchain-api version: '2' servers: - url: https://api.amberdata.com/blockchains security: - sec0: [] paths: /addresses/balances: get: summary: Account & Token Balances Latest Batch - Multiple Wallets description: >- Retrieves the latest account and token balances for the specified addresses. This is useful if you want to get an entire portfolio's summary in a single call. Get totals for ETH & all token amounts with market prices. operationId: address-balances-batch parameters: - name: addresses in: query description: >- A comma separated list of addresses. NOTE: Max 200 addresses per request! required: true schema: type: string default: >- 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE,0xF02e86D9E0eFd57aD034FaF52201B79917fE0713 - name: blockNumber in: query description: >- Get balances for addresses at a specific block height. (NOTE: does not support token holdings for Ethereum at this time.) schema: type: string - name: includePrice in: query description: >- Indicates whether or not to include price data with the results. Options: true, false. schema: type: boolean default: false - name: currency in: query description: >- The currency of the price information (usd or btc.) - only used in conjunction with includePrice. schema: type: string - name: timeFormat in: query description: >- **[Optional]** Time format of the timestamps in the return payload.
**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable` schema: type: string - name: x-amberdata-blockchain-id in: header description: The id of the blockchain schema: type: string enum: - bitcoin-mainnet - bitcoin-abc-mainnet - ethereum-mainnet - litecoin-mainnet - polygon-mainnet default: ethereum-mainnet responses: '200': description: OK content: application/json: schema: type: object properties: status: type: integer description: HTTP status code title: type: string description: Status title description: type: string description: Status description payload: type: object description: >- Map of blockchain addresses to their balance and token information additionalProperties: type: object properties: balance: type: string description: Current balance in wei/base units as a string balanceIn: type: string description: Total balance inflow in wei/base units as a string balanceOut: type: string description: Total balance outflow in wei/base units as a string price: type: object required: - balance properties: balance: type: object description: Contains price details for the main balance. required: - currency - quote - total properties: currency: type: string description: >- The currency of the price information (e.g., 'usd'). quote: type: string description: >- The price per unit of the native blockchain currency. total: type: string description: >- The total value of the main balance in the specified currency. tokens: type: array description: Array of token holdings for this address items: type: object properties: decimals: type: integer description: >- Number of decimal places for the token (can be -1 for invalid/unknown tokens) name: type: string description: Human-readable name of the token symbol: type: string description: Token symbol or ticker amount: type: string description: Token amount held in base units as a string timestamp: type: string format: date-time description: ISO 8601 timestamp of the last balance update address: type: string description: Ethereum contract address of the token required: - decimals - name - symbol - amount - timestamp - address required: - balance - balanceIn - balanceOut - tokens required: - status - title - description - payload example: 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' '401': description: '401' content: text/plain: examples: Result: value: Unauthorized '404': description: '404' content: text/plain: examples: Address Not Found: value: Unknown address or address is not a contract deprecated: false security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ````