Path Parameters

chainName

string

REQUIRED

The chain name eg: eth-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 in which token values should be quoted

nft

boolean

Whether to include NFTs in the response

no-nft-fetch

boolean

Whether to exclude fetching NFT-related data

no-spam

boolean

Whether to exclude spam tokens from the response

no-nft-asset-metadata

boolean

Whether to exclude NFT asset metadata from the response

Returns

data

object

The response data containing following fields:

address

string

The wallet address for which the data is returned

chain_id

integer

The unique identifier of the blockchain network

chain_name

string

The name of the blockchain network

quote_currency

string

The currency used to quote the token values

updated_at

string

The timestamp when the data was last updated

items

array

An array of token balances or assets associated with the address

contract_decimals

integer

The number of decimals used in the token's contract

contract_name

string

The name of the token's contract

contract_ticker_symbol

string

The ticker symbol of the token

contract_address

string

The contract address of the token

contract_display_name

string

The display name of the token

supports_erc

string

A list of ERC standards supported by the token

logo_url

string

The URL of the token's logo

logo_urls

object

The object containing different logo URLs for the token

token_logo_url

string

The URL of the token's logo

protocol_logo_url

string

The URL of the protocol's logo

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

Whether the token is the native token of the blockchain

type

string

The type of the token, such as fungible or non-fungible

is_spam

boolean

Whether the token is flagged as spam

balance

string

The current balance of the token

balance24h

string

The balance of the token 24 hours ago

quote_rate

integer

The current price of the token in the quote currency

quote_rate24h

integer

The price of the token in the quote currency 24 hours ago

quote

integer

The current value of the token in the quote currency

quote24h

integer

The value of the token in the quote currency 24 hours ago

pretty_quote

string

The formatted current value of the token

pretty_quote24h

string

The formatted value of the token 24 hours ago

protocol_metadata

object

The metadata related to the protocol associated with the token

protocol_name

string

The name of the protocol

nft_data

array

An array of data related to NFTs

token_id

string

The unique identifier of the NFT

token_balance

string

The balance of the NFT token

token_url

string

The URL of the NFT's metadata

supports_erc

string

A list of ERC standards supported by the NFT

token_price_wei

string

The price of the NFT in wei

token_quote_rate_eth

string

The price of the NFT quoted in Ether

original_owner

string

The address of the NFT's original owner

external_data

object

The metadata associated with the NFT, such as its attributes and image URLs

name

string

The name of the NFT

desc

string

The description of the NFT

image

string

The URL of the NFT's image

image256

string

The URL of the NFT's 256px image

image512

string

The URL of the NFT's 512px image

image1024

string

The URL of the NFT's 1024px image

animation_url

string

The URL of the NFT's animation

external_url

string

The external URL of the NFT

attributes

array

An array of attributes describing the NFT

trait_type

string

The type of the NFT trait

value

string

The value of the NFT trait

thumbnails

object

The object containing various thumbnail images of the NFT

image256

string

The URL of the 256px thumbnail

image512

string

The URL of the 512px thumbnail

image1024

string

The URL of the 1024px thumbnail

image_opengraph_url

string

The OpenGraph URL of the NFT's image

thumbhash

string

The thumbhash of the NFT's image

image_preview

string

The URL of the preview image of the NFT

asset_properties

object

The metadata of the NFT's asset, including dimensions and dominant color

asset_width

integer

The width of the NFT's asset

asset_height

integer

The height of the NFT's asset

dominant_color

string

The dominant color of the NFT's asset

owner

string

The address of the current owner of the NFT

owner

string

The address of the current owner of the NFT

owner_address

string

The wallet address of the NFT's current owner

burned

boolean

Whether the NFT has been burned

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 an error occurred, or null otherwise

error_code

string

The error code if an error occurred, or null otherwise

Request

1
curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?quote-currency=USD&nft=false&no-nft-fetch=false&no-spam=true&no-nft-asset-metadata=false" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json" \
4
  -H "Authorization: Bearer YOUR_API_KEY"

1
curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?quote-currency=USD&nft=false&no-nft-fetch=false&no-spam=true&no-nft-asset-metadata=false" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json" \
4
  -H "Authorization: Bearer YOUR_API_KEY"

