Parameters

pool

string

REQUIRED

The shielded pool to query: "sapling" or "orchard"

start_index

integer

REQUIRED

The index of the first subtree to return

limit

integer

The maximum number of subtrees to return (optional)

Returns

pool

string

The shielded pool (sapling or orchard)

start_index

integer

The index of the first returned subtree

subtrees

array

An array of subtree information

root

string

The root hash of the subtree

end_height

integer

The block height at which the subtree was completed

error

string

(Optional) The error message, if any

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": "z_getsubtreesbyindex",
6
  "params": [
7
    "sapling",
8
    0,
9
    5
10
  ],
11
  "id": 1
12
}'

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": "z_getsubtreesbyindex",
6
  "params": [
7
    "sapling",
8
    0,
9
    5
10
  ],
11
  "id": 1
12
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'z_getsubtreesbyindex',
4
    params: ["sapling",0,5],
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: 'z_getsubtreesbyindex',
4
    params: ["sapling",0,5],
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": "z_getsubtreesbyindex",
9
  "params": [
10
    "sapling",
11
    0,
12
    5
13
  ],
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
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": "z_getsubtreesbyindex",
9
  "params": [
10
    "sapling",
11
    0,
12
    5
13
  ],
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
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: "z_getsubtreesbyindex",
11
  params: ["sapling",0,5]
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: "z_getsubtreesbyindex",
11
  params: ["sapling",0,5]
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
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "pool": "sapling",
6
    "start_index": 0,
7
    "subtrees": [
8
      {
9
        "root": "754bb593ea42d231a7ddf367640f09bbf59dc00f2c1d2003cc340e0c016b5b13",
10
        "end_height": 558822
11
      },
12
      {
13
        "root": "03654c3eacbb9b93e122cf6d77b606eae29610f4f38a477985368197fd68e02d",
14
        "end_height": 670209
15
      },
16
      {
17
        "root": "e2bf698f5ac10b44da560d11a5e1d5c191a82a968a2be0a6948aa8748b545160",
18
        "end_height": 780364
19
      },
20
      {
21
        "root": "e71be1fd3963a2d700ed374d01fdd4a70d8dda8189a8f6602e5fe66c2c66a11d",
22
        "end_height": 839994
23
      },
24
      {
25
        "root": "f1c57245fff8dbc2d3efe5a0953eafdedeb06e18a3ad4f1e4042ee76623f8032",
26
        "end_height": 916404
27
      }
28
    ]
29
  }
30
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "pool": "sapling",
6
    "start_index": 0,
7
    "subtrees": [
8
      {
9
        "root": "754bb593ea42d231a7ddf367640f09bbf59dc00f2c1d2003cc340e0c016b5b13",
10
        "end_height": 558822
11
      },
12
      {
13
        "root": "03654c3eacbb9b93e122cf6d77b606eae29610f4f38a477985368197fd68e02d",
14
        "end_height": 670209
15
      },
16
      {
17
        "root": "e2bf698f5ac10b44da560d11a5e1d5c191a82a968a2be0a6948aa8748b545160",
18
        "end_height": 780364
19
      },
20
      {
21
        "root": "e71be1fd3963a2d700ed374d01fdd4a70d8dda8189a8f6602e5fe66c2c66a11d",
22
        "end_height": 839994
23
      },
24
      {
25
        "root": "f1c57245fff8dbc2d3efe5a0953eafdedeb06e18a3ad4f1e4042ee76623f8032",
26
        "end_height": 916404
27
      }
28
    ]
29
  }
30
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free