---
title: "GET /v1/btc-mainnet/address/{walletAddress}/hd_wallets/"
method: GET
path: "/v1/btc-mainnet/address/{walletAddress}/hd_wallets/"
tags: ["get-bitcoin-balances-for-hd-address"]
---

# GET /v1/btc-mainnet/address/{walletAddress}/hd_wallets/

`GET /v1/btc-mainnet/address/{walletAddress}/hd_wallets/`

Fetch balances for each active child address derived from a Bitcoin HD wallet.

## Path parameters

- `walletAddress` string, required

## Query parameters

- `quote-currency` string

## Response `200`

Successful response

- object
  - `address` string — The extended public key (xPub/yPub/zPub) or HD wallet address.
  - `chain_id` integer — The requested chain ID eg: `20090103`.
  - `chain_name` string — The requested chain name eg: `btc-mainnet`.
  - `chain_tip_height` integer — The latest block height of the blockchain at the time this response was provided.
  - `chain_tip_signed_at` string, date-time — The timestamp of the latest signed block at the time this response was provided.
  - `quote_currency` string — The requested quote currency eg: `USD`.
  - `updated_at` string, date-time — The timestamp when the response was generated. Useful to show data staleness to users.
  - `items` object[] — List of HD wallet balance items, each containing derived addresses and balances.
    - `child_address` string — The specific Bitcoin address derived from the HD wallet.
    - `address_path` string — Derivation path used to derive the specific Bitcoin address, e.g., `M/0H/0/0`.
    - `contract_decimals` integer — Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`.
    - `contract_name` string — The name of the token, e.g., `Bitcoin`.
    - `contract_ticker_symbol` string — The ticker symbol for the token, e.g., `BTC`.
    - `contract_address` string — Address placeholder for native tokens like BTC.
    - `contract_display_name` string — A display-friendly name for the token, e.g., `Bitcoin`.
    - `supports_erc` string[] — Typically null for Bitcoin, but left for compatibility.
    - `logo_urls` object — The contract logo URLs.
      - `token_logo_url` string — The token logo URL.
      - `protocol_logo_url` string — The protocol logo URL.
      - `chain_logo_url` string — The chain logo URL.
    - `last_transferred_at` string, date-time — The timestamp when the token was last transferred.
    - `is_native_token` boolean — Indicates if a token is the chain's native gas token, eg: BTC on Bitcoin.
    - `type` string — One of `cryptocurrency`, `stablecoin`, `nft` or `dust`.
    - `is_spam` boolean — Denotes whether the token is suspected spam.
    - `balance` string — b;The asset balance. Use `contract_decimals` to scale this balance for display purposes.
    - `balance_24h` string — b;The 24h asset balance. Use `contract_decimals` to scale this balance for display purposes.
    - `quote_rate` number, double — The exchange rate for the requested quote currency.
    - `quote_rate_24h` number, double — The 24h exchange rate for the requested quote currency.
    - `quote` number, double — The current balance converted to fiat in `quote-currency`.
    - `quote_24h` number, double — The 24h balance converted to fiat in `quote-currency`.
    - `pretty_quote` string — A prettier version of the quote for rendering purposes.
    - `pretty_quote_24h` string — A prettier version of the 24h quote for rendering purposes.

---

[API](https://skmtc.net/covalenthq/apis/goldrush-multichain-data-apis.md) · [All operations](https://skmtc.net/covalenthq/apis/goldrush-multichain-data-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/covalenthq/goldrush-multichain-data-apis/revisions/c099830c76a0/schema)