> ## 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 Wallets: GET /dac/v1/wallets for a Given Asset

> Retrieve all MPC wallets for a given asset in your Finrock sub-account, including current balances, wallet status, and configuration metadata.

The List Wallets endpoint returns all MPC wallets provisioned for a specific asset within your sub-account. Each wallet record includes its current balance, configuration flags, and associated metadata. Use this endpoint to audit wallet state or to discover wallet identifiers before generating addresses or submitting transactions.

## 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 retrieve wallets (e.g. `BTC`, `ETH`). Must match a value from the [Supported Assets](/api-reference/utilities/supported-assets) list.
</ParamField>

## Example Request

```bash cURL theme={null}
curl --request GET \
     --url 'https://api.finrock.io/dac/v1/wallets?asset=BTC' \
     --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 wallet objects.

<ResponseField name="id" type="string">
  Unique Finrock identifier for the wallet.
</ResponseField>

<ResponseField name="asset" type="string">
  The asset ticker associated with this wallet (e.g. `BTC`).
</ResponseField>

<ResponseField name="balance" type="number">
  Current spendable balance of the wallet, expressed in the asset's native unit.
</ResponseField>

<ResponseField name="omnibus_balance" type="number">
  Total balance held across all omnibus addresses linked to this wallet.
</ResponseField>

<ResponseField name="status" type="string">
  Wallet status. Typical values: `active`, `inactive`.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the wallet was created.
</ResponseField>

```json Sample 200 Response theme={null}
[
  {
    "id": "wlt_abc123",
    "asset": "BTC",
    "balance": 1.25340000,
    "omnibus_balance": 0.85000000,
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z"
  }
]
```

<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."
}
```