GET /v1/btc-mainnet/address/:walletAddress/historical_balances — goldrush-multichain-data-apis

latestOpenAPI 3.1.02026-08-0837114837.8 KB

c099830c76a0

check-ownership-in-nft-collection1

check-ownership-in-nft-collection-token1

get-a-block1

get-a-transaction1

get-address-activity1

get-all-chain-statuses1

get-all-chains1

get-all-transactions-in-a-block2

get-all-transactions-in-a-block-by-page1

get-allchains-balances1

get-allchains-transactions1

get-bitcoin-balance-for-address1

get-bitcoin-balances-for-hd-address1

get-block-heights1

get-earliest-transactions-for-address-v31

get-erc20-token-transfers-for-address1

get-gas-prices1

get-historical-bitcoin-balance-for-address1

get/v1/btc-mainnet/address/{walletAddress}/historical_balances/

get-historical-portfolio-value-over-time1

get-historical-token-balances-for-address1

get-historical-token-prices1

get-log-events-by-contract-address1

get-log-events-by-topic-hash1

get-logs1

get-native-token-balance1

get-nfts-for-address1

get-paginated-transactions-for-address-v31

get-pool-spot-prices1

get-recent-transactions-for-address-v31

get-resolved-address-for-registered-address1

get-time-bucket-transactions-for-address-v31

get-token-approvals-for-address1

get-token-balances-for-address1

get-token-holders-as-of-any-block-height-v21

get-transaction-summary-for-address1

get-transactions-for-bitcoin-address1

get-historical-bitcoin-balance-for-address

Commonly used to fetch the historical Bitcoin balance held by an address at a given block height or date. Response includes daily prices and other metadata.

get/v1/btc-mainnet/address/{walletAddress}/historical_balances/

Path parameters

walletAddressstring required

Only Bitcoin non-HD addresses are supported.

Query parameters

quote-currencystring

The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP.

block-heightinteger

Ending block to define a block range. Omitting this parameter defaults to the latest block height.

datestring

Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.

Response

Successful response

addressstring

The requested address.

updated_atstring date-time

The timestamp when the response was generated. Useful to show data staleness to users.

quote_currencystring

The requested quote currency eg: USD.

chain_idinteger

The requested chain ID eg: 1.

chain_namestring

The requested chain name eg: eth-mainnet.

chain_tip_heightinteger

The latest block height of the blockchain at the time this response was provided.

chain_tip_signed_atstring date-time

The timestamp of the latest signed block at the time this response was provided.