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

Parameters

address

string

REQUIRED

The address for which the balance history is to be fetched

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. Some of the available currencies are AED, EUR, GBP, USD, etc

groupBy

integer

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

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 native token/currency received by the address during the specified time interval

sent

string

The total amount of native token/currency sent from the address during the specified time interval

sentToSelf

string

The total amount of native token/currency 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.matic.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getBalanceHistory",
6
  "params": [
7
    "0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",
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.matic.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getBalanceHistory",
6
  "params": [
7
    "0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",
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: ["0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",{"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.matic.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: ["0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",{"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.matic.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.matic.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "bb_getBalanceHistory",
9
  "params": [
10
    "0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",
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.matic.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "bb_getBalanceHistory",
9
  "params": [
10
    "0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",
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.matic.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "bb_getBalanceHistory",
11
  params: ["0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",{"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.matic.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "bb_getBalanceHistory",
11
  params: ["0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",{"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": 1685689200,
6
      "txs": 5,
7
      "received": "0",
8
      "sent": "10247601921605917",
9
      "sentToSelf": "0",
10
      "rates": {
11
        "usd": 1907.2123
12
      }
13
    },
14
    {
15
      "time": 1694048400,
16
      "txs": 1,
17
      "received": "0",
18
      "sent": "0",
19
      "sentToSelf": "0",
20
      "rates": {
21
        "usd": 1646.305
22
      }
23
    },
24
    {
25
      "time": 1694084400,
26
      "txs": 4,
27
      "received": "0",
28
      "sent": "8064344277547668",
29
      "sentToSelf": "0",
30
      "rates": {
31
        "usd": 1646.305
32
      }
33
    },
34
    {
35
      "time": 1694156400,
36
      "txs": 1,
37
      "received": "0",
38
      "sent": "0",
39
      "sentToSelf": "0",
40
      "rates": {
41
        "usd": 1636.3542
42
      }
43
    },
44
    {
45
      "time": 1696716000,
46
      "txs": 1,
47
      "received": "0",
48
      "sent": "0",
49
      "sentToSelf": "0",
50
      "rates": {
51
        "usd": 1635.0829
52
      }
53
    }
54
  ],
55
  "jsonrpc": "2.0"
56
}

1
{
2
  "id": 1,
3
  "result": [
4
    {
5
      "time": 1685689200,
6
      "txs": 5,
7
      "received": "0",
8
      "sent": "10247601921605917",
9
      "sentToSelf": "0",
10
      "rates": {
11
        "usd": 1907.2123
12
      }
13
    },
14
    {
15
      "time": 1694048400,
16
      "txs": 1,
17
      "received": "0",
18
      "sent": "0",
19
      "sentToSelf": "0",
20
      "rates": {
21
        "usd": 1646.305
22
      }
23
    },
24
    {
25
      "time": 1694084400,
26
      "txs": 4,
27
      "received": "0",
28
      "sent": "8064344277547668",
29
      "sentToSelf": "0",
30
      "rates": {
31
        "usd": 1646.305
32
      }
33
    },
34
    {
35
      "time": 1694156400,
36
      "txs": 1,
37
      "received": "0",
38
      "sent": "0",
39
      "sentToSelf": "0",
40
      "rates": {
41
        "usd": 1636.3542
42
      }
43
    },
44
    {
45
      "time": 1696716000,
46
      "txs": 1,
47
      "received": "0",
48
      "sent": "0",
49
      "sentToSelf": "0",
50
      "rates": {
51
        "usd": 1635.0829
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