Please note that this RPC method requires the Blockbook RPC enabled on your Quicknode endpoint.

Parameters

address

string

REQUIRED

Typically a Zcash transparent address

object

object

An object specifying additional parameters:

from

string

REQUIRED

The starting Unix timestamp (in seconds) of the time range for which balance history is requested

to

string

The ending Unix timestamp (in seconds) of the time range for which balance history is requested

fiatcurrency

string

The fiat currency in which to convert the balance values

groupBy

integer

The time interval (in seconds) for grouping the balance data

gap

integer

The gap limit used when deriving addresses from an extended public key (xpub). Defaults to 20.

Returns

time

integer

The Unix timestamp (in seconds) representing the end time of the specified time interval

txs

integer

The number of transactions that occurred within the specified time interval

received

string

The total amount of ZEC received by the address during the specified time interval

sent

string

The total amount of ZEC sent from the address during the specified time interval

sentToSelf

string

The total amount of ZEC sent from the address to itself during the specified time interval

rates

object

An object providing exchange rates for the specified fiat currencies

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": "bb_getBalanceHistory",
6
  "params": [
7
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
8
    {
9
      "from": "1683684000",
10
      "to": "1700042400",
11
      "fiatcurrency": "usd",
12
      "groupBy": 3600
13
    }
14
  ],
15
  "id": 1
16
}'

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": "bb_getBalanceHistory",
6
  "params": [
7
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
8
    {
9
      "from": "1683684000",
10
      "to": "1700042400",
11
      "fiatcurrency": "usd",
12
      "groupBy": 3600
13
    }
14
  ],
15
  "id": 1
16
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'bb_getBalanceHistory',
4
    params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"from":"1683684000","to":"1700042400","fiatcurrency":"usd","groupBy":3600}],
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: 'bb_getBalanceHistory',
4
    params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"from":"1683684000","to":"1700042400","fiatcurrency":"usd","groupBy":3600}],
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": "bb_getBalanceHistory",
9
  "params": [
10
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
11
    {
12
      "from": "1683684000",
13
      "to": "1700042400",
14
      "fiatcurrency": "usd",
15
      "groupBy": 3600
16
    }
17
  ],
18
  "id": 1
19
})
20
headers = {
21
  'Content-Type': 'application/json'
22
}
23

24
response = requests.request("POST", url, headers=headers, data=payload)
25

26
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": "bb_getBalanceHistory",
9
  "params": [
10
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
11
    {
12
      "from": "1683684000",
13
      "to": "1700042400",
14
      "fiatcurrency": "usd",
15
      "groupBy": 3600
16
    }
17
  ],
18
  "id": 1
19
})
20
headers = {
21
  'Content-Type': 'application/json'
22
}
23

24
response = requests.request("POST", url, headers=headers, data=payload)
25

26
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: "bb_getBalanceHistory",
11
  params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"from":"1683684000","to":"1700042400","fiatcurrency":"usd","groupBy":3600}]
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: "bb_getBalanceHistory",
11
  params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"from":"1683684000","to":"1700042400","fiatcurrency":"usd","groupBy":3600}]
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
  "id": 1,
3
  "result": [
4
    {
5
      "time": 1683684000,
6
      "txs": 8,
7
      "received": "2000399945",
8
      "sent": "0",
9
      "sentToSelf": "0",
10
      "rates": {
11
        "usd": 32.059723
12
      }
13
    },
14
    {
15
      "time": 1683687600,
16
      "txs": 6,
17
      "received": "1500112724",
18
      "sent": "0",
19
      "sentToSelf": "0",
20
      "rates": {
21
        "usd": 32.059723
22
      }
23
    },
24
    {
25
      "time": 1683691200,
26
      "txs": 5,
27
      "received": "1250053182",
28
      "sent": "0",
29
      "sentToSelf": "0",
30
      "rates": {
31
        "usd": 32.059723
32
      }
33
    },
34
    {
35
      "time": 1683694800,
36
      "txs": 4,
37
      "received": "1000111134",
38
      "sent": "0",
39
      "sentToSelf": "0",
40
      "rates": {
41
        "usd": 32.059723
42
      }
43
    },
44
    {
45
      "time": 1683698400,
46
      "txs": 2,
47
      "received": "500066839",
48
      "sent": "0",
49
      "sentToSelf": "0",
50
      "rates": {
51
        "usd": 32.059723
52
      }
53
    }
54
  ],
55
  "jsonrpc": "2.0"
56
}

1
{
2
  "id": 1,
3
  "result": [
4
    {
5
      "time": 1683684000,
6
      "txs": 8,
7
      "received": "2000399945",
8
      "sent": "0",
9
      "sentToSelf": "0",
10
      "rates": {
11
        "usd": 32.059723
12
      }
13
    },
14
    {
15
      "time": 1683687600,
16
      "txs": 6,
17
      "received": "1500112724",
18
      "sent": "0",
19
      "sentToSelf": "0",
20
      "rates": {
21
        "usd": 32.059723
22
      }
23
    },
24
    {
25
      "time": 1683691200,
26
      "txs": 5,
27
      "received": "1250053182",
28
      "sent": "0",
29
      "sentToSelf": "0",
30
      "rates": {
31
        "usd": 32.059723
32
      }
33
    },
34
    {
35
      "time": 1683694800,
36
      "txs": 4,
37
      "received": "1000111134",
38
      "sent": "0",
39
      "sentToSelf": "0",
40
      "rates": {
41
        "usd": 32.059723
42
      }
43
    },
44
    {
45
      "time": 1683698400,
46
      "txs": 2,
47
      "received": "500066839",
48
      "sent": "0",
49
      "sentToSelf": "0",
50
      "rates": {
51
        "usd": 32.059723
52
      }
53
    }
54
  ],
55
  "jsonrpc": "2.0"
56
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free