v1/{chainName}/address/{walletAddress}/balances_v2/ REST API Endpoint - GoldRush Wallet API

Path Parameters

chainName

string

REQUIRED

Loading...

walletAddress

string

REQUIRED

Loading...

Query Parameters

quote-currency

string

Loading...

nft

boolean

Loading...

no-nft-fetch

boolean

Loading...

no-spam

boolean

Loading...

no-nft-asset-metadata

boolean

Loading...

Returns

data

object

Loading...

address

string

Loading...

chain_id

integer

Loading...

chain_name

string

Loading...

quote_currency

string

Loading...

updated_at

string

Loading...

items

array

Loading...

contract_decimals

integer

Loading...

contract_name

string

Loading...

contract_ticker_symbol

string

Loading...

contract_address

string

Loading...

contract_display_name

string

Loading...

supports_erc

string

Loading...

logo_url

string

Loading...

logo_urls

object

Loading...

token_logo_url

string

Loading...

protocol_logo_url

string

Loading...

chain_logo_url

string

Loading...

last_transferred_at

string

Loading...

native_token

boolean

Loading...

type

string

Loading...

is_spam

boolean

Loading...

balance

string

Loading...

balance24h

string

Loading...

quote_rate

integer

Loading...

quote_rate24h

integer

Loading...

quote

integer

Loading...

quote24h

integer

Loading...

pretty_quote

string

Loading...

pretty_quote24h

string

Loading...

protocol_metadata

object

Loading...

protocol_name

string

Loading...

nft_data

array

Loading...

token_id

string

Loading...

token_balance

string

Loading...

token_url

string

Loading...

supports_erc

string

Loading...

token_price_wei

string

Loading...

token_quote_rate_eth

string

Loading...

original_owner

string

Loading...

external_data

object

Loading...

name

string

Loading...

desc

string

Loading...

image

string

Loading...

image256

string

Loading...

image512

string

Loading...

image1024

string

Loading...

animation_url

string

Loading...

external_url

string

Loading...

attributes

array

Loading...

trait_type

string

Loading...

value

string

Loading...

thumbnails

object

Loading...

image256

string

Loading...

image512

string

Loading...

image1024

string

Loading...

image_opengraph_url

string

Loading...

thumbhash

string

Loading...

image_preview

string

Loading...

asset_properties

object

Loading...

asset_width

integer

Loading...

asset_height

integer

Loading...

dominant_color

string

Loading...

owner

string

Loading...

owner

string

Loading...

owner_address

string

Loading...

burned

boolean

Loading...

pagination

object

Loading...

has_more

boolean

Loading...

page_number

integer

Loading...

page_size

integer

Loading...

total_count

integer

Loading...

error

boolean

Loading...

error_message

string

Loading...

error_code

string

Loading...

Request

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

1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/address/0x9690C8c169dd8FC15d75593048E4c453B7CC451c/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/eth-mainnet/address/0x9690C8c169dd8FC15d75593048E4c453B7CC451c/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/eth-mainnet/address/0x9690C8c169dd8FC15d75593048E4c453B7CC451c/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/eth-mainnet/address/0x9690C8c169dd8FC15d75593048E4c453B7CC451c/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/eth-mainnet/address/0x9690C8c169dd8FC15d75593048E4c453B7CC451c/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/eth-mainnet/address/0x9690C8c169dd8FC15d75593048E4c453B7CC451c/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/eth-mainnet/address/0x9690C8c169dd8FC15d75593048E4c453B7CC451c/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": "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