Path Parameters

chainName

string

REQUIRED

The chain name eg: base-mainnet

walletAddress

string

REQUIRED

The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically

Query Parameters

quote-currency

string

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

block-height

integer

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

Returns

data

object

The response data containing following fields:

address

string

The blockchain address for which token data is retrieved

updated_at

string

The timestamp when the data was last updated

quote_currency

string

The currency used for quoting values

chain_id

integer

The ID of the blockchain network

chain_name

string

The name of the blockchain network

items

array

An array of token balance items

contract_decimals

integer

The number of decimals used by the token contract

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

A list of supported ERC standards for the token

logo_url

string

The URL of the token's logo

block_height

integer

The height of the block where the token balance was retrieved

balance

string

The token balance associated with the address

quote_rate

integer

The quoted rate of the token in the specified currency

quote

integer

The quoted value of the token balance in the specified currency

pretty_quote

string

A formatted string of the quoted value of the token balance

error

boolean

Indicates whether an error occurred

error_message

string

The error message if an error occurred, or null otherwise

error_code

string

The error code if an error occurred, or null otherwise

Request

1
curl --location 'https://api.covalenthq.com/v1/base-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'

1
curl --location 'https://api.covalenthq.com/v1/base-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/' \
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/base-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/", 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/base-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/", 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/base-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/"
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/base-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/"
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/base-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/")
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/base-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/")
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