Get XPUB or descriptor details

GET

https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves detailed information about an XPUB or descriptor including confirmed balance, total received and sent amounts, unconfirmed balances, transaction counts, tokens used, and paginated transaction IDs.

Parameters

xpubOrDescriptorstringrequiredpath

XPUB or descriptor to query.

pageinteger1query

Page number for pagination (default is 1).

pageSizeinteger1000query

Number of items per page (default 1000).

fromintegerquery

Starting block height to filter transactions (optional).

tointegerquery

Ending block height to filter transactions (optional).

detailsstringbasictokenstokenBalancestxidstxsquery

Level of transaction detail to return. Options:

basic: Basic transaction info.
tokens: Include token info.
tokenBalances: Include token balances.
txids: Return only transaction IDs.
txs: Return full transaction details.

tokensstringnonzerousedderivedquery

Filter tokens by usage type:

nonzero: Tokens with non-zero balances.
used: Tokens that have been used.
derived: Tokens derived from this XPUB.

secondarystringquery

Include secondary currency balances (e.g., EUR).

Response

200OK

Successful response with XPUB details

400Bad Request

Invalid XPUB or bad request

404Not Found

XPUB not found

500Internal Server Error

Internal server error

Get XPUB or descriptor details

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}')
data = response.json()

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB",
  "balance": "0",
  "totalReceived": "2063000",
  "totalSent": "2063000",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 18,
  "addrTxCount": 18,
  "txids": [
    "b435109b7e6ad2b8181583cbf51fcdefe618959cf8bc4f7d45b6d1f5c0c79f89",
    "06577f9c46abed29c32a6f3921dc3bf3cfb2b2f8e7e0b96d281b8ca4e26185d9",
    "9e29a01ca3bb3aa878d25279dc0761efb34de402744ef46b94c057f964ed8628",
    "657f6e76df55a65356d98371370e9f512d1c5d41a01d0d12467edc0609640444",
    "5256a1c98272d1525b46d96b4c01abe62737b8b5932df313c535ab7ebfd4658f",
    "9f127de1c7dc91ef69bec8f0ec5900bda86cec65cb9ace25b6507d410c478a65",
    "9146c7e0a9e7d3d7dd0c4be8bce00d088a25a0bae333d00f22f559a566d7fa41",
    "5caa0c516b2e39b560b7ccfee86824c001e798d20b72e9ea58b3284c46c77d18",
    "90c36964f0e161dcbe054d5201e4fbb8e51782289658893eb00d5dab4547750a",
    "c8d3da26fd0e5a98ef15856becee55fddd2178b8c4fdc786f116251d04bc444d",
    "80c7b9836ae6156a1574f380bb277c712405ebc8e415e34ae61653b2212c7be8",
    "3abc1608b70f0ed319a9a43eb5ed631c39ff8ff57b717652ab45a0c9729ef6ac",
    "62cca9c94fbc618df729d0f1f937222bc9be9de153d7cb1abd4abafdd4f5f1b5",
    "8a82f253ca23b870f2b2f23d3a3cb3aeb26057e21431c35d5f48bd40d78d7c30",
    "99e6806d5253649a758d3e23c66fb48642fd321efdebf4eb1ae78cbdd2fdc8df",
    "318d068ea98fb1ce64cfacf3bd992b87fb78be52289cad14d1ccfd4d472d964f",
    "66a4185ef490e31434e2f11fdf22fc0e58c5acef1b744cb0598daae2979acfce",
    "6398de55c404e897b60cf19f55ab9d9daee95227378164c1a89a820b4d4e779b"
  ],
  "usedTokens": 9
}

{
  "error": "Invalid XPUB format"
}

{
  "error": "XPUB not found"
}

{
  "error": "Internal server error"
}