GET /api/v2/xpub/{xpub} - Blockbook REST API

Please note that this REST method requires the Bitcoin Cash Blockbook add-on enabled on your QuickNode endpoint.

Path Parameters

xpub

string

REQUIRED

Loading...

Query Parameters

page

integer

Loading...

size

integer

Loading...

fromHeight

integer

Loading...

details

string

Loading...

Returns

page

integer

Loading...

totalPages

integer

Loading...

itemsOnPage

integer

Loading...

address

string

Loading...

balance

string

Loading...

totalReceived

string

Loading...

totalSent

string

Loading...

unconfirmedBalance

string

Loading...

unconfirmedTxs

integer

Loading...

txs

integer

Loading...

txids

array

Loading...

tokens

array

Loading...

type

string

Loading...

name

string

Loading...

path

string

Loading...

transfers

integer

Loading...

decimals

integer

Loading...

balance

string

Loading...

totalReceived

string

Loading...

totalSent

string

Loading...

Request

1
curl -X GET "https://docs-demo.bch-mainnet.quiknode.pro/xpub/xpub661MyMwAqRbcGrx39FhTVkPJSd1oMiD8P8Vu4EP8SHyuvhqnaqu9VeK4m43WPPXouHpuUakK77Y6GzqCCKYYiCTsxhPBjmqhrfHqosmEFjL?page=1&size=1000&fromHeight=0&details=txids" \
2
  -H "Content-Type: application/json"

1
curl -X GET "https://docs-demo.bch-mainnet.quiknode.pro/xpub/xpub661MyMwAqRbcGrx39FhTVkPJSd1oMiD8P8Vu4EP8SHyuvhqnaqu9VeK4m43WPPXouHpuUakK77Y6GzqCCKYYiCTsxhPBjmqhrfHqosmEFjL?page=1&size=1000&fromHeight=0&details=txids" \
2
  -H "Content-Type: application/json"

1
async function main() {
2
    const response = await fetch('https://docs-demo.bch-mainnet.quiknode.pro/xpub/xpub661MyMwAqRbcGrx39FhTVkPJSd1oMiD8P8Vu4EP8SHyuvhqnaqu9VeK4m43WPPXouHpuUakK77Y6GzqCCKYYiCTsxhPBjmqhrfHqosmEFjL?page=1&size=1000&fromHeight=0&details=txids', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://docs-demo.bch-mainnet.quiknode.pro/xpub/xpub661MyMwAqRbcGrx39FhTVkPJSd1oMiD8P8Vu4EP8SHyuvhqnaqu9VeK4m43WPPXouHpuUakK77Y6GzqCCKYYiCTsxhPBjmqhrfHqosmEFjL?page=1&size=1000&fromHeight=0&details=txids', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.bch-mainnet.quiknode.pro/xpub/xpub661MyMwAqRbcGrx39FhTVkPJSd1oMiD8P8Vu4EP8SHyuvhqnaqu9VeK4m43WPPXouHpuUakK77Y6GzqCCKYYiCTsxhPBjmqhrfHqosmEFjL?page=1&size=1000&fromHeight=0&details=txids"
5

6
headers = {
7
  'Content-Type': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers)
11

12
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.bch-mainnet.quiknode.pro/xpub/xpub661MyMwAqRbcGrx39FhTVkPJSd1oMiD8P8Vu4EP8SHyuvhqnaqu9VeK4m43WPPXouHpuUakK77Y6GzqCCKYYiCTsxhPBjmqhrfHqosmEFjL?page=1&size=1000&fromHeight=0&details=txids"
5

6
headers = {
7
  'Content-Type': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers)
11

12
print(response.text)

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

5
uri = URI("https://docs-demo.bch-mainnet.quiknode.pro/xpub/xpub661MyMwAqRbcGrx39FhTVkPJSd1oMiD8P8Vu4EP8SHyuvhqnaqu9VeK4m43WPPXouHpuUakK77Y6GzqCCKYYiCTsxhPBjmqhrfHqosmEFjL?page=1&size=1000&fromHeight=0&details=txids")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9

10
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
11
  http.request(request)
12
end
13

14
puts response.body

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

5
uri = URI("https://docs-demo.bch-mainnet.quiknode.pro/xpub/xpub661MyMwAqRbcGrx39FhTVkPJSd1oMiD8P8Vu4EP8SHyuvhqnaqu9VeK4m43WPPXouHpuUakK77Y6GzqCCKYYiCTsxhPBjmqhrfHqosmEFjL?page=1&size=1000&fromHeight=0&details=txids")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9

10
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
11
  http.request(request)
12
end
13

14
puts response.body

Response

1
{
2
  "page": 1,
3
  "totalPages": 1,
4
  "itemsOnPage": 1000,
5
  "address": "xpub...",
6
  "balance": "0",
7
  "totalReceived": "0",
8
  "totalSent": "0",
9
  "unconfirmedBalance": "0",
10
  "unconfirmedTxs": 0,
11
  "txs": 0,
12
  "tokens": []
13
}

1
{
2
  "page": 1,
3
  "totalPages": 1,
4
  "itemsOnPage": 1000,
5
  "address": "xpub...",
6
  "balance": "0",
7
  "totalReceived": "0",
8
  "totalSent": "0",
9
  "unconfirmedBalance": "0",
10
  "unconfirmedTxs": 0,
11
  "txs": 0,
12
  "tokens": []
13
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free