BlockBook RES-API

v1.0.0

Base URL

https://ont.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

MAINNET / Blockchain_RPCs

getbalancev2

POST

https://ont.nownodes.io/

Method to obtain ONT and ONG balances for a specific address.

Body

application/json

jsonrpcstring2.0required

JSON-RPC protocol version. Must be exactly "2.0".

methodstringgetbalancev2required

Name of the RPC method to invoke. For this API, the method getbalancev2 is documented.

paramsArray<string>

Parameters for the method. For getbalancev2, this is an array containing a single string – the wallet address.

idintegerrequired

Request identifier. The response will echo this value, allowing the client to correlate requests and responses.

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

POST /

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getbalancev2",
    "params": [
      "AbNHrhXT3gsDpNrkmAtsagLSuyzX19UQsn"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getbalancev2",
  "params": [
    "AbNHrhXT3gsDpNrkmAtsagLSuyzX19UQsn"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getbalancev2",
  "params": [
    "AbNHrhXT3gsDpNrkmAtsagLSuyzX19UQsn"
  ],
  "id": 1
}

200

{
  "desc": "SUCCESS",
  "error": 0,
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "ont": "2618440920",
    "ong": "999722349530000000000",
    "height": "19808542"
  }
}

getbestblockhash

POST

https://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getbestblockhash",
    "params": []
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblock",
    "params": [
      "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
      1
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockchaininfo",
    "params": []
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockcount",
    "params": []
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockhash",
    "params": [
      855000
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockheader",
    "params": [
      "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
      true
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.nownodes.io/

Returns a variety of statistics about the block identified by its height or block hash.

Body

application/json

jsonrpcstring1.02.0required

JSON-RPC protocol version.

methodstringgetblockstatsrequired

Name of the RPC method.

paramsArray<integer>

Parameters for the method. For getblockstats, this is an array containing a single value – either the block height (integer) or block hash (string).

idstringrequired

Request identifier. The response will echo this value. Can be any string or number.

Response

200OK

Successful block statistics retrieval.

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockstats

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "avgfee": 2506,
    "avgfeerate": 5,
    "avgtxsize": 758,
    "blockhash": "0000000000000000000233ea80aa10d38aa4486cd7033fffc2c4df556d0b9138",
    "feerate_percentiles": [
      3,
      3,
      4,
      5,
      7
    ],
    "height": 855000,
    "ins": 9241,
    "maxfee": 315273,
    "maxfeerate": 974,
    "maxtxsize": 208603,
    "medianfee": 717,
    "mediantime": 1722542196,
    "mediantxsize": 223,
    "minfee": 143,
    "minfeerate": 1,
    "mintxsize": 150,
    "outs": 7778,
    "subsidy": 312500000,
    "swtotal_size": 1662368,
    "swtotal_weight": 3546428,
    "swtxs": 2189,
    "time": 1722544444,
    "total_out": 784184758176,
    "total_size": 1773719,
    "total_weight": 3991832,
    "totalfee": 5858578,
    "txs": 2338,
    "utxo_increase": -1463,
    "utxo_size_inc": -107691,
    "utxo_increase_actual": -2000,
    "utxo_size_inc_actual": -139944
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getchaintips

POST

https://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintips",
    "params": []
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintxstats",
    "params": [
      144,
      "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getdifficulty",
    "params": []
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolancestors",
    "params": [
      "txid_example",
      true
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempooldescendants",
    "params": [
      "txid_example",
      true
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolentry",
    "params": [
      "txid_example"
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolinfo",
    "params": []
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getrawmempool",
    "params": [
      true
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "gettxout",
    "params": [
      "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
      1,
      true
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "gettxoutproof",
    "params": [
      [
        "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07",
        "cee11bc3bb3d9db8c4813ed2072a14369a15fcfb9e6bc5cb37a0b5bcc6aa59aa"
      ],
      null
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "preciousblock",
    "params": [
      "0000000000000000000a7b89e4d3f3bcebd7025fa72d2d9c7b3e8f7a3bc5c8a5"
    ]
  }'

const response = await fetch('https://ont.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://ont.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 / RPC

getbalancev2

POST

https://ont.nownodes.io/

Method to obtain ONT and ONG balances for a specific address.

Body

application/json

jsonrpcstring2.0required

JSON-RPC protocol version. Must be exactly "2.0".

methodstringgetbalancev2required

Name of the RPC method to invoke. For this API, the method getbalancev2 is documented.

paramsArray<string>

Parameters for the method. For getbalancev2, this is an array containing a single string – the wallet address.

idintegerrequired

Request identifier. The response will echo this value, allowing the client to correlate requests and responses.

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

POST /

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getbalancev2",
    "params": [
      "AbNHrhXT3gsDpNrkmAtsagLSuyzX19UQsn"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getbalancev2",
  "params": [
    "AbNHrhXT3gsDpNrkmAtsagLSuyzX19UQsn"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getbalancev2",
  "params": [
    "AbNHrhXT3gsDpNrkmAtsagLSuyzX19UQsn"
  ],
  "id": 1
}

200

{
  "desc": "SUCCESS",
  "error": 0,
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "ont": "2618440920",
    "ong": "999722349530000000000",
    "height": "19808542"
  }
}

getbestblockhash

Get Best Block Hash

POST

https://ont.nownodes.io/

Returns the hash of the best (most recent) block in the ONT blockchain. This method retrieves the hash of the block with the highest height in the current chain.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" for JSON-RPC 2.0 specification compliance.

methodstringrequired

The RPC method name. For this operation, it must be "getbestblockhash".

paramsarrayrequired

An array of method parameters. This method takes no parameters, so an empty array is required.

idintegerrequired

A unique identifier for the request, used to correlate the response with the request. This can be any integer value chosen by the client.

Response

200OK

Successful response containing the hash of the best block.

Authorization

api-keyAuthapiKey in header

Get Best Block Hash

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getbestblockhash",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getbestblockhash",
  "params": [],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c"
}

getblock

Get Block by Hash or Height

POST

https://ont.nownodes.io/

Retrieves information about a specific block from the ONT blockchain. The block can be identified by either its hash or its height (block number). The response can be returned in different verbosity levels (0, 1, or 2).

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" for JSON-RPC 2.0 specification compliance.

methodstringrequired

The RPC method name. For this operation, it must be "getblock".

paramsArray<string | integer | integer>required

An array containing two parameters:

Block hash or height (string or integer)
Verbosity level (0, 1, or 2) - determines the detail level of the response

Show child attributes

One of

Block hash in hexadecimal format

string

Block height (block number)

integer

Verbosity level

integer012

idintegerrequired

A unique identifier for the request, used to correlate the response with the request.

Response

200OK

Successful response containing detailed block information.

Authorization

api-keyAuthapiKey in header

Get Block by Hash or Height

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getblock",
    "params": [
      "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c",
      1
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getblock",
  "params": [
    "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c",
    1
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getblock",
  "params": [
    "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c",
    1
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c",
    "size": 1234,
    "header": {
      "version": 0,
      "prevblockhash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "merkleroot": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "timestamp": 1577836800,
      "height": 12345,
      "consensusdata": "0x0000000000000000",
      "nextconsensus": "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK"
    },
    "tx": [
      {
        "txid": "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a",
        "size": 234,
        "type": "InvocationTransaction",
        "nonce": 0,
        "gasPrice": "500",
        "gasLimit": "20000",
        "payer": "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK"
      }
    ]
  }
}

getblockcount

Get Block Count

POST

https://ont.nownodes.io/

Returns the total number of blocks in the ONT blockchain. This includes the genesis block, so the lowest possible value is 1. The block count is equivalent to the height of the best block plus one.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" for JSON-RPC 2.0 specification compliance.

methodstringrequired

The RPC method name. For this operation, it must be "getblockcount".

paramsarrayrequired

An array of method parameters. This method takes no parameters, so an empty array is required.

idintegerrequired

A unique identifier for the request, used to correlate the response with the request.

Response

200OK

Successful response containing the total block count.

Authorization

api-keyAuthapiKey in header

Get Block Count

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getblockcount",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getblockcount",
  "params": [],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": 12346
}

getblockhash

Get Block Hash by Height

POST

https://ont.nownodes.io/

Retrieves the hash of a block at a specific height (block number). Block height starts at 0 for the genesis block and increments by 1 for each subsequent block.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" for JSON-RPC 2.0 specification compliance.

methodstringrequired

The RPC method name. For this operation, it must be "getblockhash".

paramsArray<integer>required

An array containing a single parameter: the block height (index). Block height is a zero-based integer index.

idintegerrequired

A unique identifier for the request, used to correlate the response with the request.

Response

200OK

Successful response containing the block hash.

Authorization

api-keyAuthapiKey in header

Get Block Hash by Height

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getblockhash",
    "params": [
      12345
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getblockhash",
  "params": [
    12345
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getblockhash",
  "params": [
    12345
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c"
}

getrawtransaction

Get Raw Transaction

POST

https://ont.nownodes.io/

Returns detailed information about a specific transaction by its hash. The verbose parameter determines the format of the returned data.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the transaction hash and the verbose flag. The first element is the transaction hash string, the second element is the verbosity level (0 for raw hex data, 1 for JSON object).

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with transaction details.

Authorization

api-keyAuthapiKey in header

Get Raw Transaction

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getrawtransaction",
    "params": [
      "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d",
      "1"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getrawtransaction",
  "params": [
    "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d",
    "1"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getrawtransaction",
  "params": [
    "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d",
    "1"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "Hash": "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d",
    "Version": 0,
    "Nonce": 1234567890,
    "GasPrice": 0,
    "GasLimit": 20000,
    "Payer": "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX",
    "SigData": [
      "sig1...",
      "sig2..."
    ],
    "Type": 209,
    "Payload": "00",
    "BlockHash": "25f28003ece8cd1b6f13b51e30c0a9d7af75f4f7a1e5e3c7b8d9f0a1b2c3d4e5",
    "Confirmations": 100,
    "BlockHeight": 123456,
    "Timestamp": 1640000000
  }
}

sendrawtransaction

Send Raw Transaction

POST

https://ont.nownodes.io/

Broadcasts a signed raw transaction to the ONT blockchain network. The transaction must be properly formatted and signed before submission. The node will validate the transaction and relay it to other nodes in the network if valid.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" for JSON-RPC 2.0 specification compliance.

methodstringrequired

The RPC method name. For this operation, it must be "sendrawtransaction".

paramsArray<string | boolean>required

An array containing one or two parameters:

The signed raw transaction in hexadecimal format (required)
A boolean flag to prepend the transaction (optional, default is false)

Show child attributes

One of

The signed raw transaction in hexadecimal format

string

Optional flag to prepend transaction

boolean

idintegerrequired

A unique identifier for the request, used to correlate the response with the request.

Response

200OK

Successful response indicating the transaction was accepted and broadcast.

Authorization

api-keyAuthapiKey in header

Send Raw Transaction

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "sendrawtransaction",
    "params": [
      "0x80000000000000000000000000000000000000000000000000000000000000000000..."
    ],
    "id": 1
  }'

const response = await fetch('https://ont.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "sendrawtransaction",
      "params": [
        "0x80000000000000000000000000000000000000000000000000000000000000000000..."
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "sendrawtransaction",
  "params": [
    "0x80000000000000000000000000000000000000000000000000000000000000000000..."
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "sendrawtransaction",
  "params": [
    "0x80000000000000000000000000000000000000000000000000000000000000000000..."
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": true
}

getallowance

Get Approved Token Allowance (v1)

POST

https://ont.nownodes.io/

Returns the amount of native ONT or ONG tokens that an approved spender is allowed to transfer on behalf of the token owner. This is the legacy v1 endpoint, supporting only native network tokens.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" per JSON-RPC 2.0 specification.

methodstringrequired

The RPC method name. Must be "getallowance" for this operation.

paramsArray<string>required

Array with three parameters:

Asset identifier ("ont" for Ontology token, "ong" for Ontology Gas token)
Owner address (ONT address format)
Spender address (ONT address format)

idintegerrequired

Unique client-generated request ID to correlate responses with requests.

Response

200OK

Successful response with allowance amount.

Authorization

api-keyAuthapiKey in header

Get Approved Token Allowance (v1)

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getallowance",
    "params": [
      "ong",
      "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK",
      "AHCNSDkh2Xs66SzmyKGdoDKY752uyeXDrt"
    ],
    "id": 1
  }'

const response = await fetch('https://ont.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "getallowance",
      "params": [
        "ong",
        "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK",
        "AHCNSDkh2Xs66SzmyKGdoDKY752uyeXDrt"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getallowance",
  "params": [
    "ong",
    "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK",
    "AHCNSDkh2Xs66SzmyKGdoDKY752uyeXDrt"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getallowance",
  "params": [
    "ong",
    "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK",
    "AHCNSDkh2Xs66SzmyKGdoDKY752uyeXDrt"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "5000000000"
}

getallowancev2

Get Approved Token Allowance (v2)

POST

https://ont.nownodes.io/

Updated v2 endpoint that returns approved allowance amounts for all OEP-4 standard tokens, including native ONT/ONG and custom deployed tokens. Uses contract script hash instead of string asset identifiers to support arbitrary tokens.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" per JSON-RPC 2.0 specification.

methodstringrequired

The RPC method name. Must be "getallowancev2" for this operation.

paramsArray<string>required

Array with three parameters:

Token contract script hash in hexadecimal format (use native hashes for ONT: 0x01..., ONG: 0x02...)
Owner address (ONT address format)
Spender address (ONT address format)

idintegerrequired

Unique client-generated request ID to correlate responses with requests.

Response

200OK

Successful response with allowance amount.

Authorization

api-keyAuthapiKey in header

Get Approved Token Allowance (v2)

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getallowancev2",
    "params": [
      "0x0200000000000000000000000000000000000000",
      "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK",
      "AHCNSDkh2Xs66SzmyKGdoDKY752uyeXDrt"
    ],
    "id": 1
  }'

const response = await fetch('https://ont.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "getallowancev2",
      "params": [
        "0x0200000000000000000000000000000000000000",
        "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK",
        "AHCNSDkh2Xs66SzmyKGdoDKY752uyeXDrt"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getallowancev2",
  "params": [
    "0x0200000000000000000000000000000000000000",
    "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK",
    "AHCNSDkh2Xs66SzmyKGdoDKY752uyeXDrt"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getallowancev2",
  "params": [
    "0x0200000000000000000000000000000000000000",
    "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK",
    "AHCNSDkh2Xs66SzmyKGdoDKY752uyeXDrt"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "10000000000"
}

getbalance

Get Balance

POST

https://ont.nownodes.io/

Returns the ONT (Ontology) and ONG (Ontology Gas) balance for a specified account address. The ONG balance includes both available and unbound portions.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the Ontology account address to query.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with account balance information.

Authorization

api-keyAuthapiKey in header

Get Balance

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getbalance",
    "params": [
      "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getbalance",
  "params": [
    "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getbalance",
  "params": [
    "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "ont": "1000",
    "ong": "500.123456789"
  }
}

getblockheightbytxhash

Get Block Height by Transaction Hash

POST

https://ont.nownodes.io/

Returns the block height at which a specific transaction was included. The transaction is identified by its unique hash.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the transaction hash to query.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with the block height.

Authorization

api-keyAuthapiKey in header

Get Block Height by Transaction Hash

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getblockheightbytxhash",
    "params": [
      "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getblockheightbytxhash",
  "params": [
    "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getblockheightbytxhash",
  "params": [
    "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": 123456
}

getblocktxsbyheight

Get Block Transactions List by Block Height

POST

https://ont.nownodes.io/

Returns a simplified list of all transaction IDs included in a block at the specified height. This endpoint does not return full transaction details or block header metadata, making it lightweight for iterating over block transaction lists.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" per JSON-RPC 2.0 specification.

methodstringrequired

The RPC method name. Must be "getblocktxsbyheight" for this operation.

paramsArray<integer>required

Array with one parameter: block height (integer, zero-based) to fetch transactions for.

idintegerrequired

Unique client-generated request ID to correlate responses with requests.

Response

200OK

Successful response with list of transactions in the block.

Authorization

api-keyAuthapiKey in header

Get Block Transactions List by Block Height

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getblocktxsbyheight",
    "params": [
      12345
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getblocktxsbyheight",
  "params": [
    12345
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getblocktxsbyheight",
  "params": [
    12345
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "Hash": "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c",
    "Height": 12345,
    "Transactions": [
      "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
    ]
  }
}

getconnectioncount

Get Connection Count

POST

https://ont.nownodes.io/

Returns the number of active peer connections currently connected to this ONT node. This includes both incoming and outgoing connections to other nodes in the network.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" for JSON-RPC 2.0 specification compliance.

methodstringrequired

The RPC method name. For this operation, it must be "getconnectioncount".

paramsarrayrequired

An array of method parameters. This method takes no parameters, so an empty array is required.

idintegerrequired

A unique identifier for the request, used to correlate the response with the request.

Response

200OK

Successful response containing the number of active connections.

Authorization

api-keyAuthapiKey in header

Get Connection Count

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getconnectioncount",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getconnectioncount",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getconnectioncount",
  "params": [],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": 15
}

getcontractstate

Get Contract State

POST

https://ont.nownodes.io/

Returns detailed information about a deployed smart contract, including its code, author, and other metadata. The contract is identified by its script hash.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the contract script hash in hexadecimal format.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with contract state information.

Authorization

api-keyAuthapiKey in header

Get Contract State

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getcontractstate",
    "params": [
      "0100000000000000000000000000000000000000"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getcontractstate",
  "params": [
    "0100000000000000000000000000000000000000"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getcontractstate",
  "params": [
    "0100000000000000000000000000000000000000"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "version": 0,
    "hash": "0100000000000000000000000000000000000000",
    "block_height": 1000,
    "author": "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX",
    "email": "[email protected]",
    "name": "MySmartContract",
    "description": "A sample smart contract on Ontology",
    "code_version": "1.0.0",
    "contract_type": "Native"
  }
}

getgasprice

Get Gas Price

POST

https://ont.nownodes.io/

Returns the current gas price for executing smart contract operations on the Ontology blockchain. Gas price may vary based on network congestion.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An empty array of parameters for this method.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with the gas price.

Authorization

api-keyAuthapiKey in header

Get Gas Price

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getgasprice",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getgasprice",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getgasprice",
  "params": [],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "gas_price": 500
  }
}

getgrantong

Get Grant ONG

POST

https://ont.nownodes.io/

Returns information about ONG that has been generated from ONT holdings and the amount that has been claimed. This helps track the ONG generation and claiming progress.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the Ontology account address to query.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with ONG grant information.

Authorization

api-keyAuthapiKey in header

Get Grant ONG

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getgrantong",
    "params": [
      "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getgrantong",
  "params": [
    "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getgrantong",
  "params": [
    "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "granted": "1000.123456789",
    "claimed": "500.123456789"
  }
}

getmempooltxcount

Get Count of Transactions in Mempool

POST

https://ont.nownodes.io/

Returns the total number of unconfirmed transactions currently held in the node's memory pool, split between transactions that have passed validation and those pending validation.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" per JSON-RPC 2.0 specification.

methodstringrequired

The RPC method name. Must be "getmempooltxcount" for this operation.

paramsarrayrequired

Array of method parameters. This method accepts no parameters, so an empty array is required.

idintegerrequired

Unique client-generated request ID to correlate responses with requests.

Response

200OK

Successful response with mempool transaction counts.

Authorization

api-keyAuthapiKey in header

Get Count of Transactions in Mempool

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getmempooltxcount",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getmempooltxcount",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getmempooltxcount",
  "params": [],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "Verified": 127,
    "UnVerified": 42
  }
}

getmempooltxstate

Get Transaction State in Mempool

POST

https://ont.nownodes.io/

Checks whether a specific transaction exists in the node's unconfirmed transaction pool (mempool) and returns its current processing state. Useful for tracking transaction status before confirmation.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" per JSON-RPC 2.0 specification.

methodstringrequired

The RPC method name. Must be "getmempooltxstate" for this operation.

paramsArray<string>required

Array with one parameter: transaction ID (hash) in hexadecimal format to check in mempool.

idintegerrequired

Unique client-generated request ID to correlate responses with requests.

Response

200OK

Successful response with transaction state in mempool.

Authorization

api-keyAuthapiKey in header

Get Transaction State in Mempool

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getmempooltxstate",
    "params": [
      "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
    ],
    "id": 1
  }'

const response = await fetch('https://ont.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "getmempooltxstate",
      "params": [
        "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getmempooltxstate",
  "params": [
    "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getmempooltxstate",
  "params": [
    "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "Hash": "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a",
    "State": 0
  }
}

Transaction Operations

Get Merkle Proof

POST

https://ont.nownodes.io/

Returns a Merkle proof that can be used to verify that a transaction was included in a specific block. This is useful for light clients and off-chain verification.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the transaction hash to generate the Merkle proof for.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with Merkle proof information.

Authorization

api-keyAuthapiKey in header

Get Merkle Proof

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getmerkleproof",
    "params": [
      "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getmerkleproof",
  "params": [
    "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getmerkleproof",
  "params": [
    "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tx_hash": "c56a0d3a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d",
    "block_hash": "25f28003ece8cd1b6f13b51e30c0a9d7af75f4f7a1e5e3c7b8d9f0a1b2c3d4e5",
    "merkle_root": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
    "proof": [
      "hash1...",
      "hash2...",
      "hash3..."
    ],
    "block_height": 123456
  }
}

getnetworkid

Get Network ID

POST

https://ont.nownodes.io/

Returns the network identifier of the Ontology blockchain network. Different networks (mainnet, testnet) have different network IDs.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An empty array of parameters for this method.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with the network ID.

Authorization

api-keyAuthapiKey in header

Get Network ID

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getnetworkid",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getnetworkid",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getnetworkid",
  "params": [],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": 1
}

getsmartcodeevent

Get Smart Contract Events by Transaction ID

POST

https://ont.nownodes.io/

Returns all smart contract events (notifications) emitted during the execution of a confirmed transaction. Events include log data, topics, and contract addresses for each event triggered by the transaction.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" per JSON-RPC 2.0 specification.

methodstringrequired

The RPC method name. Must be "getsmartcodeevent" for this operation.

paramsArray<string>required

Array with one parameter: transaction ID (hash) in hexadecimal format for which to fetch events.

idintegerrequired

Unique client-generated request ID to correlate responses with requests.

Response

200OK

Successful response with smart contract event data.

Authorization

api-keyAuthapiKey in header

Get Smart Contract Events by Transaction ID

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getsmartcodeevent",
    "params": [
      "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
    ],
    "id": 1
  }'

const response = await fetch('https://ont.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "getsmartcodeevent",
      "params": [
        "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getsmartcodeevent",
  "params": [
    "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getsmartcodeevent",
  "params": [
    "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "TxHash": "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a",
    "State": 1,
    "GasConsumed": 20000,
    "Notify": [
      {
        "ContractAddress": "0x0100000000000000000000000000000000000000",
        "States": [
          "transfer",
          "0x1234...",
          "0xabcd...",
          "1000000000"
        ]
      }
    ]
  }
}

getstorage

Get Storage

POST

https://ont.nownodes.io/

Returns the value stored at a specific key in a smart contract's storage. This method is commonly used to read state variables from deployed smart contracts on the Ontology blockchain.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the contract script hash, the storage key (both in hexadecimal format), and optionally the block height or hash to query.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with the stored value.

Authorization

api-keyAuthapiKey in header

Get Storage

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getstorage",
    "params": [
      "0100000000000000000000000000000000000000",
      "4c6b8e0a8f2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e",
      "pending"
    ],
    "id": 1
  }'

const response = await fetch('https://ont.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "getstorage",
      "params": [
        "0100000000000000000000000000000000000000",
        "4c6b8e0a8f2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e",
        "pending"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getstorage",
  "params": [
    "0100000000000000000000000000000000000000",
    "4c6b8e0a8f2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e",
    "pending"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getstorage",
  "params": [
    "0100000000000000000000000000000000000000",
    "4c6b8e0a8f2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e",
    "pending"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "48656c6c6f20576f726c64"
}

getunboundong

Get Unbound ONG

POST

https://ont.nownodes.io/

Returns the amount of unbound ONG for a specified account address. ONG is generated through holding ONT and becomes available for withdrawal over time. Unbound ONG refers to the portion that has been generated but not yet withdrawn.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the Ontology account address to query.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with unbound ONG balance.

Authorization

api-keyAuthapiKey in header

Get Unbound ONG

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getunboundong",
    "params": [
      "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getunboundong",
  "params": [
    "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getunboundong",
  "params": [
    "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "125.678901234"
}

getversion

Get Version

POST

https://ont.nownodes.io/

Returns the version information of the Ontology node. This method does not require any parameters.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An empty array of parameters for this method.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with version information.

Authorization

api-keyAuthapiKey in header

Get Version

curl -X POST 'https://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getversion",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getversion",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getversion",
  "params": [],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "v2.0.0"
}

MAINNET / Mining_RPCs

getmininginfo

POST

https://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmininginfo",
    "params": []
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getnetworkhashps",
    "params": [
      120,
      -1
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "decoderawtransaction",
    "params": [
      "0200000001abcd...00000000"
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "decodescript",
    "params": [
      "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getrawtransaction",
    "params": [
      "txid_here",
      true
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "sendrawtransaction",
    "params": [
      "0200000001abcd...00000000",
      false
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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://ont.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "validateaddress",
    "params": [
      "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
    ]
  }'

const response = await fetch('https://ont.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://ont.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://ont.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://ont.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://ont.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://ont.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

getbalancev2

Body

Response

Authorization

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 / RPC