List Wallets: GET /dac/v1/wallets for a Given Asset

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

string

required

Your Finrock API key.

string

required

Your JWT bearer token in the format Bearer {JWT}.

string

required

The asset name for which to retrieve wallets (e.g. BTC, ETH). Must match a value from the Supported Assets list.

Example Request

cURL

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.

string

Unique Finrock identifier for the wallet.

string

The asset ticker associated with this wallet (e.g. BTC).

number

Current spendable balance of the wallet, expressed in the asset’s native unit.

number

Total balance held across all omnibus addresses linked to this wallet.

string

Wallet status. Typical values: active, inactive.

string

ISO 8601 timestamp of when the wallet was created.

Sample 200 Response

[
  {
    "id": "wlt_abc123",
    "asset": "BTC",
    "balance": 1.25340000,
    "omnibus_balance": 0.85000000,
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z"
  }
]

object

Returned when the x-api-key or Authorization header is missing or invalid.

Sample 401 Response

{
  "error": "Unauthorized",
  "message": "Invalid or missing authentication credentials."
}

Overview

Wallets & Addresses

Transactions

Gas Tanks

Exchanges

AML

Invoicing

Utilities

List Wallets: GET /dac/v1/wallets for a Given Asset

Request

Example Request

Response

​Request

​Example Request

​Response

Request

Example Request

Response