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

data

object

The main object containing details about the queried Bitcoin transactions

address

string

The queried Bitcoin address

updated_at

string

The timestamp when the data was last updated

next_update_at

string

The timestamp for the next scheduled update

quote_currency

string

The currency in which the values are quoted

chain_id

integer

The unique ID of the blockchain

chain_name

string

The name of the blockchain

items

array

An array of objects containing information about the tokens or transactions associated with the address

contract_decimals

integer

The number of decimal places used by the token

contract_name

string

The name of the token contract

contract_ticker_symbol

string

The ticker symbol of the token contract

contract_address

string

The address of the token contract

supports_erc

array

An array listing the supported ERC standards, if applicable

logo_url

string

The URL to the token's logo

contract_display_name

string

The display name of the token contract

logo_urls

object

An object of URLs to different logo variations of the token

token_logo_url

string

The URL of the token's logo

protocol_logo_url

string

The URL of the protocol's logo, if available

chain_logo_url

string

The URL of the chain's logo

last_transferred_at

string

The timestamp when the token was last transferred

native_token

boolean

Indicates if the token is the native currency of the blockchain

type

string

The type of the token or transaction

is_spam

boolean

Indicates if the token is considered spam

balance

string

The balance of the token

balance_24h

string

The balance of the token 24 hours ago

quote_rate

float

The current quoted rate for the token in the given currency

quote_rate_24h

float

The quoted rate for the token in the given currency 24 hours ago

quote

float

The total quote value of the balance in the given currency

pretty_quote

string

The human-readable format of the quote value

quote_24h

float

The total quote value 24 hours ago in the given currency

pretty_quote_24h

string

The human-readable format of the quote value 24 hours ago

protocol_metadata

string

Any additional metadata related to the protocol

nft_data

string

NFT data associated with the token, if applicable

pagination

object

The pagination details for the response

has_more

boolean

The flag indicating if there are more pages of data

page_number

integer

The current page number

page_size

integer

The number of items per page

total_count

integer

The total number of items (nullable)

error

boolean

Indicates whether an error occurred

error_message

string

The error message, if any

error_code

string

The error code, if any

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free