GET /api/v2/balancehistory/{address} - Blockbook REST API

Please note that this REST method requires the EVM Blockbook add-on enabled on your QuickNode endpoint.

Path Parameters

xpub_or_address

string

REQUIRED

Loading...

Query Parameters

from

integer

Loading...

to

integer

Loading...

fiatcurrency

string

Loading...

groupBy

integer

Loading...

Returns

time

integer

Loading...

txs

integer

Loading...

received

string

Loading...

sent

string

Loading...

sentToSelf

string

Loading...

rates

object

Loading...

{currency}

integer

Loading...

Request

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

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

1
async function main() {
2
    const response = await fetch('https://docs-demo.quiknode.pro/balancehistory/0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600', {
3
        method: 'GET',
4
        headers: {'Content-Type': '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.quiknode.pro/balancehistory/0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600', {
3
        method: 'GET',
4
        headers: {'Content-Type': '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.quiknode.pro/balancehistory/0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf?from=1683684000&to=1700042400&fiatcurrency=usd&groupBy=3600"
5

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

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

12
print(response.text)

1
import requests
2
import json
3

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

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

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

12
print(response.text)

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

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

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

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

14
puts response.body

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

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

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

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

14
puts response.body

Response

1
[
2
  {
3
    "time": 1685689200,
4
    "txs": 5,
5
    "received": "0",
6
    "sent": "10247601921605917",
7
    "sentToSelf": "0",
8
    "rates": {
9
      "usd": 1907.2123
10
    }
11
  },
12
  {
13
    "time": 1694048400,
14
    "txs": 1,
15
    "received": "0",
16
    "sent": "0",
17
    "sentToSelf": "0",
18
    "rates": {
19
      "usd": 1646.305
20
    }
21
  }
22
]

1
[
2
  {
3
    "time": 1685689200,
4
    "txs": 5,
5
    "received": "0",
6
    "sent": "10247601921605917",
7
    "sentToSelf": "0",
8
    "rates": {
9
      "usd": 1907.2123
10
    }
11
  },
12
  {
13
    "time": 1694048400,
14
    "txs": 1,
15
    "received": "0",
16
    "sent": "0",
17
    "sentToSelf": "0",
18
    "rates": {
19
      "usd": 1646.305
20
    }
21
  }
22
]

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free