Skip to main content

bb_getAddress RPC Method

Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first.

Updated on
Nov 14, 2024

bb_getAddress 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 and transactions need to be retrieved
object
array
The options object with the following fields:
page
integer
The page you would like to retrieve.
size
integer
The number of transactions you would like on each page.
fromHeight
integer
Filter of the returned transactions from block height
toHeight
integer
Filter of the returned transactions to block height
details
string
It must be one of the following values: basic, txids, or txs
secondary
string
The secondary (fiat) currency in which the token and total balances are returned in addition to crypto values. Must be one of: usd|eur

Returns

page
integer
The page number returned in this response
totalPages
integer
The number of pages available for your original query
itemsOnPage
integer
The maximum number of transactions returned in this response
address
string
The address you provided in the original query
balance
string
The balance of Ether in wei for the specified address
unconfirmedBalance
string
The unconfirmed balance of Ether in the specified address
unconfirmedTxs
integer
The number of unconfirmed transactions associated with the specified address
txs
integer
The total number of transactions associated with the specified address.
nonTokenTxs
integer
(Optional) The number of non-token transactions (regular Ether transactions) associated with the specified address
internalTxs
integer
(Optional) The number of internal transactions (transactions that are triggered by contract interactions) associated with the specified address
txids
array
An array containing the transaction IDs associated with the specified address
nonce
string
The nonce value of the specified address
tokens
array
An array containing information about ERC-20, ERC-1155 and ERC-721 tokens associated with the specified address
type
string
The type of token (ERC-20, ERC-721 or ERC-1155 etc)
name
string
The name of the token
contract
string
The contract address of the token
transfers
integer
The number of transfers associated with the token
symbol
string
The symbol of the token
decimals
integer
(Optional) The number of decimal places for the token
balance
string
The balance of the token in the specified address
multiTokenValues
object
(Optional) An array containing objects with id and value representing the token ID and its corresponding value
id
string
The token id
value
string
The token value
Request
1
curl --location 'https://docs-demo.base-mainnet.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "method": "bb_getAddress",
5
    "params": [
6
        "0xEA60B5FAbf224041119e29cE4e75513BC73F5Edf",
7
        {
8
            "page": 1,
9
            "size": 1000,
10
            "fromHeight": 0,
11
            "details": "txids"
12
        }
13
    ]
14
}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free