v1/allchains/address/{walletAddress}/balances/ REST API Endpoint - GoldRush Wallet API

Path Parameters

walletAddress

string

REQUIRED

Loading...

Query Parameters

chains

string

Loading...

limit

integer

Loading...

before

string

Loading...

cutoff-timestamp

integer

Loading...

quote-currency

string

Loading...

Returns

data

object

Loading...

updated_at

string

Loading...

cursor_before

string

Loading...

quote_currency

string

Loading...

items

array

Loading...

contract_decimals

integer

Loading...

contract_name

string

Loading...

contract_ticker_symbol

string

Loading...

contract_address

string

Loading...

supports_erc

array

Loading...

contract_display_name

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...

type

string

Loading...

is_spam

boolean

Loading...

balance

string

Loading...

balance_24h

string

Loading...

quote_rate

number

Loading...

quote_rate_24h

number

Loading...

quote

number

Loading...

pretty_quote

string

Loading...

quote_24h

number

Loading...

pretty_quote_24h

string

Loading...

chain_id

string

Loading...

chain_name

string

Loading...

chain_display_name

string

Loading...

is_native_token

boolean

Loading...

error

boolean

Loading...

error_message

string

Loading...

error_code

integer

Loading...

Request

1
curl --location 'https://api.covalenthq.com/v1/allchains/address/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-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/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-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/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-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/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-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/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-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/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-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/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-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/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-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

Response

1
{
2
  "data": {
3
    "updated_at": "2025-04-29T21:01:39.175128580Z",
4
    "address": "0x9690c8c169dd8fc15d75593048e4c453b7cc451c",
5
    "items": [
6
      {
7
        "name": "eth-mainnet",
8
        "chain_id": "1",
9
        "is_testnet": false,
10
        "db_schema_name": "chain_eth_mainnet",
11
        "label": "Ethereum Mainnet",
12
        "category_label": "Ethereum",
13
        "priority_label": "Foundational",
14
        "logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg",
15
        "black_logo_url": "https://www.datocms-assets.com/86369/1669619544-ethereum.png",
16
        "white_logo_url": "https://www.datocms-assets.com/86369/1669619533-ethereum.png",
17
        "color_theme": {
18
          "red": 94,
19
          "green": 121,
20
          "blue": 138,
21
          "alpha": 255,
22
          "hex": "#5E798A",
23
          "css_rgb": "rgb(94 121 138)"
24
        },
25
        "is_appchain": false,
26
        "appchain_of": null,
27
        "last_seen_at": "2024-11-14T13:02:11Z"
28
      },
29
      {
30
        "name": "base-mainnet",
31
        "chain_id": "8453",
32
        "is_testnet": false,
33
        "db_schema_name": "chain_base_mainnet",
34
        "label": "Base Mainnet",
35
        "category_label": "Coinbase",
36
        "priority_label": "Foundational",
37
        "logo_url": "https://www.datocms-assets.com/86369/1677538323-property-1-base-icon-white.svg",
38
        "black_logo_url": "https://www.datocms-assets.com/86369/1677538328-property-1-base-white.png",
39
        "white_logo_url": "https://www.datocms-assets.com/86369/1677538326-base-colour.png",
40
        "color_theme": {
41
          "red": 15,
42
          "green": 91,
43
          "blue": 228,
44
          "alpha": 255,
45
          "hex": "#0F5BE4",
46
          "css_rgb": "rgb(15 91 228)"
47
        },
48
        "is_appchain": false,
49
        "appchain_of": null,
50
        "last_seen_at": "2024-11-14T13:02:49Z"
51
      }
52
    ]
53
  },
54
  "error": false,
55
  "error_message": null,
56
  "error_code": null
57
}

1
{
2
  "data": {
3
    "updated_at": "2025-04-29T21:01:39.175128580Z",
4
    "address": "0x9690c8c169dd8fc15d75593048e4c453b7cc451c",
5
    "items": [
6
      {
7
        "name": "eth-mainnet",
8
        "chain_id": "1",
9
        "is_testnet": false,
10
        "db_schema_name": "chain_eth_mainnet",
11
        "label": "Ethereum Mainnet",
12
        "category_label": "Ethereum",
13
        "priority_label": "Foundational",
14
        "logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg",
15
        "black_logo_url": "https://www.datocms-assets.com/86369/1669619544-ethereum.png",
16
        "white_logo_url": "https://www.datocms-assets.com/86369/1669619533-ethereum.png",
17
        "color_theme": {
18
          "red": 94,
19
          "green": 121,
20
          "blue": 138,
21
          "alpha": 255,
22
          "hex": "#5E798A",
23
          "css_rgb": "rgb(94 121 138)"
24
        },
25
        "is_appchain": false,
26
        "appchain_of": null,
27
        "last_seen_at": "2024-11-14T13:02:11Z"
28
      },
29
      {
30
        "name": "base-mainnet",
31
        "chain_id": "8453",
32
        "is_testnet": false,
33
        "db_schema_name": "chain_base_mainnet",
34
        "label": "Base Mainnet",
35
        "category_label": "Coinbase",
36
        "priority_label": "Foundational",
37
        "logo_url": "https://www.datocms-assets.com/86369/1677538323-property-1-base-icon-white.svg",
38
        "black_logo_url": "https://www.datocms-assets.com/86369/1677538328-property-1-base-white.png",
39
        "white_logo_url": "https://www.datocms-assets.com/86369/1677538326-base-colour.png",
40
        "color_theme": {
41
          "red": 15,
42
          "green": 91,
43
          "blue": 228,
44
          "alpha": 255,
45
          "hex": "#0F5BE4",
46
          "css_rgb": "rgb(15 91 228)"
47
        },
48
        "is_appchain": false,
49
        "appchain_of": null,
50
        "last_seen_at": "2024-11-14T13:02:49Z"
51
      }
52
    ]
53
  },
54
  "error": false,
55
  "error_message": null,
56
  "error_code": null
57
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free