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

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

Request

1
curl -X POST "https://docs-demo.nova-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getBalance",
6
  "params": [
7
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
8
    "latest"
9
  ],
10
  "id": 1
11
}'

1
curl -X POST "https://docs-demo.nova-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getBalance",
6
  "params": [
7
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
8
    "latest"
9
  ],
10
  "id": 1
11
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.nova-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_getBalance", [
6
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
7
    "latest"
8
]);
9
    console.log(response);
10
}
11

12
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.nova-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_getBalance", [
6
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
7
    "latest"
8
]);
9
    console.log(response);
10
}
11

12
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.nova-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getBalance", ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9","latest"])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.nova-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getBalance", ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9","latest"])
4
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.nova-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_getBalance',
10
        params: [
11
          "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
12
          "latest"
13
        ]
14
    })
15

16
    console.log(result)
17
}
18

19
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.nova-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_getBalance',
10
        params: [
11
          "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
12
          "latest"
13
        ]
14
    })
15

16
    console.log(result)
17
}
18

19
main()

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_getBalance',
7
  [
8
  "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
9
  "latest"
10
],
11
  undefined,
12
  'https://docs-demo.nova-mainnet.quiknode.pro/'
13
)
14

15
console.log(result)

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_getBalance',
7
  [
8
  "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
9
  "latest"
10
],
11
  undefined,
12
  'https://docs-demo.nova-mainnet.quiknode.pro/'
13
)
14

15
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_getBalance",
8
        [
9
            "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
10
            "latest"
11
        ],
12
        endpoint_url="https://docs-demo.nova-mainnet.quiknode.pro/",
13
    )
14
    print(result)
15

16
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_getBalance",
8
        [
9
            "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
10
            "latest"
11
        ],
12
        endpoint_url="https://docs-demo.nova-mainnet.quiknode.pro/",
13
    )
14
    print(result)
15

16
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_getBalance",
7
  params: [
8
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
9
    "latest"
10
  ],
11
  endpoint_url: "https://docs-demo.nova-mainnet.quiknode.pro/"
12
)
13

14
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_getBalance",
7
  params: [
8
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
9
    "latest"
10
  ],
11
  endpoint_url: "https://docs-demo.nova-mainnet.quiknode.pro/"
12
)
13

14
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_getBalance",
10
            Some(serde_json::json!([
11
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
12
    "latest"
13
])),
14
            None,
15
            Some("https://docs-demo.nova-mainnet.quiknode.pro/".into()),
16
        )
17
        .await?;
18

19
    println!("{result}");
20
    Ok(())
21
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_getBalance",
10
            Some(serde_json::json!([
11
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
12
    "latest"
13
])),
14
            None,
15
            Some("https://docs-demo.nova-mainnet.quiknode.pro/".into()),
16
        )
17
        .await?;
18

19
    println!("{result}");
20
    Ok(())
21
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_getBalance',
4
    params: ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9","latest"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.nova-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_getBalance',
4
    params: ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9","latest"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.nova-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getBalance",
9
  "params": [
10
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
11
    "latest"
12
  ],
13
  "id": 1
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)

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getBalance",
9
  "params": [
10
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
11
    "latest"
12
  ],
13
  "id": 1
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)

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getBalance",
11
  params: ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9","latest"]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getBalance",
11
  params: ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9","latest"]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": "0x0"
5
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": "0x0"
5
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free