Parameters

address

string

REQUIRED

The address (20 bytes) to check for balance

blockNumber/tag

string

REQUIRED

The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized (safe and finalized tags are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova and Avalanche C-chain), see the default block parameter description in the official Ethereum documentation

Returns

result

string

The ETH balance of the specified address in hexadecimal value, measured in wei

Request

1
curl https://docs-demo.soneium-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"method":"eth_getBalance","params":["0x4200000000000000000000000000000000000006", "latest"],"id":1,"jsonrpc":"2.0"}'
5

1
curl https://docs-demo.soneium-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"method":"eth_getBalance","params":["0x4200000000000000000000000000000000000006", "latest"],"id":1,"jsonrpc":"2.0"}'
5

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.soneium-mainnet.quiknode.pro/",
5
})
6

7
core.client
8
  .getBalance({
9
    address: '0x4200000000000000000000000000000000000006',
10
  })
11
  .then(res => console.log(res))
12

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.soneium-mainnet.quiknode.pro/",
5
})
6

7
core.client
8
  .getBalance({
9
    address: '0x4200000000000000000000000000000000000006',
10
  })
11
  .then(res => console.log(res))
12

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.soneium-mainnet.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_getBalance",
7
    "params": ["0x4200000000000000000000000000000000000006", 'latest'],
8
    "id": "1"
9
}
10

11
response = client.send(payload.to_json)
12
puts response

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.soneium-mainnet.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_getBalance",
7
    "params": ["0x4200000000000000000000000000000000000006", 'latest'],
8
    "id": "1"
9
}
10

11
response = client.send(payload.to_json)
12
puts response

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.soneium-mainnet.quiknode.pro/");
4
  const balance = await provider.getBalance(
5
    "0x4200000000000000000000000000000000000006",
6
    "latest"
7
  );
8
  console.log(balance);
9
})();
10

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.soneium-mainnet.quiknode.pro/");
4
  const balance = await provider.getBalance(
5
    "0x4200000000000000000000000000000000000006",
6
    "latest"
7
  );
8
  console.log(balance);
9
})();
10

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "eth_getBalance",
6
  "params": [
7
    "0x4200000000000000000000000000000000000006",
8
    "latest"
9
  ],
10
  "id": 1,
11
  "jsonrpc": "2.0"
12
});
13

14
var requestOptions = {
15
  method: 'POST',
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: 'follow'
19
};
20

21
fetch("https://docs-demo.soneium-mainnet.quiknode.pro/", requestOptions)
22
  .then(response => response.text())
23
  .then(result => console.log(result))
24
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "eth_getBalance",
6
  "params": [
7
    "0x4200000000000000000000000000000000000006",
8
    "latest"
9
  ],
10
  "id": 1,
11
  "jsonrpc": "2.0"
12
});
13

14
var requestOptions = {
15
  method: 'POST',
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: 'follow'
19
};
20

21
fetch("https://docs-demo.soneium-mainnet.quiknode.pro/", requestOptions)
22
  .then(response => response.text())
23
  .then(result => console.log(result))
24
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

4
url = "https://docs-demo.soneium-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "method": "eth_getBalance",
8
  "params": [
9
    "0x4200000000000000000000000000000000000006",
10
    "latest"
11
  ],
12
  "id": 1,
13
  "jsonrpc": "2.0"
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)
22

1
import requests
2
import json
3

4
url = "https://docs-demo.soneium-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "method": "eth_getBalance",
8
  "params": [
9
    "0x4200000000000000000000000000000000000006",
10
    "latest"
11
  ],
12
  "id": 1,
13
  "jsonrpc": "2.0"
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)
22

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

5
url = URI("https://docs-demo.soneium-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "eth_getBalance",
14
  "params": [
15
    "0x4200000000000000000000000000000000000006",
16
    "latest"
17
  ],
18
  "id": 1,
19
  "jsonrpc": "2.0"
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

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

5
url = URI("https://docs-demo.soneium-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "eth_getBalance",
14
  "params": [
15
    "0x4200000000000000000000000000000000000006",
16
    "latest"
17
  ],
18
  "id": 1,
19
  "jsonrpc": "2.0"
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.soneium-mainnet.quiknode.pro/'))
3
print (w3.eth.get_balance('0x4200000000000000000000000000000000000006', 'latest'))

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.soneium-mainnet.quiknode.pro/'))
3
print (w3.eth.get_balance('0x4200000000000000000000000000000000000006', 'latest'))

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free