Wallet Addresses

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

[
  {
    "index": 0,
    "address": "bc1q5ssk0exna3knfvm9qu2hs6f3rexjsw3qxs3zf6",
    "legacy_address": "1CVA1kJrgu66eiuAMN5Z1NQ3sbsLqeNSpb",
    "address_tag": "",
    "label": "Main Address",
    "omnibus": true,
    "auto_refill": false,
    "balance": 0.14502196,
    "u_balance": 0.00000000,
    "f_balance": 0.00000000,
    "is_frozen": false,
    "blacklisted": false,
    "is_dust": false
  },
  {
    "index": 1,
    "address": "bc1q4seeq7pj8hpjxqkmapl4ljdx0wjlygqp8zq3x0",
    "legacy_address": "1GhWzkMqEFo2F5Az5b7yabpx5vPNvnggH8",
    "address_tag": "",
    "label": "Invoices for customer 8",
    "omnibus": true,
    "auto_refill": true,
    "balance": 0.0,
    "u_balance": 0.00000000,
    "f_balance": 0.00000000,
    "is_frozen": false,
    "blacklisted": false,
    "is_dust": false
  }
]

GET

dac

addresses

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

[
  {
    "index": 0,
    "address": "bc1q5ssk0exna3knfvm9qu2hs6f3rexjsw3qxs3zf6",
    "legacy_address": "1CVA1kJrgu66eiuAMN5Z1NQ3sbsLqeNSpb",
    "address_tag": "",
    "label": "Main Address",
    "omnibus": true,
    "auto_refill": false,
    "balance": 0.14502196,
    "u_balance": 0.00000000,
    "f_balance": 0.00000000,
    "is_frozen": false,
    "blacklisted": false,
    "is_dust": false
  },
  {
    "index": 1,
    "address": "bc1q4seeq7pj8hpjxqkmapl4ljdx0wjlygqp8zq3x0",
    "legacy_address": "1GhWzkMqEFo2F5Az5b7yabpx5vPNvnggH8",
    "address_tag": "",
    "label": "Invoices for customer 8",
    "omnibus": true,
    "auto_refill": true,
    "balance": 0.0,
    "u_balance": 0.00000000,
    "f_balance": 0.00000000,
    "is_frozen": false,
    "blacklisted": false,
    "is_dust": false
  }
]

MCP scope: dac.read 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 balances. Pass the optional index, address, or label query parameters to narrow the response.

Query Parameters

string

required

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

string

Optional. Filter the response to the address at this index (e.g. 0).

string

Optional. Filter the response to a single address. When provided, the API returns only the record matching this exact address string.

string

Optional. Filter the response by address label.

curl --request GET \
     --url 'https://api.finrock.io/dac/v1/addresses?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 address objects.

integer

Index of the address within the wallet. The main address has index 0.

string

The blockchain deposit address string.

string

The same address in legacy format, where applicable (e.g. a 1... address for BTC).

string

Destination tag or memo associated with the address, where applicable (e.g. XRP, XLM). Empty string when not used.

string

The human-readable label assigned to this address.

boolean

true if this address belongs to the shared omnibus pool; false if it is an isolated address.

boolean

true if gas is automatically funded from the Gas Tank when the address balance is insufficient.

number

Current asset balance held at this address, in the asset’s native unit.

number

Unconfirmed balance from incoming transactions not yet confirmed on-chain.

number

Frozen balance at this address.

boolean

Whether the address is frozen.

boolean

Whether the address is blacklisted.

boolean

Whether the address balance is considered dust.

[
  {
    "index": 0,
    "address": "bc1q5ssk0exna3knfvm9qu2hs6f3rexjsw3qxs3zf6",
    "legacy_address": "1CVA1kJrgu66eiuAMN5Z1NQ3sbsLqeNSpb",
    "address_tag": "",
    "label": "Main Address",
    "omnibus": true,
    "auto_refill": false,
    "balance": 0.14502196,
    "u_balance": 0.00000000,
    "f_balance": 0.00000000,
    "is_frozen": false,
    "blacklisted": false,
    "is_dust": false
  },
  {
    "index": 1,
    "address": "bc1q4seeq7pj8hpjxqkmapl4ljdx0wjlygqp8zq3x0",
    "legacy_address": "1GhWzkMqEFo2F5Az5b7yabpx5vPNvnggH8",
    "address_tag": "",
    "label": "Invoices for customer 8",
    "omnibus": true,
    "auto_refill": true,
    "balance": 0.0,
    "u_balance": 0.00000000,
    "f_balance": 0.00000000,
    "is_frozen": false,
    "blacklisted": false,
    "is_dust": false
  }
]