Blockbook API Changes 0.5.0 > 0.6.0 - Groestlcoin (GRS) Blockbook - modified methods

vv0.6.0-changelog

Base URL

https://grsbook.nownodes.io

Methods of the NOWNodes Groestlcoin (GRS) Blockbook API (https://grsbook.nownodes.io) whose behaviour changed between Blockbook 0.5.0 and 0.6.0. Each method is documented as it exists in 0.6.0, with a short note at the top describing what changed. Methods not listed here work exactly as before.

Authentication

api-keyAuthapiKey

NOWNodes API key passed in the api-key header.

API Key: api-key in header

MAINNET / Blockbook 0.5.0 > 0.6.0 API CHANGES / Modified methods

BlockBook

BlockBook operations.

Get a block by height or hash.

GET

https://grsbook.nownodes.io/api/v2/block/{blockId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: page is now validated: values above 1,000,000 are capped and invalid values fall back to the first page. Documented as it exists in 0.6.0.

Returns block information with paged transactions. When full transaction details are unavailable, the response can contain only transaction ids.

Blockbook follows the backend main chain. Height lookups always return the current main-chain block. Hash lookups can return a block from another fork only if the backend still keeps it.

Load estimate: Medium; grows mainly with block transaction count and requested page.

Parameters

blockIdstringrequiredpath

Block height or block hash.

pageinteger>= 1query

1-based page index. Values outside safe bounds are sanitized to the closest possible page.

Response

200OK

Block details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get a block by height or hash.

curl -X GET 'https://grsbook.nownodes.io/api/v2/block/{blockId}'

const response = await fetch('https://grsbook.nownodes.io/api/v2/block/{blockId}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

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

const response = await fetch('https://grsbook.nownodes.io/api/v2/block/{blockId}', {
  method: 'GET',
});

const data = await response.json();

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

const data = await response.json();

import requests

response = requests.get('https://grsbook.nownodes.io/api/v2/block/{blockId}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/block/{blockId}')
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,
  "hash": "00000000000021a04e12da76ea0b397e93c13d1fbf7698bea70e7aad5a62f283",
  "previousBlockHash": "0000000000006326566e6ddf7a4a98e47e49bc800018035461c8e555ba2c41bb",
  "nextBlockHash": "00000000000080f930ce5dd8bc4d085a5b37410ff75c192abb75a5c334cda836",
  "height": 6206956,
  "confirmations": 2,
  "size": 332,
  "time": 1786180038,
  "version": 536870912,
  "merkleRoot": "a9edf8020cdccfdaa3987c2628930058d4e1fb0f08a882a59417b001d17af99c",
  "nonce": "2183615578",
  "bits": "1b00cb4b",
  "difficulty": "82526.02194339296",
  "tx": [
    "2b9fc57aaa8d01975631a703b0fc3f11d70671953fc769533b8078a04d029bf9"
  ],
  "txCount": 1,
  "txs": [],
  "addressAliases": {}
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get compact block filters.

GET

https://grsbook.nownodes.io/api/v2/block-filters

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: The requested range is now limited to 10,000 blocks: lastN is capped at 10,000, and a from/to range wider than that is rejected with an error. Documented as it exists in 0.6.0.

Returns compact block filters for the configured script type. Provide either lastN or a from/to range. When to is omitted for a range, the current best height is used.

Compact block filters are not currently enabled on the NOWNodes Groestlcoin endpoint. Requests succeed and return the requested heights with their block hashes, but each filter value comes back empty. Send scriptType empty, as no script type is configured.

Load estimate: High for wide ranges; work and payload grow linearly with the number of requested filters.

Parameters

scriptTypestringrequiredquery

Script type used for block filters. No script type is configured on the NOWNodes Groestlcoin endpoint, so send this parameter empty.

lastNinteger>= 1query

Return filters for the last N blocks.

frominteger>= 0query

First block height in the requested range.

tointeger>= 0query

Last block height in the requested range. Defaults to the current best height when omitted.

Response

200OK

Block filters keyed by block height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get compact block filters.

curl -X GET 'https://grsbook.nownodes.io/api/v2/block-filters/'

const response = await fetch('https://grsbook.nownodes.io/api/v2/block-filters/', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/block-filters/')
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://grsbook.nownodes.io/api/v2/block-filters/')
data = response.json()

const response = await fetch('https://grsbook.nownodes.io/api/v2/block-filters/', {
  method: 'GET',
});

const data = await response.json();

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

const data = await response.json();

import requests

response = requests.get('https://grsbook.nownodes.io/api/v2/block-filters/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/block-filters/')
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)

{
  "P": 0,
  "M": 1,
  "zeroedKey": false,
  "blockFilters": {
    "860730": {
      "blockHash": "00000000000021a04e12da76ea0b397e93c13d1fbf7698bea70e7aad5a62f283",
      "filter": "0286f0..."
    }
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid scriptType taproot. Use "
}

Broadcast a raw transaction using the request body.

POST

https://grsbook.nownodes.io/api/v2/sendtx

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: The request body is now limited to 8 MiB; larger bodies are rejected before broadcasting. Documented as it exists in 0.6.0.

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Alternative schema variant for this parameter or payload.

string

Response

200OK

Broadcast result.

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

default

Public API error.

Broadcast a raw transaction using the request body.

curl -X POST 'https://grsbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"'

const response = await fetch('https://grsbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"),
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/sendtx/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'text/plain'
request.body = '"0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"'

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

import requests

payload = "0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"

response = requests.post('https://grsbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

const response = await fetch('https://grsbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"),
});

const data = await response.json();

const endpoint = "https://grsbook.nownodes.io/api/v2/sendtx/";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest("0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b");
console.log(result);

const response = await fetch('https://grsbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"),
});

const data = await response.json();

import requests

payload = "0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"

response = requests.post('https://grsbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/sendtx/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'text/plain'
request.body = '"0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"'

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

Request Body

0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b

{
  "result": "e37ec95c424bd7c2ddbab8f5e75b93f70c1a14be4be2c93eb995ab117379e488"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "e37ec95c424bd7c2ddbab8f5e75b93f70c1a14be4be2c93eb995ab117379e488"
}

{
  "error": "-22: TX decode failed. Make sure the tx has at least one input."
}

Get address/account details.

GET

https://grsbook.nownodes.io/api/v2/address/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: With details=basic, mempool transactions are no longer loaded one by one: unconfirmedBalance, unconfirmedSending and unconfirmedReceiving are omitted, and unconfirmedTxs reports the raw number of mempool entries for the address. Any other details value still returns the aggregated unconfirmed balance. page and pageSize are now validated: page is capped at 1,000,000, and when page × pageSize exceeds 100,000 the page is clamped to the last allowed one. Negative or non-numeric values fall back to the defaults. from and to are bounded to non-negative block heights. New protocols query parameter; it is supported on Ethereum-type networks only, so on this chain any value is rejected with an error. Documented as it exists in 0.6.0.

Returns balances and transactions of an address. Transactions are sorted by block height with newest blocks first. Response size is controlled by the details parameter.

At details=basic, mempool transactions are not aggregated: unconfirmedBalance, unconfirmedSending, and unconfirmedReceiving are omitted, and unconfirmedTxs reports the raw mempool index size for the address.

Load estimate: Variable; basic is low, token/tokenBalances and txids/txslight are medium, and txs can be high as it grows with pageSize, transactions, token rows, filters, and protocol enrichment.

Parameters

addressstringrequiredpath

Groestlcoin address, XPUB, or descriptor value accepted by Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringusednonzeroderivedquery

Token list mode for the address response. Use used to include tokens used by the address, nonzero to include only non-zero balances, or derived to include derived token information when supported.

secondarystringquery

Secondary currency code. When set, balance and transaction fields are additionally returned in this currency.

contractstringquery

Smart-contract address used to filter token-related address data.

filterstring | integerquery

Filter account history by input/output side, or by numeric token/internal filter id.

protocolsArray<string>query

Optional protocol enrichments. Available on Ethereum-type networks only; on Groestlcoin any value returns an error, so the parameter should be omitted.

Response

200OK

Address/account details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get address/account details.

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://grsbook.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": 117,
  "itemsOnPage": 2,
  "address": "grs1qnj99jamn05y0sd4zwayakm5awpwn8zjujkxfdt",
  "balance": "1500000000",
  "totalReceived": "59500135411",
  "totalSent": "58000135411",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 233,
  "txids": [
    "117ec2786087eebdfeedae0d1c9adee6841d01bbf4e227202cf6a5ac4caf0ef7",
    "d0a515c62709c64dd31cf4b7b99775df238084d0f87564149a03d43f98ef332e"
  ]
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid address "
}

Get XPUB or descriptor account details.

GET

https://grsbook.nownodes.io/api/v2/xpub/{xpub}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: page and pageSize are now validated: page is capped at 1,000,000, and when page × pageSize exceeds 100,000 the page is clamped to the last allowed one. Negative or non-numeric values fall back to the defaults. from and to are bounded to non-negative block heights. XPUB/descriptor scans are bounded: gap is capped at 10,000, a descriptor may list at most 10 change indexes, and a descriptor whose total derivation scan exceeds the server limit is rejected with an error. Documented as it exists in 0.6.0.

Not available on this endpoint: the request returns HTTP 500 with {"error":"Internal server error"}.

Returns balances and transactions of an XPUB or output descriptor for Bitcoin-type coins. Transactions are sorted by block height with newest blocks first. URL-encode descriptors before placing them after /xpub/.

Blockbook expects XPUBs at level 3 of the derivation path, for example m/purpose'/coin_type'/account'. It derives the remaining change/address_index path. The BIP scheme is inferred from the XPUB prefix; unknown prefixes default to BIP44.

Supported descriptors are pkh(xpub), sh(wpkh(xpub)), wpkh(xpub), and tr(xpub). Descriptors can include origin paths and change selectors such as <0;1> or {0,1}; when change is omitted, Blockbook defaults to <0;1>.

Note: usedTokens always reports the total number of used addresses for the XPUB, regardless of the tokens query filter.

Load estimate: High for broad accounts; grows with derived addresses, gap, used address count, pageSize, transaction history, token rows, and protocol enrichment.

Parameters

xpubstringrequiredpath

Extended public key or output descriptor to query in Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringnonzerousedderivednonzeroquery

Controls which XPUB-derived address rows are included.

filterstring | integerquery

Filter by input/output side or numeric id.

contractstringquery

Contract address filter.

protocolsArray<string>query

Protocol enrichments.

secondarystringquery

Secondary currency code.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

XPUB/descriptor account details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get XPUB or descriptor account details.

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/xpub/{xpub}')
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": "xpub661MyMwAqRbcFtXgS5sYJABqqG9YLmC4Q1Rdap9gSE8NqtwybGhePY2gZ29ESFjqJoCu1Rupje8YtGqsefD265TMg7usUDFdp6W1EGMcet8",
  "balance": "0",
  "totalReceived": "426500",
  "totalSent": "426500",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "unconfirmedSending": "0",
  "unconfirmedReceiving": "0",
  "txs": 24,
  "addrTxCount": 24,
  "nonTokenTxs": 0,
  "internalTxs": 0,
  "transactions": [],
  "txids": [
    "13549d9bbea98d362a54fb5d96935db3d4d9a831b1e13163720386f7bc1ee7cd"
  ],
  "nonce": "0",
  "usedTokens": 5,
  "tokens": [
    {
      "type": "XPUBAddress",
      "standard": "XPUBAddress",
      "path": "m/44'/0'/0'/0/0",
      "transfers": 3,
      "decimals": 8,
      "balance": "90000000",
      "totalReceived": "2903986975",
      "totalSent": "2803986975"
    }
  ],
  "secondaryValue": 21195.47633568,
  "tokensBaseValue": 0,
  "tokensSecondaryValue": 0,
  "totalBaseValue": 0,
  "totalSecondaryValue": 21195.47633568,
  "contractInfo": {
    "type": "ERC20",
    "standard": "ERC20",
    "contract": "string",
    "name": "Token",
    "symbol": "TKN",
    "decimals": 18,
    "createdInBlock": 0,
    "destructedInBlock": 0,
    "rates": {
      "baseRate": 0.000523,
      "currency": "usd",
      "secondaryRate": 1.24
    },
    "protocols": {
      "erc4626": {
        "asset": {
          "contract": "string",
          "name": "WETH",
          "symbol": "WETH",
          "decimals": 18
        },
        "share": {
          "contract": "string",
          "name": "vToken",
          "symbol": "vToken",
          "decimals": 18
        },
        "totalAssets": "123456789",
        "convertToAssets1Share": "1000000000000000000",
        "convertToShares1Asset": "1000000000000000000",
        "previewDeposit1Asset": "999999999999999999",
        "previewRedeem1Share": "1000000000000000000",
        "error": "string"
      }
    },
    "blockHeight": 12345678
  },
  "addressAliases": {},
  "stakingPools": [],
  "chainExtraData": {
    "payloadType": "tron"
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Missing xpub"
}

Get UTXOs for an address, XPUB, or descriptor.

GET

https://grsbook.nownodes.io/api/v2/utxo/{descriptor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: XPUB/descriptor scans are bounded: gap is capped at 10,000, a descriptor may list at most 10 change indexes, and a descriptor whose total derivation scan exceeds the server limit is rejected with an error. Documented as it exists in 0.6.0.

Returns unspent outputs for an address, XPUB, or descriptor on Bitcoin-type coins. By default both confirmed and unconfirmed UTXOs are returned; confirmed=true filters out unconfirmed entries. Results are sorted by block height with newest entries first.

Unconfirmed UTXOs omit height, have confirmations set to 0, and can include lockTime. XPUB and descriptor UTXOs also include address and derivation path when available. Coinbase UTXOs include coinbase=true only up to the coinbase confirmation limit, currently 100 blocks.

Load estimate: Variable; address lookups are usually medium, while XPUB/descriptor lookups grow with gap, derived addresses, and UTXO count.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

confirmedbooleanquery

When true, return only confirmed UTXOs.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

UTXO list.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get UTXOs for an address, XPUB, or descriptor.

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/utxo/{descriptor}')
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": "0d6afe812918f667641ed277bf1f40e878b37ff6ad9d796fb96de51e5f3450e2",
    "vout": 1,
    "value": "500000000",
    "height": 6206845,
    "confirmations": 113,
    "address": "string",
    "path": "m/84'/0'/0'/0/0",
    "lockTime": 0,
    "coinbase": true
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid address 'notanaddress', checksum mismatch"
}

Get account balance history.

GET

https://grsbook.nownodes.io/api/v2/balancehistory/{descriptor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: A request that spans more than 100,000 transactions in the selected from/to range is now rejected with an error asking to narrow the range, instead of being processed in full. XPUB/descriptor scans are bounded: gap is capped at 10,000, a descriptor may list at most 10 change indexes, and a descriptor whose total derivation scan exceeds the server limit is rejected with an error. Fiat currency selectors are bounded: at most 128 currency codes, each at most 16 characters. Documented as it exists in 0.6.0.

Returns balance history points for an address, XPUB, or descriptor. from and to are Unix timestamps. groupBy is an aggregation interval in seconds and defaults to 3600. When fiatcurrency is omitted, rates can contain all available currencies. sentToSelf is the amount sent from an address to itself or within addresses of the same XPUB.

Load estimate: High; grows with account transaction history, time span, grouping cardinality, fiat rate lookups, and XPUB/descriptor gap.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

frominteger<int64>query

Unix timestamp lower bound.

tointeger<int64>query

Unix timestamp upper bound.

fiatcurrencystringquery

Optional fiat currency code to include in rates.

groupByinteger>= 1query

Aggregation interval in seconds. Defaults to 3600.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

Balance history points.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get account balance history.

curl -X GET 'https://grsbook.nownodes.io/api/v2/balancehistory/{descriptor}'

const response = await fetch('https://grsbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

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

const response = await fetch('https://grsbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

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

const data = await response.json();

import requests

response = requests.get('https://grsbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

require 'net/http'
require 'json'

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

[
  {
    "time": 1785898800,
    "txs": 5,
    "received": "627791049",
    "sent": "0",
    "sentToSelf": "100000",
    "rates": {
      "usd": 64345.492,
      "eur": 55589.92
    }
  },
  {
    "time": 1785902400,
    "txs": 1,
    "received": "0",
    "sent": "627791049",
    "sentToSelf": "0",
    "rates": {
      "usd": 64107.65,
      "eur": 55589.92
    }
  }
]

[
  {
    "time": 1785898800,
    "txs": 5,
    "received": "627791049",
    "sent": "0",
    "sentToSelf": "0",
    "rates": {
      "usd": 64345.492
    }
  },
  {
    "time": 1785902400,
    "txs": 1,
    "received": "0",
    "sent": "627791049",
    "sentToSelf": "0",
    "rates": {
      "usd": 64107.65
    }
  }
]

[
  {
    "time": 1786147200,
    "txs": 1,
    "received": "0",
    "sent": "500000000",
    "sentToSelf": "0",
    "rates": {
      "aed": 0.086084,
      "ars": 35.14,
      "aud": 0.03316835,
      "bdt": 2.89,
      "bhd": 0.00881321,
      "bmd": 0.02344007,
      "brl": 0.119481,
      "btc": 3.69223e-7,
      "cad": 0.03270006,
      "chf": 0.01894004,
      "clp": 21.41,
      "cny": 0.158152,
      "czk": 0.491822,
      "dkk": 0.15161,
      "eth": 0.00001223,
      "eur": 0.02027688,
      "gbp": 0.0173746,
      "hkd": 0.183863,
      "huf": 7.37,
      "idr": 417.26,
      "ils": 0.070317,
      "inr": 2.23,
      "jpy": 3.7,
      "krw": 33,
      "kwd": 0.007201,
      "lkr": 7.84,
      "mmk": 49.22,
      "mxn": 0.401677,
      "myr": 0.095872,
      "ngn": 31.99,
      "nok": 0.222971,
      "nzd": 0.03978625,
      "php": 1.42,
      "pkr": 6.49,
      "pln": 0.087084,
      "rub": 1.93,
      "sar": 0.088103,
      "sek": 0.222231,
      "sgd": 0.02995875,
      "thb": 0.77105,
      "try": 1.12,
      "twd": 0.755956,
      "uah": 1.047,
      "usd": 0.02344007,
      "vnd": 614.24,
      "zar": 0.378471
    }
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Missing address"
}

Get current or historical fiat rates.

GET

https://grsbook.nownodes.io/api/v2/tickers

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: Fiat currency selectors are bounded: at most 128 currency codes, each at most 16 characters. Fiat rates are fetched more reliably: CoinGecko throttling (HTTP 429) is handled and missing daily rates are filled in automatically, so fewer timestamps come back without a rate. Documented as it exists in 0.6.0.

Returns currency rates for the requested currency and date. If a rate is unavailable for the exact timestamp, the closest available rate can be returned. Responses include the actual rate timestamp. Without a currency parameter, all available currencies can be returned. A rate of -1 marks an unavailable or invalid currency for that timestamp.

Load estimate: Low to medium; specific currency lookups are cheap, while omitted currency and token lookups increase response size.

Parameters

currencystringquery

Optional currency code. When omitted, all available rates can be returned.

timestampinteger<int64>query

Unix timestamp for historical rates.

blockstringquery

Block height or hash whose timestamp should be used for historical rates.

tokenstringquery

Optional token symbol or contract/address key for token-specific rates.

Response

200OK

Fiat rate ticker.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error. Returned when no fiat rate is available for the requested currency or timestamp.

Get current or historical fiat rates.

curl -X GET 'https://grsbook.nownodes.io/api/v2/tickers/'

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

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/tickers/')
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://grsbook.nownodes.io/api/v2/tickers/')
data = response.json()

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

const data = await response.json();

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

const data = await response.json();

import requests

response = requests.get('https://grsbook.nownodes.io/api/v2/tickers/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/tickers/')
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)

{
  "ts": 1785902400,
  "rates": {
    "eur": 55589.92,
    "usd": 64107.65
  }
}

{
  "ts": 1785902400,
  "rates": {
    "usd": 64107.65
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Parameter 'timestamp' is not a valid Unix timestamp."
}

Get fiat rates for multiple timestamps.

GET

https://grsbook.nownodes.io/api/v2/multi-tickers

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: At most 1,000 timestamps are accepted per request; longer lists are rejected with an error. Fiat currency selectors are bounded: at most 128 currency codes, each at most 16 characters. Fiat rates are fetched more reliably: CoinGecko throttling (HTTP 429) is handled and missing daily rates are filled in automatically, so fewer timestamps come back without a rate. Documented as it exists in 0.6.0.

Returns fiat rate tickers for a comma-separated list of Unix timestamps.

Load estimate: Medium; work and payload grow linearly with timestamp count, plus token/currency selection.

Parameters

timestampstringrequiredquery

Comma-separated Unix timestamps.

currencystringquery

Optional currency code.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

Fiat rate tickers.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get fiat rates for multiple timestamps.

curl -X GET 'https://grsbook.nownodes.io/api/v2/multi-tickers/'

const response = await fetch('https://grsbook.nownodes.io/api/v2/multi-tickers/', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/multi-tickers/')
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://grsbook.nownodes.io/api/v2/multi-tickers/')
data = response.json()

const response = await fetch('https://grsbook.nownodes.io/api/v2/multi-tickers/', {
  method: 'GET',
});

const data = await response.json();

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

const data = await response.json();

import requests

response = requests.get('https://grsbook.nownodes.io/api/v2/multi-tickers/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/multi-tickers/')
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)

[
  {
    "ts": 1785902400,
    "rates": {
      "usd": 64107.65
    },
    "error": "Parameter \"timestamp\" is not a valid Unix timestamp."
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Parameter 'timestamp' does not contain a valid Unix timestamp."
}

Get currencies available for a timestamp.

GET

https://grsbook.nownodes.io/api/v2/tickers-list

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: Fiat rates are fetched more reliably: CoinGecko throttling (HTTP 429) is handled and missing daily rates are filled in automatically, so fewer timestamps come back without a rate. Documented as it exists in 0.6.0.

Returns available secondary currencies for a date together with the actual rate timestamp.

Load estimate: Low to medium; token lookups and wide currency lists increase response size.

Parameters

timestampinteger<int64>requiredquery

Unix timestamp for the requested currency list.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

Available currencies.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get currencies available for a timestamp.

curl -X GET 'https://grsbook.nownodes.io/api/v2/tickers-list/'

const response = await fetch('https://grsbook.nownodes.io/api/v2/tickers-list/', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/tickers-list/')
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://grsbook.nownodes.io/api/v2/tickers-list/')
data = response.json()

const response = await fetch('https://grsbook.nownodes.io/api/v2/tickers-list/', {
  method: 'GET',
});

const data = await response.json();

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

const data = await response.json();

import requests

response = requests.get('https://grsbook.nownodes.io/api/v2/tickers-list/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v2/tickers-list/')
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)

{
  "ts": 1785902400,
  "available_currencies": [
    "eur",
    "usd"
  ],
  "error": "Parameter \"timestamp\" is not a valid Unix timestamp."
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Parameter 'timestamp' is not a valid Unix timestamp."
}

BlockBook (legacy)

BlockBook (legacy) operations.

Legacy broadcast transaction using the request body.

POST

https://grsbook.nownodes.io/api/v1/sendtx

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: The request body is now limited to 8 MiB; larger bodies are rejected before broadcasting. Documented as it exists in 0.6.0.

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Alternative schema variant for this parameter or payload.

string

Response

200OK

Broadcast result.

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

default

Public API error.

Legacy broadcast transaction using the request body.

curl -X POST 'https://grsbook.nownodes.io/api/v1/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"'

const response = await fetch('https://grsbook.nownodes.io/api/v1/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"),
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v1/sendtx/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'text/plain'
request.body = '"0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"'

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

import requests

payload = "0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"

response = requests.post('https://grsbook.nownodes.io/api/v1/sendtx/', json=payload)
data = response.json()

const response = await fetch('https://grsbook.nownodes.io/api/v1/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"),
});

const data = await response.json();

const endpoint = "https://grsbook.nownodes.io/api/v1/sendtx/";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest("0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b");
console.log(result);

const response = await fetch('https://grsbook.nownodes.io/api/v1/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"),
});

const data = await response.json();

import requests

payload = "0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"

response = requests.post('https://grsbook.nownodes.io/api/v1/sendtx/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://grsbook.nownodes.io/api/v1/sendtx/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'text/plain'
request.body = '"0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b"'

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

Request Body

0200000001d6aa4e52f5217cad621292450157e0e583db367597ce2beb79f2168e1d7a020b

{
  "result": "e37ec95c424bd7c2ddbab8f5e75b93f70c1a14be4be2c93eb995ab117379e488"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "e37ec95c424bd7c2ddbab8f5e75b93f70c1a14be4be2c93eb995ab117379e488"
}

{
  "error": "Missing tx blob"
}