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

Path Parameters

chainName

string

REQUIRED

Loading...

walletAddress

string

REQUIRED

Loading...

Query Parameters

quote-currency

string

Loading...

block-height

integer

Loading...

Returns

data

object

Loading...

address

string

Loading...

updated_at

string

Loading...

quote_currency

string

Loading...

chain_id

integer

Loading...

chain_name

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

logo_url

string

Loading...

block_height

integer

Loading...

balance

string

Loading...

quote_rate

integer

Loading...

quote

integer

Loading...

pretty_quote

string

Loading...

error

boolean

Loading...

error_message

string

Loading...

error_code

string

Loading...

Request

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

Response

1
{
2
  "data": {
3
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
4
    "updated_at": "2025-04-29T21:11:11.234474241Z",
5
    "quote_currency": "USD",
6
    "chain_id": 1,
7
    "chain_name": "eth-mainnet",
8
    "items": [
9
      {
10
        "contract_decimals": 18,
11
        "contract_name": "Ether",
12
        "contract_ticker_symbol": "ETH",
13
        "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
14
        "supports_erc": [],
15
        "logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg",
16
        "block_height": 22377307,
17
        "balance": "1",
18
        "quote_rate": 1809.0638,
19
        "quote": 1.8090637e-15,
20
        "pretty_quote": "$0.00"
21
      }
22
    ]
23
  },
24
  "error": false,
25
  "error_message": null,
26
  "error_code": null
27
}

1
{
2
  "data": {
3
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
4
    "updated_at": "2025-04-29T21:11:11.234474241Z",
5
    "quote_currency": "USD",
6
    "chain_id": 1,
7
    "chain_name": "eth-mainnet",
8
    "items": [
9
      {
10
        "contract_decimals": 18,
11
        "contract_name": "Ether",
12
        "contract_ticker_symbol": "ETH",
13
        "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
14
        "supports_erc": [],
15
        "logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg",
16
        "block_height": 22377307,
17
        "balance": "1",
18
        "quote_rate": 1809.0638,
19
        "quote": 1.8090637e-15,
20
        "pretty_quote": "$0.00"
21
      }
22
    ]
23
  },
24
  "error": false,
25
  "error_message": null,
26
  "error_code": null
27
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free