Preciousblock

preciousblock operations.

preciousblock

post

Marks a block as "precious," causing the node to reconsider the chain from that block. This can be used to manually reorganize the chain to a particular fork.

Authorizations

api-keyAuth

api-keystringRequired

NOWNodes API key passed in the api-key header.

Body

application/json

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringRequired

JSON-RPC protocol version.

Example: 1.0

idstringRequired

Client-provided request identifier echoed in the response.

Example: curltest

methodstring · enumRequired

JSON-RPC method name.

Example: preciousblockPossible values:

paramsstring[]Required

Parameters:

1. blockhash (string, required) — The hash of the block to mark as precious.

Example: ["0000000000000000000a7b89e4d3f3bcebd7025fa72d2d9c7b3e8f7a3bc5c8a5"]

Responses

200

Block marked as precious successfully

application/json

Object containing preciousblock response details.

resultstring · nullableRequired

Null on success; the requested block was marked as precious and no response object is returned.

errorone of · nullableRequired

JSON-RPC error object or null on success.

or

stringOptional

JSON-RPC error object. Null when the request succeeds.

Example: {"code":-28,"message":"Service temporarily unavailable"}

idone of · nullableRequired

Request id echoed by the server.

stringOptional

Client-provided request identifier echoed in the response.

Example: curltest

or

integerOptional

Client-provided request identifier echoed in the response.

Example: curltest

Other propertiesanyOptional

401

Unauthorized: API key is present but rejected by the NOWNodes gateway.

text/plain

405

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

text/plain

422

Missing API key. The NOWNodes gateway returns plain text for this error.

text/plain

500

Internal Server Error

application/json

post/

HTTPcURLJavaScriptPython

POST / HTTP/1.1
Host: btc.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "preciousblock",
  "params": [
    "0000000000000000000a7b89e4d3f3bcebd7025fa72d2d9c7b3e8f7a3bc5c8a5"
  ]
}

{
  "result": null,
  "error": null,
  "id": 1
}