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

Path Parameters

xpub_or_address

string

REQUIRED

A Bitcoin address or XPUB to query.

Query Parameters

from

integer

The starting Unix timestamp (in seconds) for the time range.

to

integer

The ending Unix timestamp (in seconds) for the time range.

fiatcurrency

string

Fiat currency code for exchange rate conversion (e.g., usd, eur).

groupBy

integer

The time interval in seconds for grouping balance data (e.g., 3600 for hourly).

gap

integer

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

Returns

time

integer

Unix timestamp for the time interval

txs

integer

Number of transactions in the interval

received

string

Total amount received in satoshis during the interval

sent

string

Total amount sent in satoshis during the interval

sentToSelf

string

Amount sent to self in satoshis during the interval

rates

object

Exchange rates at the time of the interval

{currency}

integer

Exchange rate in the requested fiat currency

Request

1
curl -X GET "https://docs-demo.btc.quiknode.pro/balancehistory/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
curl -X GET "https://docs-demo.btc.quiknode.pro/balancehistory/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
async function main() {
2
    const response = await fetch('https://docs-demo.btc.quiknode.pro/balancehistory/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://docs-demo.btc.quiknode.pro/balancehistory/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/balancehistory/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/balancehistory/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

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

5
uri = URI("https://docs-demo.btc.quiknode.pro/balancehistory/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

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

5
uri = URI("https://docs-demo.btc.quiknode.pro/balancehistory/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

Response

1
[
2
  {
3
    "time": 1683684000,
4
    "txs": 19,
5
    "received": "1289573714",
6
    "sent": "1331774394",
7
    "sentToSelf": "1055024095",
8
    "rates": {
9
      "usd": 27639.734
10
    }
11
  },
12
  {
13
    "time": 1683687600,
14
    "txs": 7,
15
    "received": "838521590",
16
    "sent": "1044980796",
17
    "sentToSelf": "708554480",
18
    "rates": {
19
      "usd": 27639.734
20
    }
21
  }
22
]

1
[
2
  {
3
    "time": 1683684000,
4
    "txs": 19,
5
    "received": "1289573714",
6
    "sent": "1331774394",
7
    "sentToSelf": "1055024095",
8
    "rates": {
9
      "usd": 27639.734
10
    }
11
  },
12
  {
13
    "time": 1683687600,
14
    "txs": 7,
15
    "received": "838521590",
16
    "sent": "1044980796",
17
    "sentToSelf": "708554480",
18
    "rates": {
19
      "usd": 27639.734
20
    }
21
  }
22
]

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free