v1/btc-mainnet/address/{walletAddress}/balances_v2/ REST API Endpoint

Path Parameters

walletAddress

string

REQUIRED

The wallet address for which the balances are to be retrieved

Query Parameters

quote-currency

string

The currency to quote the balance values in (e.g., USD, EUR)

Returns

Request

curl --location 'https://api.covalenthq.com/v1/btc-mainnet/address/bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl/balances_v2/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://api.covalenthq.com/v1/btc-mainnet/address/bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl/balances_v2/", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

import requests
import json

url = "https://api.covalenthq.com/v1/btc-mainnet/address/bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl/balances_v2/"

payload = {}
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://api.covalenthq.com/v1/btc-mainnet/address/bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl/balances_v2/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer YOUR_API_KEY"

response = https.request(request)
puts response.read_body

Response

{
  "data": {
    "address": "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl",
    "updated_at": "2025-04-29T21:10:44.371073760Z",
    "next_update_at": "2025-04-29T21:15:44.371074800Z",
    "quote_currency": "USD",
    "chain_id": 20090103,
    "chain_name": "btc-mainnet",
    "items": [
      {
        "contract_decimals": 8,
        "contract_name": "Bitcoin",
        "contract_ticker_symbol": "BTC",
        "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "supports_erc": null,
        "logo_url": "https://www.datocms-assets.com/86369/1674516379-property-1-bitcoin-colour.png",
        "contract_display_name": "Bitcoin",
        "logo_urls": null,
        "last_transferred_at": "2022-11-28T21:04:01Z",
        "block_height": null,
        "native_token": true,
        "type": "dust",
        "is_spam": false,
        "balance": "0",
        "balance_24h": "0",
        "quote_rate": 94923.125,
        "quote_rate_24h": 95031.74,
        "quote": 0,
        "pretty_quote": "$0.00",
        "quote_24h": 0,
        "pretty_quote_24h": "$0.00",
        "protocol_metadata": null,
        "nft_data": null
      }
    ],
    "pagination": null
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free