Blockbook API Changes 0.5.0 > 0.6.0 - PIVX (PIVX) Blockbook - modified methods
vv0.6.0-changeloghttps://pivxbook.nownodes.ioMethods of the NOWNodes PIVX (PIVX) Blockbook API (https://pivxbook.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-keyAuthapiKeyNOWNodes 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.
Authorizations
ApiKeyAuthApiKeyAuthapi-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. Shielded (Sapling) transactions with version 3 and above now carry the canonical txid computed from the full raw transaction, matching the txid reported by the PIVX node. In 0.5.0 Blockbook computed a different txid for them. 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
blockIdstringrequiredpathBlock height or block hash.
pageinteger>= 1query1-based page index. Values outside safe bounds are sanitized to the closest possible page.
Response
Block details.
Bad Request
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Service Unavailable
Public API error.
Get a normalized transaction.
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Modified between 0.5.0 and 0.6.0: Shielded (Sapling) transactions with version 3 and above now carry the canonical txid computed from the full raw transaction, matching the txid reported by the PIVX node. In 0.5.0 Blockbook computed a different txid for them. Shielded transactions can now be requested by that txid. Documented as it exists in 0.6.0.
Returns normalized transaction data with the same general structure for all supported coins. Coin-specific fields that do not fit the common shape are omitted here; use getTransactionSpecific for backend-native JSON.
Bitcoin-like confirmed transactions include blockHash, confirmations, blockTime, size/vsize, value/valueIn, fees, and hex. Unconfirmed transactions can include confirmationETABlocks and confirmationETASeconds.
Ethereum-like transactions have one vin and one vout, tokenTransfers, ethereumSpecific execution data, and optional addressAliases. Parsed input data is included when the 4byte signature can be resolved.
For mined transactions, blockTime is the block timestamp. For mempool transactions, blockTime is when this Blockbook instance first learned about the transaction and can differ between instances.
Load estimate: Medium; grows with inputs, outputs, token transfers, address aliases, and spending=true extra lookups.
Parameters
txidstringrequiredpathTransaction id/hash.
spendingbooleanqueryInclude spending transaction metadata for UTXO outputs when available.
Response
Normalized transaction.
Bad Request
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Service Unavailable
Public API error.
Broadcast a raw transaction using the request body.
Authorizations
ApiKeyAuthApiKeyAuthapi-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
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.
Response
Broadcast result.
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Public API error.
Get address/account details.
Authorizations
ApiKeyAuthApiKeyAuthapi-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. Shielded (Sapling) transactions with version 3 and above now carry the canonical txid computed from the full raw transaction, matching the txid reported by the PIVX node. In 0.5.0 Blockbook computed a different txid for them. 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
addressstringrequiredpathPIVX address, XPUB, or descriptor value accepted by Blockbook.
pageinteger<int32>>= 11queryPage number of the returned transaction list. Pagination starts from 1.
pageSizeinteger<int32>[1, 1000]1000queryMaximum number of transactions returned on one page.
frominteger<int64>>= 0queryStart block height filter for transactions, inclusive.
tointeger<int64>>= 0queryEnd block height filter for transactions, inclusive.
detailsstringbasictokenstokenBalancestxidstxslighttxstxidsqueryControls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.
tokensstringusednonzeroderivedqueryToken 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.
secondarystringquerySecondary currency code. When set, balance and transaction fields are additionally returned in this currency.
contractstringquerySmart-contract address used to filter token-related address data.
filterstring | integerqueryFilter account history by input/output side, or by numeric token/internal filter id.
protocolsArray<string>queryOptional protocol enrichments. Available on Ethereum-type networks only; on PIVX any value returns an error, so the parameter should be omitted.
Response
Address/account details.
Bad Request
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Service Unavailable
Public API error.
Get XPUB or descriptor account details.
Authorizations
ApiKeyAuthApiKeyAuthapi-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. Shielded (Sapling) transactions with version 3 and above now carry the canonical txid computed from the full raw transaction, matching the txid reported by the PIVX node. In 0.5.0 Blockbook computed a different txid for them. Documented as it exists in 0.6.0.
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
xpubstringrequiredpathExtended public key or output descriptor to query in Blockbook.
pageinteger<int32>>= 11queryPage number of the returned transaction list. Pagination starts from 1.
pageSizeinteger<int32>[1, 1000]1000queryMaximum number of transactions returned on one page.
frominteger<int64>>= 0queryStart block height filter for transactions, inclusive.
tointeger<int64>>= 0queryEnd block height filter for transactions, inclusive.
detailsstringbasictokenstokenBalancestxidstxslighttxstxidsqueryControls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.
tokensstringnonzerousedderivednonzeroqueryControls which XPUB-derived address rows are included.
filterstring | integerqueryFilter by input/output side or numeric id.
contractstringqueryContract address filter.
protocolsArray<string>queryProtocol enrichments.
secondarystringquerySecondary currency code.
gapinteger[0, 10000]queryXPUB/address derivation gap limit.
Response
XPUB/descriptor account details.
Bad Request
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Service Unavailable
Public API error.
Get UTXOs for an address, XPUB, or descriptor.
Authorizations
ApiKeyAuthApiKeyAuthapi-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. Shielded (Sapling) transactions with version 3 and above now carry the canonical txid computed from the full raw transaction, matching the txid reported by the PIVX node. In 0.5.0 Blockbook computed a different txid for them. 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
descriptorstringrequiredpathAddress, XPUB, or supported descriptor. URL-encode descriptors.
confirmedbooleanqueryWhen true, return only confirmed UTXOs.
gapinteger[0, 10000]queryXPUB/address derivation gap limit.
Response
UTXO list.
Bad Request
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Service Unavailable
Public API error.
Get account balance history.
Authorizations
ApiKeyAuthApiKeyAuthapi-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. 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
descriptorstringrequiredpathAddress, XPUB, or supported descriptor. URL-encode descriptors.
frominteger<int64>queryUnix timestamp lower bound.
tointeger<int64>queryUnix timestamp upper bound.
fiatcurrencystringqueryOptional fiat currency code to include in rates.
groupByinteger>= 1queryAggregation interval in seconds. Defaults to 3600.
gapinteger[0, 10000]queryXPUB/address derivation gap limit.
Response
Balance history points.
Bad Request
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Service Unavailable
Public API error.
BlockBook (legacy)
BlockBook (legacy) operations.
Legacy get transaction.
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Modified between 0.5.0 and 0.6.0: Shielded (Sapling) transactions with version 3 and above now carry the canonical txid computed from the full raw transaction, matching the txid reported by the PIVX node. In 0.5.0 Blockbook computed a different txid for them. Shielded transactions can now be requested by that txid. Documented as it exists in 0.6.0.
Bitcore Insight-compatible V1 transaction shape for Bitcoin-type coins.
Load estimate: Medium; grows with inputs, outputs, scripts, and raw transaction size.
Parameters
txidstringrequiredpathTransaction id/hash.
Response
Legacy transaction payload.
Bad Request
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Service Unavailable
Public API error.
Legacy broadcast transaction using the request body.
Authorizations
ApiKeyAuthApiKeyAuthapi-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
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.
Response
Broadcast result.
Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.
Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.
Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.
Internal Server Error
Public API error.