1
async function main() {
2
    const response = await fetch('https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?quote-currency=USD&nft=false&no-nft-fetch=false&no-spam=true&no-nft-asset-metadata=false', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json', "Authorization": "Bearer YOUR_API_KEY"}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?quote-currency=USD&nft=false&no-nft-fetch=false&no-spam=true&no-nft-asset-metadata=false', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json', "Authorization": "Bearer YOUR_API_KEY"}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?quote-currency=USD&nft=False&no-nft-fetch=False&no-spam=True&no-nft-asset-metadata=False"
5

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

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

14
print(response.text)

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?quote-currency=USD&nft=False&no-nft-fetch=False&no-spam=True&no-nft-asset-metadata=False"
5

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

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

14
print(response.text)

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

5
uri = URI("https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?quote-currency=USD&nft=false&no-nft-fetch=false&no-spam=true&no-nft-asset-metadata=false")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10
request["Authorization"] = "Bearer YOUR_API_KEY"
11

12
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
13
  http.request(request)
14
end
15

16
puts response.body

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

5
uri = URI("https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?quote-currency=USD&nft=false&no-nft-fetch=false&no-spam=true&no-nft-asset-metadata=false")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10
request["Authorization"] = "Bearer YOUR_API_KEY"
11

12
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
13
  http.request(request)
14
end
15

16
puts response.body

Response

1
{
2
  "data": {
3
    "address": "0x9690c8c169dd8fc15d75593048e4c453b7cc451c",
4
    "updated_at": "2025-04-29T21:11:37.082607882Z",
5
    "next_update_at": "2025-04-29T21:16:37.082608702Z",
6
    "quote_currency": "USD",
7
    "chain_id": 1,
8
    "chain_name": "eth-mainnet",
9
    "items": [
10
      {
11
        "contract_decimals": 18,
12
        "contract_name": "Ether",
13
        "contract_ticker_symbol": "ETH",
14
        "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
15
        "supports_erc": null,
16
        "logo_url": "https://www.datocms-assets.com/86369/1669619533-ethereum.png",
17
        "contract_display_name": "Ether",
18
        "logo_urls": {
19
          "token_logo_url": "https://logos.covalenthq.com/tokens/1/0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee.png",
20
          "protocol_logo_url": null,
21
          "chain_logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg"
22
        },
23
        "last_transferred_at": null,
24
        "block_height": 0,
25
        "native_token": true,
26
        "type": "dust",
27
        "is_spam": false,
28
        "balance": "0",
29
        "balance_24h": "0",
30
        "quote_rate": 1810.286,
31
        "quote_rate_24h": 1829.46,
32
        "quote": 0,
33
        "pretty_quote": "$0.00",
34
        "quote_24h": 0,
35
        "pretty_quote_24h": "$0.00",
36
        "protocol_metadata": null,
37
        "nft_data": null
38
      }
39
    ],
40
    "pagination": null
41
  },
42
  "error": false,
43
  "error_message": null,
44
  "error_code": null
45
}

1
{
2
  "data": {
3
    "address": "0x9690c8c169dd8fc15d75593048e4c453b7cc451c",
4
    "updated_at": "2025-04-29T21:11:37.082607882Z",
5
    "next_update_at": "2025-04-29T21:16:37.082608702Z",
6
    "quote_currency": "USD",
7
    "chain_id": 1,
8
    "chain_name": "eth-mainnet",
9
    "items": [
10
      {
11
        "contract_decimals": 18,
12
        "contract_name": "Ether",
13
        "contract_ticker_symbol": "ETH",
14
        "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
15
        "supports_erc": null,
16
        "logo_url": "https://www.datocms-assets.com/86369/1669619533-ethereum.png",
17
        "contract_display_name": "Ether",
18
        "logo_urls": {
19
          "token_logo_url": "https://logos.covalenthq.com/tokens/1/0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee.png",
20
          "protocol_logo_url": null,
21
          "chain_logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg"
22
        },
23
        "last_transferred_at": null,
24
        "block_height": 0,
25
        "native_token": true,
26
        "type": "dust",
27
        "is_spam": false,
28
        "balance": "0",
29
        "balance_24h": "0",
30
        "quote_rate": 1810.286,
31
        "quote_rate_24h": 1829.46,
32
        "quote": 0,
33
        "pretty_quote": "$0.00",
34
        "quote_24h": 0,
35
        "pretty_quote_24h": "$0.00",
36
        "protocol_metadata": null,
37
        "nft_data": null
38
      }
39
    ],
40
    "pagination": null
41
  },
42
  "error": false,
43
  "error_message": null,
44
  "error_code": null
45
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free