Get UTXOs for address, XPUB or descriptor

GET

https://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves the unspent transaction outputs (UTXOs) associated with a specific address, XPUB, or descriptor. Optionally filter only confirmed UTXOs by using the confirmed query parameter.

Parameters

addressOrXpubOrDescriptorstringrequiredpath

Address, XPUB or descriptor to query UTXOs for.

confirmedbooleanfalsequery

If true, only return confirmed UTXOs. Defaults to false (returns both confirmed and unconfirmed).

Response

200OK

List of UTXOs for the given address, XPUB, or descriptor

400Bad Request

Invalid address or parameter error

404Not Found

No UTXOs found for the specified input

500Internal Server Error

Internal server error

Get UTXOs for address, XPUB or descriptor

curl -X GET 'https://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}'

const response = await fetch('https://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}')
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://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}')
data = response.json()

const response = await fetch('https://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}";
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://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://dgbbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}')
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)

[
  {
    "txid": "99446b8a7d2d61301ef6d4e34d65ee179da9d15daec46d8ca746ce9984ba31d1",
    "vout": 0,
    "value": "4555309",
    "height": 700000,
    "confirmations": 100,
    "coinbase": false,
    "spent": false
  },
  {
    "txid": "44d575c325e9ee502a67364b1d9537d3d3233f4047bbae42888838ececb8cf86",
    "vout": 1,
    "value": "1000000",
    "height": 699900,
    "confirmations": 200,
    "coinbase": true,
    "spent": false
  }
]

{
  "error": "Invalid address format"
}

{
  "error": "No UTXOs found"
}

{
  "error": "Internal server error"
}