Parameters

addresses

object

REQUIRED

An object containing an array of addresses to query

addresses

array

Array of base58check encoded addresses

Returns

balance

integer

The current balance in zatoshis

received

integer

The total number of zatoshis received (including change)

error

string

(Optional) The error message, if any

Request

1
curl -X POST "https://docs-demo.zec-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "getaddressbalance",
6
  "params": [
7
    {
8
      "addresses": [
9
        "t3Vz22vK5z2LcKEdg16Yv4FFneEL1zg9ojd"
10
      ]
11
    }
12
  ],
13
  "id": 1
14
}'

1
curl -X POST "https://docs-demo.zec-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "getaddressbalance",
6
  "params": [
7
    {
8
      "addresses": [
9
        "t3Vz22vK5z2LcKEdg16Yv4FFneEL1zg9ojd"
10
      ]
11
    }
12
  ],
13
  "id": 1
14
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'getaddressbalance',
4
    params: [{"addresses":["t3Vz22vK5z2LcKEdg16Yv4FFneEL1zg9ojd"]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.zec-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: 'getaddressbalance',
4
    params: [{"addresses":["t3Vz22vK5z2LcKEdg16Yv4FFneEL1zg9ojd"]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.zec-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.zec-mainnet.quiknode.pro/"
5

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

22
response = requests.request("POST", url, headers=headers, data=payload)
23

24
print(response.text)

1
import requests
2
import json
3

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

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

22
response = requests.request("POST", url, headers=headers, data=payload)
23

24
print(response.text)

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getaddressbalance",
11
  params: [{"addresses":["t3Vz22vK5z2LcKEdg16Yv4FFneEL1zg9ojd"]}]
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.zec-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getaddressbalance",
11
  params: [{"addresses":["t3Vz22vK5z2LcKEdg16Yv4FFneEL1zg9ojd"]}]
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": {
5
    "balance": 7873358,
6
    "received": 1960047810858
7
  }
8
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "balance": 7873358,
6
    "received": 1960047810858
7
  }
8
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free