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

Path Parameters

walletAddress

string

REQUIRED

Loading...

Query Parameters

quote-currency

string

Loading...

Returns

Loading...

Request

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

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

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

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

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

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

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

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

1
import requests
2
import json
3

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

6
payload = {}
7
headers = {
8
  'Content-Type': 'application/json',
9
  'Authorization': 'Bearer YOUR_API_KEY'
10
}
11

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

14
print(response.text)
15

1
import requests
2
import json
3

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

6
payload = {}
7
headers = {
8
  'Content-Type': 'application/json',
9
  'Authorization': 'Bearer YOUR_API_KEY'
10
}
11

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

14
print(response.text)
15

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

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

14
response = https.request(request)
15
puts response.read_body
16

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

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

14
response = https.request(request)
15
puts response.read_body
16

Response

1
{
2
  "data": {
3
    "address": "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl",
4
    "updated_at": "2025-04-27T23:36:11.208084546Z",
5
    "next_update_at": "2025-04-27T23:41:11.208085156Z",
6
    "quote_currency": "USD",
7
    "chain_id": 20090103,
8
    "chain_name": "btc-mainnet",
9
    "items": [
10
      {
11
        "contract_decimals": 8,
12
        "contract_name": "Bitcoin",
13
        "contract_ticker_symbol": "BTC",
14
        "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
15
        "supports_erc": null,
16
        "logo_url": "https://www.datocms-assets.com/86369/1674516379-property-1-bitcoin-colour.png",
17
        "contract_display_name": "Bitcoin",
18
        "logo_urls": null,
19
        "last_transferred_at": "2022-11-28T21:04:01Z",
20
        "block_height": null,
21
        "native_token": true,
22
        "type": "dust",
23
        "is_spam": false,
24
        "balance": "0",
25
        "balance_24h": "0",
26
        "quote_rate": 93846.05,
27
        "quote_rate_24h": 94657.27,
28
        "quote": 0,
29
        "pretty_quote": "$0.00",
30
        "quote_24h": 0,
31
        "pretty_quote_24h": "$0.00",
32
        "protocol_metadata": null,
33
        "nft_data": null
34
      }
35
    ],
36
    "pagination": null
37
  },
38
  "error": false,
39
  "error_message": null,
40
  "error_code": null
41
}

1
{
2
  "data": {
3
    "address": "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl",
4
    "updated_at": "2025-04-27T23:36:11.208084546Z",
5
    "next_update_at": "2025-04-27T23:41:11.208085156Z",
6
    "quote_currency": "USD",
7
    "chain_id": 20090103,
8
    "chain_name": "btc-mainnet",
9
    "items": [
10
      {
11
        "contract_decimals": 8,
12
        "contract_name": "Bitcoin",
13
        "contract_ticker_symbol": "BTC",
14
        "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
15
        "supports_erc": null,
16
        "logo_url": "https://www.datocms-assets.com/86369/1674516379-property-1-bitcoin-colour.png",
17
        "contract_display_name": "Bitcoin",
18
        "logo_urls": null,
19
        "last_transferred_at": "2022-11-28T21:04:01Z",
20
        "block_height": null,
21
        "native_token": true,
22
        "type": "dust",
23
        "is_spam": false,
24
        "balance": "0",
25
        "balance_24h": "0",
26
        "quote_rate": 93846.05,
27
        "quote_rate_24h": 94657.27,
28
        "quote": 0,
29
        "pretty_quote": "$0.00",
30
        "quote_24h": 0,
31
        "pretty_quote_24h": "$0.00",
32
        "protocol_metadata": null,
33
        "nft_data": null
34
      }
35
    ],
36
    "pagination": null
37
  },
38
  "error": false,
39
  "error_message": null,
40
  "error_code": null
41
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free