List Wallets - Finrock

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'

[
  {
    "asset": "BTC",
    "asset_ticker": "BTC",
    "is_frozen": false,
    "balance": {
      "available": 0.025,
      "unconfirmed": 0.001,
      "frozen": 0.005
    },
    "forwarding": {
      "status": "ACTIVE",
      "address": "bc1qexample123456789",
      "frequency": "Nightly"
    },
    "wallet_type": "Legacy",
    "status": "Created",
    "requires_dt_memo": {
      "enabled": true,
      "change": "APPROVED"
    }
  }
]

GET

dac

wallets

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'

[
  {
    "asset": "BTC",
    "asset_ticker": "BTC",
    "is_frozen": false,
    "balance": {
      "available": 0.025,
      "unconfirmed": 0.001,
      "frozen": 0.005
    },
    "forwarding": {
      "status": "ACTIVE",
      "address": "bc1qexample123456789",
      "frequency": "Nightly"
    },
    "wallet_type": "Legacy",
    "status": "Created",
    "requires_dt_memo": {
      "enabled": true,
      "change": "APPROVED"
    }
  }
]

MCP scope: dac.read

Query Parameters

string

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

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

The asset name of the wallet (e.g. BTC).

string

The ticker symbol of the asset (e.g. BTC).

boolean

Whether the wallet is frozen.

object

The wallet’s balances, in the asset’s native unit.

Show properties

number

Balance available to spend.

number

Balance from incoming transactions that are not yet confirmed on-chain.

number

Amount of the balance that is currently frozen.

object

Auto-forwarding configuration for the wallet.

Show properties

string

Auto-forwarding status: NONE, PENDING_OWNER_APPROVAL or ACTIVE. See Edit Wallet.

string | null

Destination address funds are forwarded to, or null if not set.

string

How often funds are forwarded.

string

The type of wallet: Legacy, HSM or MPC. See Wallet Types.

string

The wallet’s status: Creating while it’s being set up, Created when it’s ready, or Failed.

object

XRP wallets only. Whether the XRP Ledger rejects deposits to this wallet that don’t include a destination tag. Change it with Edit Wallet.

Show properties

boolean

true if deposits without a destination tag are rejected. Defaults to false. While a change is pending, this already shows the new value; check change to see whether it has been approved.

string

State of the latest change to this setting: APPROVED, or PENDING_OWNER_APPROVAL while it waits for the owner, or at least 2 admins, to approve it in the dashboard.

[
  {
    "asset": "BTC",
    "asset_ticker": "BTC",
    "is_frozen": false,
    "balance": {
      "available": 0.025,
      "unconfirmed": 0.001,
      "frozen": 0.005
    },
    "forwarding": {
      "status": "ACTIVE",
      "address": "bc1qexample123456789",
      "frequency": "Nightly"
    },
    "wallet_type": "Legacy",
    "status": "Created",
    "requires_dt_memo": {
      "enabled": true,
      "change": "APPROVED"
    }
  }
]