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

Parameters

address

string

REQUIRED

Typically a Litecoin address

object

object

An object specifying additional parameters:

from

string

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 (e.g., 'usd')

groupBy

integer

The time interval (in seconds) for grouping the balance data (e.g., 3600 for hourly 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 Litecoin received by the address during the specified time interval

sent

string

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

sentToSelf

string

The total amount of Litecoin 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 https://docs-demo.ltc-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"method":"bb_getBalanceHistory","params": ["LYhttvnKawAv6RcHQ4eBkNtifuiEA99PFe", {"from":"1683684000", "to":"1715035409", "fiatcurrency":"usd", "groupBy":3600}],"id":1,"jsonrpc":"2.0"}'

1
curl https://docs-demo.ltc-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"method":"bb_getBalanceHistory","params": ["LYhttvnKawAv6RcHQ4eBkNtifuiEA99PFe", {"from":"1683684000", "to":"1715035409", "fiatcurrency":"usd", "groupBy":3600}],"id":1,"jsonrpc":"2.0"}'

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "bb_getBalanceHistory",
6
  "params": [
7
    "LYhttvnKawAv6RcHQ4eBkNtifuiEA99PFe",
8
    {
9
      "from": "1683684000",
10
      "to": "1715035409",
11
      "fiatcurrency": "usd",
12
      "groupBy": 3600
13
    }
14
  ],
15
  "id": 1,
16
  "jsonrpc": "2.0"
17
});
18

19
var requestOptions = {
20
  method: 'POST',
21
  headers: myHeaders,
22
  body: raw,
23
  redirect: 'follow'
24
};
25

26
fetch("https://docs-demo.ltc-mainnet.quiknode.pro/", requestOptions)
27
  .then(response => response.text())
28
  .then(result => console.log(result))
29
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "bb_getBalanceHistory",
6
  "params": [
7
    "LYhttvnKawAv6RcHQ4eBkNtifuiEA99PFe",
8
    {
9
      "from": "1683684000",
10
      "to": "1715035409",
11
      "fiatcurrency": "usd",
12
      "groupBy": 3600
13
    }
14
  ],
15
  "id": 1,
16
  "jsonrpc": "2.0"
17
});
18

19
var requestOptions = {
20
  method: 'POST',
21
  headers: myHeaders,
22
  body: raw,
23
  redirect: 'follow'
24
};
25

26
fetch("https://docs-demo.ltc-mainnet.quiknode.pro/", requestOptions)
27
  .then(response => response.text())
28
  .then(result => console.log(result))
29
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "bb_getBalanceHistory",
8
  "params": [
9
    "LYhttvnKawAv6RcHQ4eBkNtifuiEA99PFe",
10
    {
11
      "from": "1683684000",
12
      "to": "1715035409",
13
      "fiatcurrency": "usd",
14
      "groupBy": 3600
15
    }
16
  ],
17
  "id": 1,
18
  "jsonrpc": "2.0"
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.ltc-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "method": "bb_getBalanceHistory",
8
  "params": [
9
    "LYhttvnKawAv6RcHQ4eBkNtifuiEA99PFe",
10
    {
11
      "from": "1683684000",
12
      "to": "1715035409",
13
      "fiatcurrency": "usd",
14
      "groupBy": 3600
15
    }
16
  ],
17
  "id": 1,
18
  "jsonrpc": "2.0"
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
url = URI("https://docs-demo.ltc-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "bb_getBalanceHistory",
14
  "params": [
15
    "LYhttvnKawAv6RcHQ4eBkNtifuiEA99PFe",
16
    {
17
      "from": "1683684000",
18
      "to": "1715035409",
19
      "fiatcurrency": "usd",
20
      "groupBy": 3600
21
    }
22
  ],
23
  "id": 1,
24
  "jsonrpc": "2.0"
25
})
26

27
response = https.request(request)
28
puts response.read_body
29

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

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

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "bb_getBalanceHistory",
14
  "params": [
15
    "LYhttvnKawAv6RcHQ4eBkNtifuiEA99PFe",
16
    {
17
      "from": "1683684000",
18
      "to": "1715035409",
19
      "fiatcurrency": "usd",
20
      "groupBy": 3600
21
    }
22
  ],
23
  "id": 1,
24
  "jsonrpc": "2.0"
25
})
26

27
response = https.request(request)
28
puts response.read_body
29

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free