Preciousblock

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

Body

application/json

jsonrpcstringRequiredExample: 1.0

idstringRequiredExample: preciousblock

methodstring · enumRequiredPossible 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

resultstring · nullableOptional

Null result indicates success with no return value

errorobject · nullableOptional

Null if successful; otherwise error details

idstringOptional

The ID of the request

401

Unauthorized

application/json

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": "curltest"
}