# GET /balance
**Get confirmed and unconfirmed balance**

Returns confirmed and unconfirmed balance for one or more Bitcoin addresses or xpubs. All values are in satoshis.

Authentication: Bearer token required (Authorization: Bearer YOUR_API_KEY)

## Query Parameters
- `addr` — string (required): Whitespace-separated list of Bitcoin addresses and/or xpubs. A `+` or `%20` may also be used as a separator.

## Responses
- 200: Balance response.
  - `response` (array)
- 400: Invalid xPub(s) or address(es) provided
  - `status` (integer)
  - `error` (object)
- 401: This function requires you to login
  - `message` (string): Error message
- 404: No match found for one or more of the provided xPub(s) or address(es)
  - `status` (integer)
  - `error` (object)

Full reference: https://developers.blockonomics.co/docs/search/getbalance