> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.finrock.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Addresses: GET /dac/v1/addresses for an Asset

> Retrieve all deposit addresses for a given asset in your Finrock sub-account. Filter by address string to inspect a single address record.

The List Addresses endpoint returns all deposit addresses generated for a given asset in your sub-account. Each record includes the address string, its label, omnibus flag, auto-refill setting, and current balance. Pass the optional `address` query parameter to narrow the response to a single address — useful for checking the state of a specific deposit destination.

## Request

<ParamField header="x-api-key" type="string" required>
  Your Finrock API key.
</ParamField>

<ParamField header="Authorization" type="string" required>
  Your JWT bearer token in the format `Bearer {JWT}`.
</ParamField>

<ParamField query="asset" type="string" required>
  The asset name for which to list addresses (e.g. `ETH`, `BTC`). Must match a value from the [Supported Assets](/api-reference/utilities/supported-assets) list.
</ParamField>

<ParamField query="address" type="string">
  Optional. Filter the response to a single address. When provided, the API returns only the record matching this exact address string.
</ParamField>

## Example Request

```bash cURL theme={null}
curl --request GET \
     --url 'https://api.finrock.io/dac/v1/addresses?asset=ETH' \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
```

## Response

A successful request returns HTTP `200` with an array of address objects. When the `address` filter is applied, the array contains at most one element.

<ResponseField name="address" type="string">
  The blockchain deposit address string.
</ResponseField>

<ResponseField name="address_tag" type="string">
  Destination tag or memo associated with the address, where applicable (e.g. XRP, XLM).
</ResponseField>

<ResponseField name="label" type="string">
  The human-readable label assigned to this address at creation time.
</ResponseField>

<ResponseField name="omnibus" type="boolean">
  `true` if this address belongs to the shared omnibus pool; `false` if it is an isolated address.
</ResponseField>

<ResponseField name="auto_refill" type="boolean">
  `true` if gas is automatically funded from the Gas Tank when the address balance is insufficient.
</ResponseField>

<ResponseField name="balance" type="number">
  Current asset balance held at this address, in the asset's native unit.
</ResponseField>

```json Sample 200 Response theme={null}
[
  {
    "address": "0xA1b2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0",
    "address_tag": null,
    "label": "customer-deposit-001",
    "omnibus": false,
    "auto_refill": true,
    "balance": 0.50000000
  },
  {
    "address": "0xB2c3D4e5F6a7B8c9D0e1F2a3B4c5D6e7F8a9B0c1",
    "address_tag": null,
    "label": "omnibus-pool",
    "omnibus": true,
    "auto_refill": true,
    "balance": 12.34000000
  }
]
```

<ResponseField name="401" type="object">
  Returned when the `x-api-key` or `Authorization` header is missing or invalid.
</ResponseField>

```json Sample 401 Response theme={null}
{
  "error": "Unauthorized",
  "message": "Invalid or missing authentication credentials."
}
```