> For the complete documentation index, see [llms.txt](https://dipe.gitbook.io/dipe-protocol-on-dogecoin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dipe.gitbook.io/dipe-protocol-on-dogecoin/api-endpoints/retrieve-wallet-balance.md).

# Retrieve Wallet Balance

### Endpoint

`GET /wallet/{ADDRESS}`

### Description

This endpoint returns the current balance of all tokens associated with the given address.

### Parameters

* `{ADDRESS}`: The Dogecoin address to query (required)

### Example Request

```
GET https://dipe-chain-api-bf9e112f1ffc.herokuapp.com/wallet/DCAPHDbvxPQ5zsnKVg2wQteUNYFv1wiRqN
```

### Example Response

```json
{
  "_id": "667f9bcc1bf05bf15ffbb9ab",
  "walletId": "DCAPHDbvxPQ5zsnKVg2wQteUNYFv1wiRqN",
  "__v": 0,
  "tokens": {
    "dipe": 71463,
    "poge": 200,
  }
}
```

### Response Fields

* `_id`: Unique identifier for the wallet record
* `walletId`: The Dogecoin address queried
* `__v`: Version key (internal use)
* `tokens`: Object containing token balances
  * Each key is a token identifier
  * Each value is the current balance of that token

### Notes

* This endpoint provides a quick way to retrieve the total balance for each token associated with an address.
* The balance shown here is the sum of all valid UTXOs for each token.
* For detailed transaction history or individual UTXO information, use the Address Events endpoint.