Get address information

GET

https://base-blockbook.nownodes.io/api/v2/address/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns detailed information about a Bitcoin address such as balance, total received and sent, unconfirmed transactions, list of txids, and more. Supports pagination and filtering by block height and details.

Parameters

addressstringrequiredpath

Bitcoin address 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.

contractstringquery

Filter by contract address (optional).

secondarystringquery

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

Response

200OK

Successful response with address details

400Bad Request

Invalid address or bad request

404Not Found

Address not found

500Internal Server Error

Internal server error

Get address information

curl -X GET 'https://base-blockbook.nownodes.io/api/v2/address/{address}'

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://base-blockbook.nownodes.io/api/v2/address/{address}')
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": "bc1qll4224u6ecldm02xs250h20ax9u6dc4pl9332d",
  "balance": "0",
  "totalReceived": "4555309",
  "totalSent": "4555309",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 2,
  "txids": [
    "99446b8a7d2d61301ef6d4e34d65ee179da9d15daec46d8ca746ce9984ba31d1",
    "44d575c325e9ee502a67364b1d9537d3d3233f4047bbae42888838ececb8cf86"
  ]
}

{
  "error": "Invalid address format"
}

{
  "error": "Address not found"
}

{
  "error": "Internal server error"
}