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

Parameters

address

string

REQUIRED

Typically a Zcash transparent address.

object

object

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

filter

string

Filter transactions by token. Provide a token's contract address, or 0 to return only transactions with no token transfers.

contract

string

Limit returned token balances and transactions to the specified token contract address.

protocols

string

Comma-separated list of token protocols to include (for example erc20).

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 current balance of the address using confirmed unspent transaction outputs only, denominated in zatoshis. Balance is updated after 1 confirmation.

totalReceived

string

The total value received for the address using confirmed transactions only, denominated in zatoshis.

totalSent

string

The total value sent for the address using confirmed transactions only, denominated in zatoshis.

unconfirmedBalance

string

The current balance of the address using unconfirmed unspent transaction outputs only, denominated in zatoshis.

unconfirmedTxs

integer

The current number of unconfirmed transactions for this address.

txs

integer

The total number of transactions for this address.

txids

array

(only appears when details is set to txids) An array of transaction ids for the provided address.

txid

string

The transaction id

transactions

array

(only appears when details is set to txs) An array of transactions for the provided address

txid

string

The transaction id

version

integer

The transaction version

lockTime

integer

The earliest time a transaction could have been mined into a block.

vin

array

An array of transaction objects used as inputs for the current transaction

txid

string

The transaction id

vout

array

The output index

sequence

integer

The transaction sequence

n

integer

The nonce of this transaction

addresses

array

An array of addresses in this transaction

isAddress

boolean

Boolean value of whether there is an address or not

value

string

The value of this transaction in zatoshis

vout

array

An array of output transaction objects for the current transaction

value

string

The value of this transaction in zatoshis

n

integer

The nonce of this transaction

spent

boolean

Boolean value of whether the transaction has been spent

addresses

array

An array of addresses in this transaction

isAddress

boolean

Boolean value of whether there is an address or not

blockHash

string

The hash of the block at which the transaction was included

blockHeight

integer

The block height at which the transaction was included

confirmations

integer

The number of confirmations since this transaction was included in a block

blockTime

integer

The unix timestamp of when the block was confirmed

value

string

The total value of the transaction in zatoshis

valueIn

string

The value transmitted in the transaction less fees denominated in zatoshis

fees

string

The transaction fees denominated in zatoshis

Request

1
curl -X POST "https://docs-demo.zec-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getAddress",
6
  "params": [
7
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
8
    {
9
      "page": 1,
10
      "size": 1000,
11
      "fromHeight": 0,
12
      "details": "txids"
13
    }
14
  ],
15
  "id": 1
16
}'

1
curl -X POST "https://docs-demo.zec-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getAddress",
6
  "params": [
7
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
8
    {
9
      "page": 1,
10
      "size": 1000,
11
      "fromHeight": 0,
12
      "details": "txids"
13
    }
14
  ],
15
  "id": 1
16
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'bb_getAddress',
4
    params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"page":1,"size":1000,"fromHeight":0,"details":"txids"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.zec-mainnet.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_getAddress',
4
    params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"page":1,"size":1000,"fromHeight":0,"details":"txids"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.zec-mainnet.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.zec-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "bb_getAddress",
9
  "params": [
10
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
11
    {
12
      "page": 1,
13
      "size": 1000,
14
      "fromHeight": 0,
15
      "details": "txids"
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.zec-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "bb_getAddress",
9
  "params": [
10
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
11
    {
12
      "page": 1,
13
      "size": 1000,
14
      "fromHeight": 0,
15
      "details": "txids"
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.zec-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "bb_getAddress",
11
  params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"page":1,"size":1000,"fromHeight":0,"details":"txids"}]
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.zec-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "bb_getAddress",
11
  params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"page":1,"size":1000,"fromHeight":0,"details":"txids"}]
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
    "page": 1,
5
    "totalPages": 58650,
6
    "itemsOnPage": 2,
7
    "address": "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
8
    "balance": "285009781003",
9
    "totalReceived": "25873951714497",
10
    "totalSent": "25588941933494",
11
    "unconfirmedBalance": "0",
12
    "unconfirmedTxs": 0,
13
    "txs": 117299,
14
    "txids": [
15
      "65c2220429d7858d42ca8741cb4170f64660bf189b9aeb82f13dd6cbbfb316ce",
16
      "c7a5aba940d88b4a54c4e42350fc6d5f7af025e692c8ce5da932ab9c80306dcb"
17
    ]
18
  },
19
  "jsonrpc": "2.0"
20
}

1
{
2
  "id": 1,
3
  "result": {
4
    "page": 1,
5
    "totalPages": 58650,
6
    "itemsOnPage": 2,
7
    "address": "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
8
    "balance": "285009781003",
9
    "totalReceived": "25873951714497",
10
    "totalSent": "25588941933494",
11
    "unconfirmedBalance": "0",
12
    "unconfirmedTxs": 0,
13
    "txs": 117299,
14
    "txids": [
15
      "65c2220429d7858d42ca8741cb4170f64660bf189b9aeb82f13dd6cbbfb316ce",
16
      "c7a5aba940d88b4a54c4e42350fc6d5f7af025e692c8ce5da932ab9c80306dcb"
17
    ]
18
  },
19
  "jsonrpc": "2.0"
20
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free