bb_getBalanceHistory RPC Method

Please note that this RPC method requires the Base Blockbook JSON-RPC add-on 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 --location 'https://docs-demo.base-mainnet.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "method": "bb_getBalanceHistory",
5
    "params": [
6
        "0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",
7
        {
8
            "from": "1683684000",
9
            "to": "1712707200",
10
            "fiatcurrency": "usd",
11
            "groupBy": 3600
12
        }
13
    ],
14
    "id": 1,
15
    "jsonrpc": "2.0"
16
}'

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free