Path Parameters

walletAddress

string

REQUIRED

The wallet address to fetch token balances for

Query Parameters

chains

string

A comma-separated list of chain names or IDs to retrieve token balances from. Defaults to all foundational chains

limit

integer

The maximum number of token balances to return per page, up to 100

before

string

Pagination cursor pointing to fetch token balances before a certain point in time

cutoff-timestamp

integer

The timestamp to filter balances updated before this time

quote-currency

string

The currency in which to return token quotes

Returns

data

object

The main container for the asset data

updated_at

string

The timestamp when the data was last updated

cursor_before

string

Cursor pointing to the position before the current page of data

quote_currency

string

The currency used for quoting values

items

array

A list of asset 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

contract_display_name

string

The display name of the token contract

logo_urls

object

URLs of logos associated with 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 of the last transfer involving the token

type

string

The type of asset (e.g., cryptocurrency or dust)

is_spam

boolean

Indicates whether the asset is flagged as spam

balance

string

The current balance of the token

balance_24h

string

The balance of the token 24 hours ago

quote_rate

number

The quoted rate of the token in the specified currency

quote_rate_24h

number

The quoted rate of the token 24 hours ago in the specified currency

quote

number

The current value of the token in the specified currency

pretty_quote

string

A formatted string of the current token value

quote_24h

number

The token value 24 hours ago in the specified currency

pretty_quote_24h

string

A formatted string of the token value 24 hours ago

chain_id

string

The ID of the blockchain network

chain_name

string

The name of the blockchain network

chain_display_name

string

The display name of the blockchain network

is_native_token

boolean

Indicates if the token is the native token of the blockchain

error

boolean

Indicates if an error occurred during the request

error_message

string

The error message, if applicable

error_code

integer

The error code, if applicable

Request

1
curl --location 'https://api.covalenthq.com/v1/allchains/address/0xF977814e90dA44bFA03b6295A0616a897441aceC/balances/?chains=base-mainnet&limit=10' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'

1
curl --location 'https://api.covalenthq.com/v1/allchains/address/0xF977814e90dA44bFA03b6295A0616a897441aceC/balances/?chains=base-mainnet&limit=10' \
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/allchains/address/0xF977814e90dA44bFA03b6295A0616a897441aceC/balances/?chains=base-mainnet&limit=10", 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/allchains/address/0xF977814e90dA44bFA03b6295A0616a897441aceC/balances/?chains=base-mainnet&limit=10", 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/allchains/address/0xF977814e90dA44bFA03b6295A0616a897441aceC/balances/?chains=base-mainnet&limit=10"
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/allchains/address/0xF977814e90dA44bFA03b6295A0616a897441aceC/balances/?chains=base-mainnet&limit=10"
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/allchains/address/0xF977814e90dA44bFA03b6295A0616a897441aceC/balances/?chains=base-mainnet&limit=10")
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/allchains/address/0xF977814e90dA44bFA03b6295A0616a897441aceC/balances/?chains=base-mainnet&limit=10")
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