BlockBook RES-API

v1.0.0

Base URL

https://neo.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

MAINNET / Blockchain_RPCs

getbestblockhash

POST

https://neo.nownodes.io/

Returns the hash of the best block in the most-work fully-validated chain. The best block is the tip of the blockchain, representing the most recent block that has been validated and added to the chain.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetbestblockhashrequired

paramsArray<any>required

Response

200OK

Valid response

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getbestblockhash

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getbestblockhash",
    "params": []
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getbestblockhash",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getbestblockhash",
  "params": []
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getbestblockhash",
  "params": []
}

{
  "result": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblock

POST

https://neo.nownodes.io/

Returns information about the block with the given block hash. Optional verbosity levels determine the level of detail in the response:

0: Returns a string that is serialized, hex-encoded data for the block.
1: Returns a JSON object with basic block details and txids.
2: Returns a JSON object with detailed transaction info.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockrequired

paramsArray<string | integer>required

Parameters:

blockhash (string) – The hash of the block
verbosity (integer, optional) – Level of detail: 0, 1, or 2

Show child attributes

One of

string

integer

Response

200OK

Block information retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblock

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblock",
    "params": [
      "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
      1
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblock",
      "params": [
        "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
        1
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblock",
  "params": [
    "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    1
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblock",
  "params": [
    "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    1
  ]
}

{
  "result": {
    "hash": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    "confirmations": 100,
    "height": 855000,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "a3e1f3...ff9a",
    "time": 1700000000,
    "mediantime": 1699995000,
    "nonce": 4282073135,
    "bits": "170d1f5d",
    "difficulty": 225983213292.9388,
    "chainwork": "0000000000000000000000000000000000000000230c36f8ff7f4fbee5b6a0c2",
    "previousblockhash": "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1",
    "nextblockhash": "0000000000000000000735c64b80cd102b8e4d67c2cc09db81fa4451a6f58e3a",
    "tx": [
      "string"
    ]
  },
  "error": {},
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblockchaininfo

POST

https://neo.nownodes.io/

Returns an object containing various state info regarding blockchain processing.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockchaininforequired

paramsArray<any>required

Response

200OK

Blockchain state information retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockchaininfo

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockchaininfo",
    "params": []
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockchaininfo",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockchaininfo",
  "params": []
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockchaininfo",
  "params": []
}

{
  "result": {
    "chain": "main",
    "blocks": 855000,
    "headers": 855002,
    "bestblockhash": "0000000000000000000b27d455de872dfe8a8aa4f2efbfc5f1877357f7c8e97b",
    "difficulty": 225983213292.9388,
    "mediantime": 1700000500,
    "verificationprogress": 0.999999,
    "initialblockdownload": false,
    "chainwork": "0000000000000000000000000000000000000000230c36f8ff7f4fbee5b6a0c2",
    "size_on_disk": 495000000000,
    "pruned": false,
    "pruneheight": null,
    "automatic_pruning": false,
    "prune_target_size": null,
    "warnings": ""
  },
  "error": {},
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblockcount

POST

https://neo.nownodes.io/

Returns the number of blocks in the longest blockchain. This number increases as new blocks are added.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockcountrequired

paramsarrayrequired

This method takes no parameters.

Response

200OK

Current block height retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockcount

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockcount",
    "params": []
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockcount",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockcount",
  "params": []
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockcount",
  "params": []
}

{
  "result": 855000,
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblockhash

POST

https://neo.nownodes.io/

Returns the block hash of the block at the given height in the blockchain. You must provide a block height (0-based index).

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockhashrequired

paramsArray<integer>required

Parameters:

height (integer) — The height (index) of the block.

Response

200OK

Block hash successfully retrieved

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockhash

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockhash",
    "params": [
      855000
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockhash",
      "params": [
        855000
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockhash",
  "params": [
    855000
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockhash",
  "params": [
    855000
  ]
}

{
  "result": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblockheader

POST

https://neo.nownodes.io/

Returns information about the block header given a block hash. You can specify whether to return a JSON object or raw hex-encoded string using the verbose flag.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockheaderrequired

paramsArray<string | boolean>required

Parameters:

blockhash (string) — The hash of the block.
verbose (boolean, optional) — If true, returns a JSON object; if false, returns a hex string. Default is true.

Show child attributes

One of

string

boolean

Response

200OK

Block header information retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockheader

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockheader",
    "params": [
      "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
      true
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockheader",
      "params": [
        "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockheader",
  "params": [
    "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    true
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockheader",
  "params": [
    "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    true
  ]
}

{
  "result": {
    "hash": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    "confirmations": 105,
    "height": 855000,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "e3abc1234...",
    "time": 1700000000,
    "mediantime": 1699995000,
    "nonce": 1234567890,
    "bits": "170d1f5d",
    "difficulty": 225983213292.9388,
    "chainwork": "0000000000000000000000000000000000000000230c36f8ff7f4fbee5b6a0c2",
    "previousblockhash": "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1",
    "nextblockhash": "0000000000000000000735c64b80cd102b8e4d67c2cc09db81fa4451a6f58e3a"
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblockstats

POST

https://neo.nownodes.io/

Returns a variety of statistics about the block identified by its height or block hash. Available in Bitcoin Core v0.17.0 and later.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockstatsrequired

paramsArray<integer | string | Array<string>>required

Parameters:

height_or_hash (integer or string) — The block height (integer) or block hash (string).
stats (array, optional) — Specific stats to return. If not specified, returns all.

Show child attributes

One of

integer

string

Array<string>

Response

200OK

Block statistics returned successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockstats

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockstats",
    "params": [
      855000
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockstats",
      "params": [
        855000
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockstats",
  "params": [
    855000
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockstats",
  "params": [
    855000
  ]
}

{
  "result": {
    "avgfee": 1289,
    "avgfeerate": 3,
    "avgtxsize": 500,
    "blockhash": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    "height": 855000,
    "ins": 6000,
    "maxfee": 35000,
    "maxfeerate": 50,
    "maxtxsize": 2500,
    "medianfee": 1000,
    "mediantime": 1700000000,
    "mediantxsize": 250,
    "minfee": 200,
    "minfeerate": 1,
    "mintxsize": 100,
    "outs": 6500,
    "subsidy": 625000000,
    "swtotal_size": 1000000,
    "swtotal_weight": 3200000,
    "swtxs": 1800,
    "time": 1700000500,
    "total_out": 100000000000,
    "total_size": 1250000,
    "total_weight": 3999000,
    "totalfee": 2300000,
    "txs": 2200,
    "utxo_increase": 500,
    "utxo_size_inc": 20000,
    "utxo_increase_actual": 498
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getchaintips

POST

https://neo.nownodes.io/

Returns information about all known tips in the block tree, including the main chain as well as orphaned forks.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetchaintipsrequired

paramsarrayrequired

This method takes no parameters.

Response

200OK

Chain tips retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getchaintips

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintips",
    "params": []
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getchaintips",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getchaintips",
  "params": []
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getchaintips",
  "params": []
}

{
  "result": [
    {
      "height": 855000,
      "hash": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
      "branchlen": 0,
      "status": "active"
    },
    {
      "height": 854980,
      "hash": "0000000000000000000f83a8e9a563e48e7b8e5400e38310ff299b7f30aaf8d9",
      "branchlen": 20,
      "status": "valid-fork"
    }
  ],
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getchaintxstats

POST

https://neo.nownodes.io/

Compute statistics about the total number and rate of transactions in the blockchain. You can optionally specify the number of blocks and a block hash to start from.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetchaintxstatsrequired

paramsArray<integer | string>required

Parameters:

nblocks (integer, optional) — Number of blocks to average over. Default: 1 month worth (~4320).
blockhash (string, optional) — Hash of the block to stop at; defaults to the chain tip.

Show child attributes

One of

integer

string

Response

200OK

Chain transaction statistics retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getchaintxstats

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintxstats",
    "params": [
      144,
      "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getchaintxstats",
      "params": [
        144,
        "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getchaintxstats",
  "params": [
    144,
    "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getchaintxstats",
  "params": [
    144,
    "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
  ]
}

{
  "result": {
    "time": 1700000000,
    "txcount": 889452301,
    "window_final_block_hash": "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1",
    "window_final_block_height": 855000,
    "window_block_count": 144,
    "window_tx_count": 17000,
    "window_interval": 11520,
    "txrate": 1.475
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getdifficulty

POST

https://neo.nownodes.io/

Returns the current difficulty as a multiple of the minimum difficulty (lowest possible difficulty on the network). This is a relative measure of how difficult it is to find a new block.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetdifficultyrequired

paramsarrayrequired

This method takes no parameters.

Response

200OK

Difficulty value returned successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getdifficulty

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getdifficulty",
    "params": []
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getdifficulty",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getdifficulty",
  "params": []
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getdifficulty",
  "params": []
}

{
  "result": 8342150203598.12,
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getmempoolancestors

POST

https://neo.nownodes.io/

Returns all in-mempool ancestor transactions for a given transaction ID. An ancestor is a transaction whose outputs are used as inputs in another transaction. You can get a summary or detailed object output.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetmempoolancestorsrequired

paramsArray<string | boolean>required

Parameters:

txid (string, required) — Transaction ID to query.
verbose (boolean, optional) — Whether to return a JSON object or just an array of txids. Default is false.

Show child attributes

One of

string

boolean

Response

200OK

Ancestor transaction(s) retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmempoolancestors

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolancestors",
    "params": [
      "txid_example",
      true
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmempoolancestors",
      "params": [
        "txid_example",
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempoolancestors",
  "params": [
    "txid_example",
    true
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempoolancestors",
  "params": [
    "txid_example",
    true
  ]
}

{
  "result": {
    "txid1": {
      "size": 250,
      "fee": 1000,
      "modifiedfee": 1000,
      "time": 1700000000,
      "height": 854998,
      "descendantcount": 1,
      "descendantsize": 600,
      "descendantfees": 3000,
      "ancestorcount": 1,
      "ancestorsize": 250,
      "ancestorfees": 1000,
      "depends": []
    },
    "txid2": "..."
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getmempooldescendants

POST

https://neo.nownodes.io/

Returns all in-mempool descendant transactions for a given transaction ID. Descendants are transactions that depend on the outputs of the specified transaction. Can return either a simple list of transaction IDs or detailed JSON objects.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetmempooldescendantsrequired

paramsArray<string | boolean>required

Parameters:

txid (string, required) — Transaction ID to query descendants for.
verbose (boolean, optional) — Return JSON object if true, or list of txids if false. Default: false.

Show child attributes

One of

string

boolean

Response

200OK

Descendant transactions retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmempooldescendants

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempooldescendants",
    "params": [
      "txid_example",
      true
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmempooldescendants",
      "params": [
        "txid_example",
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempooldescendants",
  "params": [
    "txid_example",
    true
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempooldescendants",
  "params": [
    "txid_example",
    true
  ]
}

{
  "result": {
    "txid1": {
      "size": 300,
      "fee": 2000,
      "modifiedfee": 2100,
      "time": 1700000100,
      "height": 855000,
      "descendantcount": 0,
      "descendantsize": 0,
      "descendantfees": 0,
      "ancestorcount": 2,
      "ancestorsize": 600,
      "ancestorfees": 4000,
      "depends": [
        "txid_example"
      ]
    },
    "txid2": "..."
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getmempoolentry

POST

https://neo.nownodes.io/

Returns detailed information about a transaction currently in the mempool. Requires the transaction ID (txid) as a parameter.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetmempoolentryrequired

paramsArray<string>required

Parameters:

txid (string, required) — Transaction ID to query.

Response

200OK

Mempool entry details retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmempoolentry

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolentry",
    "params": [
      "txid_example"
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmempoolentry",
      "params": [
        "txid_example"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempoolentry",
  "params": [
    "txid_example"
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempoolentry",
  "params": [
    "txid_example"
  ]
}

{
  "result": {
    "size": 226,
    "fee": 1210,
    "modifiedfee": 1210,
    "time": 1699990000,
    "height": 854000,
    "descendantcount": 2,
    "descendantsize": 452,
    "descendantfees": 3000,
    "ancestorcount": 1,
    "ancestorsize": 226,
    "ancestorfees": 1210,
    "depends": []
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getmempoolinfo

POST

https://neo.nownodes.io/

Returns details about the current state of the mempool, including size, usage, fees, and more. No parameters required.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetmempoolinforequired

paramsArray<any>required

No parameters required

Response

200OK

Mempool info retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmempoolinfo

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolinfo",
    "params": []
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmempoolinfo",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempoolinfo",
  "params": []
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempoolinfo",
  "params": []
}

{
  "result": {
    "size": 1240,
    "bytes": 987654,
    "usage": 1234567,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001,
    "minrelaytxfee": 0.00001,
    "maxfeerate": 0.1
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getrawmempool

POST

https://neo.nownodes.io/

Returns all transaction IDs currently in the mempool. If verbose is true, returns a JSON object with detailed mempool entry information for each transaction.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetrawmempoolrequired

paramsArray<boolean>required

Parameters:

verbose (boolean, optional) — If true, return detailed JSON objects instead of txid array. Default: false.

Response

200OK

Mempool transactions retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getrawmempool

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getrawmempool",
    "params": [
      true
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getrawmempool",
      "params": [
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getrawmempool",
  "params": [
    true
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getrawmempool",
  "params": [
    true
  ]
}

{
  "result": {
    "txid1": {
      "size": 226,
      "fee": 1210,
      "time": 1699990000,
      "height": 854000,
      "startingpriority": 1000,
      "currentpriority": 950,
      "descendantcount": 2,
      "descendantsize": 452,
      "descendantfees": 3000,
      "ancestorcount": 1,
      "ancestorsize": 226,
      "ancestorfees": 1210,
      "depends": []
    }
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

gettxout

POST

https://neo.nownodes.io/

Returns details about an unspent transaction output (UTXO) specified by transaction ID and output index.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgettxoutrequired

paramsArray<string | integer | boolean>required

Parameters:

txid (string, required) — The transaction ID.
vout (integer, required) — The output index.
include_mempool (boolean, optional, default: true) — Whether to include mempool transactions.

Show child attributes

One of

string

integer

boolean

Response

200OK

UTXO details retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

gettxout

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "gettxout",
    "params": [
      "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
      1,
      true
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "gettxout",
      "params": [
        "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
        1,
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "gettxout",
  "params": [
    "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
    1,
    true
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "gettxout",
  "params": [
    "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
    1,
    true
  ]
}

{
  "result": {
    "bestblock": "000000000000000000010927cae2186713052813554025f0b3c2d2a09f28ff91",
    "confirmations": 1,
    "value": 3.16459147,
    "scriptPubKey": {
      "asm": "OP_DUP OP_HASH160 6582f2551e2a47e1ae8b03fb666401ed7c4552ef OP_EQUALVERIFY OP_CHECKSIG",
      "hex": "a9146582f2551e2a47e1ae8b03fb666401ed7c4552ef87",
      "reqSigs": 1,
      "type": "scripthash",
      "addresses": [
        "3Awm3FNpmwrbvAFVThRUFqgpbVuqWisni9"
      ]
    },
    "coinbase": true
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

gettxoutproof

POST

https://neo.nownodes.io/

Returns a hex-encoded proof that one or more transactions are included in a block. The proof can be validated with verifytxoutproof.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgettxoutproofrequired

paramsArray<Array<string> | string>required

Parameters:

txids (array[string], required) — Array of transaction IDs to prove inclusion.
blockhash (string, optional) — Hash of the block to look for transactions. If omitted, searches the entire blockchain.

Show child attributes

One of

Array<string>

string

Response

200OK

Proof retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

gettxoutproof

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "gettxoutproof",
    "params": [
      [
        "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07",
        "cee11bc3bb3d9db8c4813ed2072a14369a15fcfb9e6bc5cb37a0b5bcc6aa59aa"
      ],
      null
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "gettxoutproof",
      "params": [
        [
          "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07",
          "cee11bc3bb3d9db8c4813ed2072a14369a15fcfb9e6bc5cb37a0b5bcc6aa59aa"
        ],
        null
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "gettxoutproof",
  "params": [
    [
      "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07",
      "cee11bc3bb3d9db8c4813ed2072a14369a15fcfb9e6bc5cb37a0b5bcc6aa59aa"
    ],
    null
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "gettxoutproof",
  "params": [
    [
      "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07",
      "cee11bc3bb3d9db8c4813ed2072a14369a15fcfb9e6bc5cb37a0b5bcc6aa59aa"
    ],
    null
  ]
}

{
  "result": "000000202834abd71bdd0d3298542af4506918ea168ce002936b040000000000000000001da8757e4d756e848245cacf3e103c1b9f6ed2405c6d818a73172c8ec72856d4db3864606fdf0c17dcc1000ccb0300000cb86343fc64abcdab51e530303a4ee2b420fa6b5a12b435c9c76fe953ca5471ca074a0bfaf4462cef0a5665b89fd7fd5e4f8536630cde6824d09b20400b2f65eed9f744b2dc695b0ea0c4afd06310a21b93ddd7270a781acd0ada1afdd23b5750aa59aac6bcb5a037cbc56b9efbfc159a36142a07d23e81c4b89d3dbbc31be1cefe0bb7b0369ffc3b1d530e234987543a2613bbb8b06c86f993a930dee7b9d87f661ef556adc0174c7f180aa28006ee93ce2291302801ecd045c234c00b186ea35ff1e77eac3f113492e2eb12f38b9df452f5831f55c861865ac8f3c7dd06be2377f859ba1d12dea2ec44987796a27d42d5727250c1e0181d6a251f8272f21b9a2034069a2471de43de655619904d43b4665f6ce38741320998dc97838c32c79f1ada066ddf7a441357d55cc42a8906970bff2d5342be694002476733ff593af26f320c10df7ba9a76355438f462c040b598868dfb67c5e88d6d9a426ec8cdd74337d42df6b29e9fb319410848f3ff7228d00dc539e2962d185348ab9663a112a03ff6e00",
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

preciousblock

POST

https://neo.nownodes.io/

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.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringpreciousblockrequired

paramsArray<string>required

Parameters:

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

Response

200OK

Block marked as precious successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

preciousblock

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "preciousblock",
    "params": [
      "0000000000000000000a7b89e4d3f3bcebd7025fa72d2d9c7b3e8f7a3bc5c8a5"
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "preciousblock",
      "params": [
        "0000000000000000000a7b89e4d3f3bcebd7025fa72d2d9c7b3e8f7a3bc5c8a5"
      ]
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

"Unknown API_key"

"Service is unavailable"

MAINNET / Mining_RPCs

getmininginfo

POST

https://neo.nownodes.io/

Returns mining-related information such as current block, difficulty, network hash rate, etc. No parameters are required.

Body

application/json

jsonrpcstringrequired

JSON-RPC version (always "1.0")

idstringrequired

Request identifier

methodstringgetmininginforequired

The RPC method name

paramsarrayrequired

No parameters required

Response

200OK

Mining info retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmininginfo

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmininginfo",
    "params": []
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmininginfo",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmininginfo",
  "params": []
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmininginfo",
  "params": []
}

{
  "result": {
    "blocks": 854000,
    "currentblockweight": 3990000,
    "currentblocktx": 2450,
    "difficulty": 568382716485.9244,
    "networkhashps": 130000000000000,
    "pooledtx": 5421,
    "chain": "main",
    "warnings": ""
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getnetworkhashps

POST

https://neo.nownodes.io/

Returns the estimated network hashes per second (hash rate) based on the last nblocks blocks. This provides an estimate of the total computational power securing the network.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version (always "1.0")

idstringrequired

The identifier for the request

methodstringgetnetworkhashpsrequired

The name of the RPC method

paramsArray<integer>required

Optional parameters:

nblocks (integer) — The number of blocks to average over. Default is 120.
height (integer) — Use the block at this height instead of the current tip. Use -1 for the tip.

Show child attributes

One of

integer

Response

200OK

Hash rate retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getnetworkhashps

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getnetworkhashps",
    "params": [
      120,
      -1
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getnetworkhashps",
      "params": [
        120,
        -1
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getnetworkhashps",
  "params": [
    120,
    -1
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getnetworkhashps",
  "params": [
    120,
    -1
  ]
}

{
  "result": 134567890123456.78,
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

MAINNET / Rawtransactions_RPCs

createrawtransaction

POST

https://neo.nownodes.io/

Creates an unsigned raw transaction from a list of inputs and outputs. The transaction is returned as a serialized hex string, which can then be signed and broadcast.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringcreaterawtransactionrequired

paramsArray<Array<object> | object | integer | boolean>required

Parameters:

inputs (array) — List of transaction inputs, each including txid and vout.
outputs (object) — Destination addresses and amounts.
locktime (integer, optional) — Locktime value.
replaceable (boolean, optional) — Whether this transaction signals BIP125 replaceability.

Show child attributes

One of

Array<object>

Show child attributes

txidstring

Transaction ID to spend

voutinteger

Output index

object

integer

boolean

Response

200OK

Unsigned raw transaction created successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

createrawtransaction

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "createrawtransaction",
    "params": [
      [
        {
          "txid": "my_txid_here",
          "vout": 0
        }
      ],
      {
        "bc1qrecipientaddress...": 0.001
      }
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "createrawtransaction",
      "params": [
        [
          {
            "txid": "my_txid_here",
            "vout": 0
          }
        ],
        {
          "bc1qrecipientaddress...": 0.001
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "createrawtransaction",
  "params": [
    [
      {
        "txid": "my_txid_here",
        "vout": 0
      }
    ],
    {
      "bc1qrecipientaddress...": 0.001
    }
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "createrawtransaction",
  "params": [
    [
      {
        "txid": "my_txid_here",
        "vout": 0
      }
    ],
    {
      "bc1qrecipientaddress...": 0.001
    }
  ]
}

{
  "result": "0200000001abcd...00000000",
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

decoderawtransaction

POST

https://neo.nownodes.io/

Decodes a raw hex-encoded Bitcoin transaction and returns a JSON object with readable fields. Useful for viewing the contents of raw transactions before broadcasting.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringdecoderawtransactionrequired

paramsArray<string>required

Parameters:

hexstring (string, required) — The raw transaction hex string.

Response

200OK

Transaction decoded successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

decoderawtransaction

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "decoderawtransaction",
    "params": [
      "0200000001abcd...00000000"
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "decoderawtransaction",
      "params": [
        "0200000001abcd...00000000"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "decoderawtransaction",
  "params": [
    "0200000001abcd...00000000"
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "decoderawtransaction",
  "params": [
    "0200000001abcd...00000000"
  ]
}

{
  "result": {
    "txid": "abcd1234...",
    "hash": "abcd1234...",
    "version": 2,
    "size": 225,
    "vsize": 144,
    "locktime": 0,
    "vin": [
      {
        "txid": "input_txid",
        "vout": 0,
        "scriptSig": {
          "asm": "asm_code",
          "hex": "hex_code"
        },
        "sequence": 4294967295
      }
    ],
    "vout": [
      {
        "value": 0.001,
        "n": 0,
        "scriptPubKey": {
          "asm": "asm_output",
          "hex": "hex_output",
          "type": "witness_v0_keyhash",
          "addresses": [
            "bc1q..."
          ]
        }
      }
    ]
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

decodescript

POST

https://neo.nownodes.io/

Decodes a hex-encoded script (usually scriptPubKey) and returns a JSON representation including the script type and addresses. Useful for analyzing output scripts or creating Pay-to-Script-Hash addresses.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringdecodescriptrequired

RPC method name

paramsArray<string>required

Parameters:

hexstring (string, required) — The script in hex format to decode.

Response

200OK

Script decoded successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

decodescript

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "decodescript",
    "params": [
      "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "decodescript",
      "params": [
        "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "decodescript",
  "params": [
    "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "decodescript",
  "params": [
    "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
  ]
}

{
  "result": {
    "asm": "OP_0 1d0f172a0ecb48aee1be1f2687d2963ae33f71a1",
    "type": "witness_v0_keyhash",
    "reqSigs": 1,
    "addresses": [
      "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
    ],
    "p2sh": "3QJmV3qfvL9SuYo34YihAf3sRCW3qSinyC"
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getrawtransaction

POST

https://neo.nownodes.io/

Retrieves a raw transaction by its txid. If verbose is false or omitted, the result is a raw hex string. If verbose is true, returns a JSON object with decoded transaction details.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetrawtransactionrequired

paramsArray<string | boolean>required

Parameters:

txid (string, required) — The transaction ID.
verbose (boolean, optional) — If true, return JSON; if false, return hex. Default: false.

Show child attributes

One of

string

boolean

Response

200OK

Transaction retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getrawtransaction

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getrawtransaction",
    "params": [
      "txid_here",
      true
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getrawtransaction",
      "params": [
        "txid_here",
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getrawtransaction",
  "params": [
    "txid_here",
    true
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getrawtransaction",
  "params": [
    "txid_here",
    true
  ]
}

{
  "result": "0200000001abcd...00000000",
  "error": null,
  "id": "curltest"
}

{
  "result": {
    "txid": "abcd1234...",
    "hash": "abcd1234...",
    "version": 2,
    "size": 225,
    "vsize": 144,
    "locktime": 0,
    "vin": [
      "..."
    ],
    "vout": [
      "..."
    ],
    "hex": "0200000001abcd...00000000"
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

sendrawtransaction

POST

https://neo.nownodes.io/

Submits a raw transaction (hex-encoded string) to the mempool and broadcasts it to the network. Returns the transaction ID (txid) if accepted.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringsendrawtransactionrequired

paramsArray<string | number | boolean>required

Parameters:

hexstring (string, required): The raw transaction in hex format.
maxfeerate (number or boolean, optional): Reject transactions with fees higher than this (BTC/KB). Use false to disable check.

Show child attributes

One of

string

number

boolean

Response

200OK

Transaction accepted and broadcasted

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

sendrawtransaction

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "sendrawtransaction",
    "params": [
      "0200000001abcd...00000000",
      false
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "sendrawtransaction",
      "params": [
        "0200000001abcd...00000000",
        false
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "sendrawtransaction",
  "params": [
    "0200000001abcd...00000000",
    false
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "sendrawtransaction",
  "params": [
    "0200000001abcd...00000000",
    false
  ]
}

{
  "result": "abcd1234txid",
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

signrawtransactionwithkey

POST

https://neo.nownodes.io/

Signs inputs for a raw transaction using explicitly provided private keys, without needing access to a local wallet. Useful for offline signing or stateless transaction construction.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringsignrawtransactionwithkeyrequired

paramsArray<string | Array<string> | Array<object>>required

Parameters:

hexstring (string, required): The raw transaction hex string.
privkeys (array of strings, required): Array of WIF private keys.
prevtxs (array, optional): Array of previous output details for inputs to sign.

Show child attributes

One of

string

Array<string>

Array<object>

Show child attributes

txidstring

Transaction ID of the UTXO being spent.

voutinteger

Output index.

scriptPubKeystring

Script of the UTXO.

redeemScriptstring

(optional) Redeem script for P2SH inputs.

witnessScriptstring

(optional) Witness script for P2WSH inputs.

amountnumber

Amount in BTC of the UTXO.

Response

200OK

Transaction signed successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

signrawtransactionwithkey

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "signrawtransactionwithkey",
    "params": [
      "0200000001abcd...00000000",
      [
        "cV...yourWIFkey..."
      ],
      [
        {
          "txid": "abcd1234...",
          "vout": 0,
          "scriptPubKey": "76a914...88ac",
          "redeemScript": "0020...",
          "amount": 0.001
        }
      ]
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "signrawtransactionwithkey",
      "params": [
        "0200000001abcd...00000000",
        [
          "cV...yourWIFkey..."
        ],
        [
          {
            "txid": "abcd1234...",
            "vout": 0,
            "scriptPubKey": "76a914...88ac",
            "redeemScript": "0020...",
            "amount": 0.001
          }
        ]
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "signrawtransactionwithkey",
  "params": [
    "0200000001abcd...00000000",
    [
      "cV...yourWIFkey..."
    ],
    [
      {
        "txid": "abcd1234...",
        "vout": 0,
        "scriptPubKey": "76a914...88ac",
        "redeemScript": "0020...",
        "amount": 0.001
      }
    ]
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "signrawtransactionwithkey",
  "params": [
    "0200000001abcd...00000000",
    [
      "cV...yourWIFkey..."
    ],
    [
      {
        "txid": "abcd1234...",
        "vout": 0,
        "scriptPubKey": "76a914...88ac",
        "redeemScript": "0020...",
        "amount": 0.001
      }
    ]
  ]
}

{
  "result": {
    "hex": "0200000001abcd...00000000",
    "complete": true,
    "errors": []
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

MAINNET / Util_RPCs

signmessagewithprivkey

POST

https://neo.nownodes.io/

Signs a message with the given private key (in WIF format). Returns the base64-encoded signature.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringsignmessagewithprivkeyrequired

paramsArray<string>required

Parameters:

privkey (string, required): The private key in WIF format.
message (string, required): The message to sign.

Response

200OK

Message signed successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

signmessagewithprivkey

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "signmessagewithprivkey",
    "params": [
      "cV...yourWIFkey...",
      "This is my message."
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "signmessagewithprivkey",
      "params": [
        "cV...yourWIFkey...",
        "This is my message."
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "signmessagewithprivkey",
  "params": [
    "cV...yourWIFkey...",
    "This is my message."
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "signmessagewithprivkey",
  "params": [
    "cV...yourWIFkey...",
    "This is my message."
  ]
}

{
  "result": "H+JdK+U...signature==",
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

validateaddress

POST

https://neo.nownodes.io/

Validate a Bitcoin address and return useful information such as whether it is valid, script, or witness, and optionally if it's linked to the wallet.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringvalidateaddressrequired

paramsArray<string>required

Parameters:

address (string, required): The Bitcoin address to validate.

Response

200OK

Address validation result

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

validateaddress

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "validateaddress",
    "params": [
      "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "validateaddress",
      "params": [
        "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "validateaddress",
  "params": [
    "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "validateaddress",
  "params": [
    "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
  ]
}

{
  "result": {
    "isvalid": true,
    "address": "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080",
    "scriptPubKey": "0014751e76e8199196d454941c45d1b3a323f1433bd6",
    "isscript": false,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "751e76e8199196d454941c45d1b3a323f1433bd6"
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

verifymessage

POST

https://neo.nownodes.io/

Verify a message signature. Returns true if the signature is valid and corresponds to the provided address and message.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringverifymessagerequired

paramsArray<string>required

Parameters:

address (string, required): The Bitcoin address to verify.
signature (string, required): The base64-encoded signature.
message (string, required): The original signed message.

Response

200OK

Signature verification result

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

verifymessage

curl -X POST 'https://neo.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "verifymessage",
    "params": [
      "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
      "H9zbxP...==",
      "This is a test message."
    ]
  }'

const response = await fetch('https://neo.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "verifymessage",
      "params": [
        "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
        "H9zbxP...==",
        "This is a test message."
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "verifymessage",
  "params": [
    "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "H9zbxP...==",
    "This is a test message."
  ]
}

response = requests.post('https://neo.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "verifymessage",
  "params": [
    "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "H9zbxP...==",
    "This is a test message."
  ]
}

{
  "result": true,
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

Documentation

Authentication

MAINNET / Blockchain_RPCs

getbestblockhash

Body

Response

Authorization

getblock

Body

Response

Authorization

getblockchaininfo

Body

Response

Authorization

getblockcount

Body

Response

Authorization

getblockhash

Body

Response

Authorization

getblockheader

Body

Response

Authorization

getblockstats

Body

Response

Authorization

getchaintips

Body

Response

Authorization

getchaintxstats

Body

Response

Authorization

getdifficulty

Body

Response

Authorization

getmempoolancestors

Body

Response

Authorization

getmempooldescendants

Body

Response

Authorization

getmempoolentry

Body

Response

Authorization

getmempoolinfo

Body

Response

Authorization

getrawmempool

Body

Response

Authorization

gettxout

Body

Response

Authorization

gettxoutproof

Body

Response

Authorization

preciousblock

Body

Response

Authorization

MAINNET / Mining_RPCs

getmininginfo

Body

Response

Authorization