Monero Daemon RPC API

v1.0.0

Base URL

https://xmr.nownodes.io

Daemon RPC API documentation

Authentication

api-keyAuthapiKey

API Key: api-key in header

Node

Add aux pow

Add auxiliary PoW to a Monero block template for merge mining

POST

https://xmr.nownodes.io/json_rpc

Enables merge mining without manually altering the coinbase transaction. Accepts auxiliary block information and returns a modified block template with the auxiliary PoW included.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

blocktemplate_blobstring

Hexadecimal representation of the block template

aux_powArray<object>

List of auxiliary block hashes and IDs

Show child attributes

idstring

hashstring

Response

200OK

Auxiliary PoW added successfully

400Bad Request

Bad Request – invalid parameters

403Forbidden

Forbidden – insufficient permissions

404Not Found

Not Found – block template not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Add auxiliary PoW to a Monero block template for merge mining

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "add_aux_pow",
    "params": {
      "blocktemplate_blob": "1010ee97e2a106e9f8ebe888...",
      "aux_pow": [
        {
          "id": "3200b4ea97c3b2081cd4190b58e49572b2319fed00d030ad51809dff06b5d8c8",
          "hash": "7b35762de164b20885e15dbe656b1138db06bb402fa1796f5765a23933d8859a"
        }
      ]
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "add_aux_pow",
      "params": {
        "blocktemplate_blob": "1010ee97e2a106e9f8ebe888...",
        "aux_pow": [
          {
            "id": "3200b4ea97c3b2081cd4190b58e49572b2319fed00d030ad51809dff06b5d8c8",
            "hash": "7b35762de164b20885e15dbe656b1138db06bb402fa1796f5765a23933d8859a"
          }
        ]
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "add_aux_pow",
  "params": {
    "blocktemplate_blob": "1010ee97e2a106e9f8ebe888...",
    "aux_pow": [
      {
        "id": "3200b4ea97c3b2081cd4190b58e49572b2319fed00d030ad51809dff06b5d8c8",
        "hash": "7b35762de164b20885e15dbe656b1138db06bb402fa1796f5765a23933d8859a"
      }
    ]
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "add_aux_pow",
  "params": {
    "blocktemplate_blob": "1010ee97e2a106e9f8ebe888...",
    "aux_pow": [
      {
        "id": "3200b4ea97c3b2081cd4190b58e49572b2319fed00d030ad51809dff06b5d8c8",
        "hash": "7b35762de164b20885e15dbe656b1138db06bb402fa1796f5765a23933d8859a"
      }
    ]
  }
}

{
  "id": "string",
  "jsonrpc": "string",
  "result": {
    "blocktemplate_blob": "string",
    "blockhashing_blob": "string",
    "merkle_root": "string",
    "merkle_tree_depth": 0,
    "aux_pow": [
      {
        "id": "string",
        "hash": "string"
      }
    ],
    "status": "OK",
    "untrusted": false
  }
}

{
  "error": "Invalid params"
}

"Forbidden"

{
  "error": "Block template not found"
}

{
  "error": "Internal server error"
}

Check IP address banned

Check if an IP address is banned

POST

https://xmr.nownodes.io/json_rpc

Check whether a given IP address is banned and for how long.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

addressstring

Response

200OK

Ban status for the given IP

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Check if an IP address is banned

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "banned",
    "params": {
      "address": "95.216.203.255"
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "banned",
      "params": {
        "address": "95.216.203.255"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "banned",
  "params": {
    "address": "95.216.203.255"
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "banned",
  "params": {
    "address": "95.216.203.255"
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "banned": true,
    "seconds": 690413,
    "status": "OK"
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "IP address not found or not banned"
}

{
  "error": "Internal server error"
}

Calc POW

Calculate PoW hash for a block candidate

POST

https://xmr.nownodes.io/json_rpc

Calculates the proof-of-work hash for a given block candidate blob.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

major_versionintegerrequired

The major version of Monero protocol at this block height

heightintegerrequired

Block height

block_blobstringrequired

Hexadecimal blob of the block candidate

seed_hashstringrequired

RandomX seed hash

Response

200OK

PoW hash calculation result

400Bad Request

Bad Request - invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Calculate PoW hash for a block candidate

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "calc_pow",
    "params": {
      "major_version": 14,
      "height": 2286447,
      "block_blob": "0e0ed286da8006ecdc1aab3033cf1716c52f13f9d8ae005...",
      "seed_hash": "d432f499205150873b2572b5f033c9c6e4b7c6f3394bd2dd93822cd7085e7307"
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "calc_pow",
      "params": {
        "major_version": 14,
        "height": 2286447,
        "block_blob": "0e0ed286da8006ecdc1aab3033cf1716c52f13f9d8ae005...",
        "seed_hash": "d432f499205150873b2572b5f033c9c6e4b7c6f3394bd2dd93822cd7085e7307"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "calc_pow",
  "params": {
    "major_version": 14,
    "height": 2286447,
    "block_blob": "0e0ed286da8006ecdc1aab3033cf1716c52f13f9d8ae005...",
    "seed_hash": "d432f499205150873b2572b5f033c9c6e4b7c6f3394bd2dd93822cd7085e7307"
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "calc_pow",
  "params": {
    "major_version": 14,
    "height": 2286447,
    "block_blob": "0e0ed286da8006ecdc1aab3033cf1716c52f13f9d8ae005...",
    "seed_hash": "d432f499205150873b2572b5f033c9c6e4b7c6f3394bd2dd93822cd7085e7307"
  }
}

{
  "id": "string",
  "jsonrpc": "string",
  "result": "d0402d6834e26fb94a9ce38c6424d27d2069896a9b8b1ce685d79936bca6e0a8"
}

{
  "error": "Invalid block_blob or seed_hash"
}

Insufficient permissions

{
  "error": "Block candidate not found"
}

{
  "error": "Internal server error"
}

Flush cache

Flush bad transactions and blocks from the cache

POST

https://xmr.nownodes.io/json_rpc

Removes invalid or bad transactions and/or blocks from the daemon cache.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

bad_txsboolean

Flush bad transactions

bad_blocksboolean

Flush bad blocks

Response

200OK

Cache flush result

400Bad Request

Bad Request - invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Flush bad transactions and blocks from the cache

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "flush_cache",
    "params": {
      "bad_txs": true,
      "bad_blocks": true
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "flush_cache",
      "params": {
        "bad_txs": true,
        "bad_blocks": true
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "flush_cache",
  "params": {
    "bad_txs": True,
    "bad_blocks": True
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "flush_cache",
  "params": {
    "bad_txs": true,
    "bad_blocks": true
  }
}

{
  "id": "string",
  "jsonrpc": "string",
  "result": {
    "status": "OK",
    "untrusted": false
  }
}

{
  "error": "Invalid params"
}

Insufficient permissions

{
  "error": "Cache not found"
}

{
  "error": "Internal server error"
}

Flush txpool

Flush tx ids from transaction pool

POST

https://xmr.nownodes.io/json_rpc

Removes transactions from the transaction pool. If no txids are provided, all transactions in the pool are flushed.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

txidsArray<string>

List of transaction IDs to flush. Flushes all if empty.

Response

200OK

Transactions flushed successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Flush tx ids from transaction pool

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "flush_txpool",
    "params": {
      "txids": [
        "dc16fa8eaffe1484ca9014ea050e13131d3acf23b419f33bb4cc0b32b6c49308"
      ]
    }
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "flush_txpool",
  "params": {
    "txids": [
      "dc16fa8eaffe1484ca9014ea050e13131d3acf23b419f33bb4cc0b32b6c49308"
    ]
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "flush_txpool",
  "params": {
    "txids": [
      "dc16fa8eaffe1484ca9014ea050e13131d3acf23b419f33bb4cc0b32b6c49308"
    ]
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "status": "OK"
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Transactions not found in pool"
}

{
  "error": "Internal server error"
}

Generate blocks

POST

https://xmr.nownodes.io/json_rpc

Generates a number of blocks and returns their hashes.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

wallet_addressstring

Address to receive the coinbase rewards

amount_of_blocksinteger

Number of blocks to generate

reserve_sizeinteger

Extra space reserved for miner data

Response

200OK

Blocks generated

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Generate blocks

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "generateblocks",
    "params": {
      "wallet_address": "string",
      "amount_of_blocks": 0,
      "reserve_size": 0
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "generateblocks",
      "params": {
        "wallet_address": "string",
        "amount_of_blocks": 0,
        "reserve_size": 0
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "generateblocks",
  "params": {
    "wallet_address": "string",
    "amount_of_blocks": 0,
    "reserve_size": 0
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "generateblocks",
  "params": {
    "wallet_address": "string",
    "amount_of_blocks": 0,
    "reserve_size": 0
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "blocks": [
      "49b712db7760e3728586f8434ee8bc8d7b3d410dac6bb6e98bf5845c83b917e4"
    ],
    "height": 9783,
    "status": "OK",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Blocks not found"
}

{
  "error": "Internal server error"
}

Get alternate chains

Get alternative chains

POST

https://xmr.nownodes.io/json_rpc

Display alternative chains seen by the node.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

Alternative chains retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get alternative chains

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_alternate_chains"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_alternate_chains"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_alternate_chains"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_alternate_chains"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "chains": [
      {
        "block_hash": "dd4998cfe92a959a5a0e4ed72432cf23d7dfc4179cbea871ee2a705d71fb5e25",
        "block_hashes": [
          "dd4998cfe92a959a5a0e4ed72432cf23d7dfc4179cbea871ee2a705d71fb5e25"
        ],
        "difficulty": 86227995333492080,
        "difficulty_top64": 0,
        "height": 2286736,
        "length": 1,
        "main_chain_parent_block": "6da3d2dc86ccc9353d19fc6b05083125f4ca7d22540d938010462f197a3fe590",
        "wide_difficulty": "0x13257e7a78bfd6f"
      }
    ],
    "status": "OK",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Alternate chains not found"
}

{
  "error": "Internal server error"
}

get bans

Get list of banned IPs

POST

https://xmr.nownodes.io/json_rpc

Retrieve the list of currently banned nodes by host or IP.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

List of banned nodes

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get list of banned IPs

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_bans"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_bans"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_bans"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_bans"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "bans": [
      {
        "host": "102.168.1.51",
        "ip": 855746662,
        "seconds": 22
      },
      {
        "host": "192.168.1.50",
        "ip": 838969536,
        "seconds": 28
      }
    ],
    "status": "OK",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "No banned nodes found"
}

{
  "error": "Internal server error"
}

Get block count

POST

https://xmr.nownodes.io/json_rpc

Look up how many blocks are in the longest chain known to the node.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

Returns the current block count of the node

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block count

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_block_count"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_block_count"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_block_count"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_block_count"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "count": 993163,
    "status": "OK",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Get block header by hash

POST

https://xmr.nownodes.io/json_rpc

Retrieve block header information using the block's hash.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

hashstring

The block's sha256 hash

fill_pow_hashboolean

Add PoW hash to block_header response (optional, defaults to false)

Response

200OK

Block header information

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block header by hash

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_block_header_by_hash",
    "params": {
      "hash": "string",
      "fill_pow_hash": true
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_block_header_by_hash",
      "params": {
        "hash": "string",
        "fill_pow_hash": true
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_block_header_by_hash",
  "params": {
    "hash": "string",
    "fill_pow_hash": True
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_block_header_by_hash",
  "params": {
    "hash": "string",
    "fill_pow_hash": true
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "block_header": {
      "block_size": 210,
      "block_weight": 210,
      "cumulative_difficulty": 754734824984346,
      "cumulative_difficulty_top64": 0,
      "depth": 1374113,
      "difficulty": 815625611,
      "difficulty_top64": 0,
      "hash": "e22cf75f39ae720e8b71b3d120a5ac03f0db50bba6379e2850975b4859190bc6",
      "height": 912345,
      "long_term_weight": 210,
      "major_version": 1,
      "miner_tx_hash": "c7da3965f25c19b8eb7dd8db48dcd4e7c885e2491db77e289f0609bf8e08ec30",
      "minor_version": 2,
      "nonce": 1646,
      "num_txes": 0,
      "orphan_status": false,
      "pow_hash": "",
      "prev_hash": "b61c58b2e0be53fad5ef9d9731a55e8a81d972b8d90ed07c04fd37ca6403ff78",
      "reward": 7388968946286,
      "timestamp": 1452793716,
      "wide_cumulative_difficulty": "0x2ae6d65248f1a",
      "wide_difficulty": "0x309d758b"
    },
    "credits": 0,
    "status": "OK",
    "top_hash": "",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Get block header by height

POST

https://xmr.nownodes.io/json_rpc

Retrieve block header information using the block's height.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

heightinteger

The block's height

fill_pow_hashboolean

Add PoW hash to block_header response (optional, defaults to false)

Response

200OK

Block header information

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block header by height

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_block_header_by_height",
    "params": {
      "height": 0,
      "fill_pow_hash": true
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_block_header_by_height",
      "params": {
        "height": 0,
        "fill_pow_hash": true
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_block_header_by_height",
  "params": {
    "height": 0,
    "fill_pow_hash": True
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_block_header_by_height",
  "params": {
    "height": 0,
    "fill_pow_hash": true
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "block_header": {
      "block_size": 210,
      "block_weight": 210,
      "cumulative_difficulty": 754734824984346,
      "cumulative_difficulty_top64": 0,
      "depth": 1374118,
      "difficulty": 815625611,
      "difficulty_top64": 0,
      "hash": "e22cf75f39ae720e8b71b3d120a5ac03f0db50bba6379e2850975b4859190bc6",
      "height": 912345,
      "long_term_weight": 210,
      "major_version": 1,
      "miner_tx_hash": "c7da3965f25c19b8eb7dd8db48dcd4e7c885e2491db77e289f0609bf8e08ec30",
      "minor_version": 2,
      "nonce": 1646,
      "num_txes": 0,
      "orphan_status": false,
      "pow_hash": "",
      "prev_hash": "b61c58b2e0be53fad5ef9d9731a55e8a81d972b8d90ed07c04fd37ca6403ff78",
      "reward": 7388968946286,
      "timestamp": 1452793716,
      "wide_cumulative_difficulty": "0x2ae6d65248f1a",
      "wide_difficulty": "0x309d758b"
    },
    "credits": 0,
    "status": "OK",
    "top_hash": "",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Get full block information

POST

https://xmr.nownodes.io/json_rpc

Retrieve full block information using either block height or hash.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

heightinteger

hashstring

fill_pow_hashboolean

Add PoW hash to block_header response (optional, default false)

Response

200OK

Full block information

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get full block information

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_block",
    "params": {
      "height": 0,
      "hash": "string",
      "fill_pow_hash": true
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_block",
      "params": {
        "height": 0,
        "hash": "string",
        "fill_pow_hash": true
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_block",
  "params": {
    "height": 0,
    "hash": "string",
    "fill_pow_hash": True
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_block",
  "params": {
    "height": 0,
    "hash": "string",
    "fill_pow_hash": true
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "blob": "1010c58bab9b06b27bdecfc6cd0a46172d136c08831cf67660377ba992332363228b1b722781e7807e07f502cef8a70101ff92f8a7010180e0a596bb1103d7cbf826b665d7a532c316982dc8dbc24f285cbc18bbcc27c7164cd9b3277a85d034019f629d8b36bd16a2bfce3ea80c31dc4d8762c67165aec21845494e32b7582fe00211000000297a787a000000000000000000000000",
    "block_header": {
      "block_size": 106,
      "block_weight": 106,
      "cumulative_difficulty": 236046001376524160,
      "cumulative_difficulty_top64": 0,
      "depth": 40,
      "difficulty": 313732272488,
      "difficulty_top64": 0,
      "hash": "43bd1f2b6556dcafa413d8372974af59e4e8f37dbf74dc6b2a9b7212d0577428",
      "height": 2751506,
      "long_term_weight": 176470,
      "major_version": 16,
      "miner_tx_hash": "e49b854c5f339d7410a77f2a137281d8042a0ffc7ef9ab24cd670b67139b24cd",
      "minor_version": 16,
      "nonce": 4110909056,
      "num_txes": 0,
      "orphan_status": false,
      "pow_hash": "",
      "prev_hash": "b27bdecfc6cd0a46172d136c08831cf67660377ba992332363228b1b722781e7",
      "reward": 600000000000,
      "timestamp": 1667941829,
      "wide_cumulative_difficulty": "0x3469a966eb2f788",
      "wide_difficulty": "0x490be69168"
    },
    "credits": 0,
    "json": "{...}",
    "miner_tx_hash": "e49b854c5f339d7410a77f2a137281d8042a0ffc7ef9ab24cd670b67139b24cd",
    "status": "OK",
    "top_hash": "",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Get coinbase tx sum

Get coinbase and fee amounts for n last blocks starting at a particular height

POST

https://xmr.nownodes.io/json_rpc

Retrieves the sum of coinbase rewards and fees for a range of blocks.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

heightinteger

countinteger

Response

200OK

Coinbase and fees sums retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get coinbase and fee amounts for n last blocks starting at a particular height

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_coinbase_tx_sum",
    "params": {
      "height": 1563078,
      "count": 2
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_coinbase_tx_sum",
      "params": {
        "height": 1563078,
        "count": 2
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_coinbase_tx_sum",
  "params": {
    "height": 1563078,
    "count": 2
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_coinbase_tx_sum",
  "params": {
    "height": 1563078,
    "count": 2
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "credits": 0,
    "emission_amount": 9471836197320,
    "emission_amount_top64": 0,
    "fee_amount": 0,
    "fee_amount_top64": 0,
    "status": "OK",
    "top_hash": "",
    "untrusted": false,
    "wide_emission_amount": "0x89d556e91c8",
    "wide_fee_amount": "0x0"
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Blocks not found"
}

{
  "error": "Internal server error"
}

Retrieve node connections

POST

https://xmr.nownodes.io/json_rpc

Get information about incoming and outgoing connections to your node.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

List of node connections

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve node connections

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_connections"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_connections"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_connections"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_connections"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "connections": [
      {
        "address": "51.75.162.171:44741",
        "address_type": 1,
        "avg_download": 0,
        "avg_upload": 1,
        "connection_id": "4420a6fcf9c642daaae41400ccfc1fd7",
        "current_download": 0,
        "current_upload": 1,
        "height": 1,
        "host": "51.75.162.171",
        "incoming": true,
        "ip": "51.75.162.171",
        "live_time": 9,
        "local_ip": false,
        "localhost": false,
        "peer_id": "ff561b6a65c2838c",
        "port": "44741",
        "pruning_seed": 0,
        "recv_count": 382,
        "recv_idle_time": 8,
        "rpc_credits_per_hash": 0,
        "rpc_port": 0,
        "send_count": 15434,
        "send_idle_time": 8,
        "state": "normal",
        "support_flags": 1
      }
    ],
    "status": "OK",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Internal server error"
}

Get fee estimate

Get fee estimation

POST

https://xmr.nownodes.io/json_rpc

Provides an estimation of transaction fees per byte.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

grace_blocksinteger

Optional number of grace blocks

Response

200OK

Fee estimate retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get fee estimation

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_fee_estimate",
    "params": {
      "grace_blocks": 0
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_fee_estimate",
      "params": {
        "grace_blocks": 0
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_fee_estimate",
  "params": {
    "grace_blocks": 0
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_fee_estimate",
  "params": {
    "grace_blocks": 0
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "credits": 0,
    "fee": 7874,
    "fees": [
      20000,
      80000,
      320000,
      4000000
    ],
    "quantization_mask": 10000,
    "status": "OK",
    "top_hash": "",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Fee estimate not found"
}

{
  "error": "Internal server error"
}

Get info

Retrieve general information about the node and network

POST

https://xmr.nownodes.io/json_rpc

Returns general info about the state of your Monero node and the network.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

Node information

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve general information about the node and network

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_info"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_info"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_info"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_info"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "adjusted_time": 1612090533,
    "alt_blocks_count": 2,
    "block_size_limit": 600000,
    "block_size_median": 300000,
    "block_weight_limit": 600000,
    "block_weight_median": 300000,
    "bootstrap_daemon_address": "",
    "busy_syncing": false,
    "credits": 0,
    "cumulative_difficulty": 86168732847545380,
    "cumulative_difficulty_top64": 0,
    "database_size": 34329849856,
    "difficulty": 225889137349,
    "difficulty_top64": 0,
    "free_space": 10795802624,
    "grey_peerlist_size": 4999,
    "height": 2286472,
    "height_without_bootstrap": 2286472,
    "incoming_connections_count": 85,
    "mainnet": true,
    "nettype": "mainnet",
    "offline": false,
    "outgoing_connections_count": 16,
    "rpc_connections_count": 1,
    "stagenet": false,
    "start_time": 1611915662,
    "status": "OK",
    "synchronized": true,
    "target": 120,
    "target_height": 2286464,
    "testnet": false,
    "top_block_hash": "b92720d8315b96e32020d04e14a0c54cc13e057d4a5beb4501be490d306fdd8f",
    "top_hash": "",
    "tx_count": 11239803,
    "tx_pool_size": 21,
    "untrusted": false,
    "update_available": false,
    "version": "0.17.1.9-release",
    "was_bootstrap_ever_used": false,
    "white_peerlist_size": 1000,
    "wide_cumulative_difficulty": "0x1322201881f9c18",
    "wide_difficulty": "0x34980ab2c5"
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Internal server error"
}

Get last block header

POST

https://xmr.nownodes.io/json_rpc

Retrieves the header information for the most recent block.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

fill_pow_hashboolean

Add PoW hash to block_header response (optional, defaults to false)

Response

200OK

Block header information

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get last block header

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_last_block_header",
    "params": {
      "fill_pow_hash": true
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_last_block_header",
      "params": {
        "fill_pow_hash": true
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_last_block_header",
  "params": {
    "fill_pow_hash": True
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_last_block_header",
  "params": {
    "fill_pow_hash": true
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "block_header": {
      "block_size": 5500,
      "block_weight": 5500,
      "cumulative_difficulty": 86164894009456480,
      "cumulative_difficulty_top64": 0,
      "depth": 0,
      "difficulty": 227026389695,
      "difficulty_top64": 0,
      "hash": "a6ad87cf357a1aac1ee1d7cb0afa4c2e653b0b1ab7d5bf6af310333e43c59dd0",
      "height": 2286454,
      "long_term_weight": 5500,
      "major_version": 14,
      "miner_tx_hash": "a474f87de1645ff14c5e90c477b07f9bc86a22fb42909caa0705239298da96d0",
      "minor_version": 14,
      "nonce": 249602367,
      "num_txes": 3,
      "orphan_status": false,
      "pow_hash": "",
      "prev_hash": "fa17fefe1d05da775a61a3dc33d9e199d12af167ef0ab37e52b51e8487b50f25",
      "reward": 1181337498013,
      "timestamp": 1612088597,
      "wide_cumulative_difficulty": "0x1321e83bb8af763",
      "wide_difficulty": "0x34dbd3cabf"
    },
    "credits": 0,
    "status": "OK",
    "top_hash": "",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Get miner data

Get miner data for custom block template

POST

https://xmr.nownodes.io/json_rpc

Provides the necessary data to create a custom block template, used by p2pool.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

Miner data retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get miner data for custom block template

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_miner_data"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_miner_data"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_miner_data"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_miner_data"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "major_version": 16,
    "height": 2731375,
    "prev_id": "78d50c5894d187c4946d54410990ca59a75017628174a9e8c7055fa4ca5c7c6d",
    "seed_hash": "a6b869d50eca3a43ec26fe4c369859cf36ae37ce6ecb76457d31ffeb8a6ca8a6",
    "difficulty": "0x48afae42de",
    "median_weight": 300000,
    "already_generated_coins": 18186022843595960000,
    "status": "OK",
    "tx_backlog": [
      {
        "id": "9868490d6bb9207fdd9cf17ca1f6c791b92ca97de0365855ea5c089f67c22208",
        "weight": 1535,
        "fee": 30700000
      },
      {
        "id": "b6000b02bbec71e18ad704bcae09fb6e5ae86d897ced14a718753e76e86c0a0a",
        "weight": 2214,
        "fee": 44280000
      }
    ],
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Data not found"
}

{
  "error": "Internal server error"
}

Get output distribution

Get output distribution for given amounts

POST

https://xmr.nownodes.io/json_rpc

Retrieves distribution data for one or more output amounts within a block height range.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

amountsArray<integer>

cumulativebooleanfalse

from_heightinteger0

to_heightinteger0

Response

200OK

Output distribution retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get output distribution for given amounts

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_output_distribution",
    "params": {
      "amounts": [
        0
      ],
      "cumulative": false,
      "from_height": 0,
      "to_height": 0
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_output_distribution",
      "params": {
        "amounts": [
          0
        ],
        "cumulative": false,
        "from_height": 0,
        "to_height": 0
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_output_distribution",
  "params": {
    "amounts": [
      0
    ],
    "cumulative": False,
    "from_height": 0,
    "to_height": 0
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_output_distribution",
  "params": {
    "amounts": [
      0
    ],
    "cumulative": false,
    "from_height": 0,
    "to_height": 0
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "distributions": [
      {
        "amount": 2628780000,
        "base": 0,
        "distribution": "",
        "start_height": 1462078
      }
    ],
    "status": "OK"
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Data not found"
}

{
  "error": "Internal server error"
}

Get output histogram

Get a histogram of output amounts

POST

https://xmr.nownodes.io/json_rpc

For all amounts (possibly filtered by parameters), returns the number of outputs on the chain for that amount. RingCT outputs count as 0 amount.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

amountsArray<integer>

min_countinteger

max_countinteger

unlockedboolean

recent_cutoffinteger

Response

200OK

Histogram retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get a histogram of output amounts

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_output_histogram",
    "params": {
      "amounts": [
        20000000000
      ],
      "min_count": 0,
      "max_count": 0,
      "unlocked": true,
      "recent_cutoff": 0
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_output_histogram",
      "params": {
        "amounts": [
          20000000000
        ],
        "min_count": 0,
        "max_count": 0,
        "unlocked": true,
        "recent_cutoff": 0
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_output_histogram",
  "params": {
    "amounts": [
      20000000000
    ],
    "min_count": 0,
    "max_count": 0,
    "unlocked": True,
    "recent_cutoff": 0
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_output_histogram",
  "params": {
    "amounts": [
      20000000000
    ],
    "min_count": 0,
    "max_count": 0,
    "unlocked": true,
    "recent_cutoff": 0
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "credits": 0,
    "histogram": [
      {
        "amount": 20000000000,
        "total_instances": 381477,
        "unlocked_instances": 0,
        "recent_instances": 0
      }
    ],
    "status": "OK",
    "top_hash": "",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Outputs not found"
}

{
  "error": "Internal server error"
}

Get txpool backlog

Get all transaction pool backlog

POST

https://xmr.nownodes.io/json_rpc

Retrieves information about all transactions currently in the txpool backlog.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

Transaction pool backlog retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get all transaction pool backlog

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_txpool_backlog"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_txpool_backlog"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_txpool_backlog"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_txpool_backlog"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "backlog": "...Binary...",
    "status": "OK",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Data not found"
}

{
  "error": "Internal server error"
}

Get version

Get current node version

POST

https://xmr.nownodes.io/json_rpc

Retrieves the current version of the node software and indicates if it is an official release.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

Node version retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get current node version

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "get_version"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "get_version"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_version"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "get_version"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "release": true,
    "status": "OK",
    "untrusted": false,
    "version": 196613
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Version info not found"
}

{
  "error": "Internal server error"
}

On get block hash

Get block hash

POST

https://xmr.nownodes.io/json_rpc

Look up a block's hash by its height.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsArray<integer>

Response

200OK

Returns the block hash for the given height

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block hash

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "on_get_block_hash",
  "params": [
    0
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "on_get_block_hash",
  "params": [
    0
  ]
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": "e22cf75f39ae720e8b71b3d120a5ac03f0db50bba6379e2850975b4859190bc6"
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Relay tx

Relay transactions

POST

https://xmr.nownodes.io/json_rpc

Relay a list of transaction IDs to the network.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

txidsArray<string>

Response

200OK

Transactions relayed successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Relay transactions

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "relay_tx",
    "params": {
      "txids": [
        "9fd75c429cbe52da9a52f2ffc5fbd107fe7fd2099c0d8de274dc8a67e0c98613"
      ]
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "relay_tx",
      "params": {
        "txids": [
          "9fd75c429cbe52da9a52f2ffc5fbd107fe7fd2099c0d8de274dc8a67e0c98613"
        ]
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "relay_tx",
  "params": {
    "txids": [
      "9fd75c429cbe52da9a52f2ffc5fbd107fe7fd2099c0d8de274dc8a67e0c98613"
    ]
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "relay_tx",
  "params": {
    "txids": [
      "9fd75c429cbe52da9a52f2ffc5fbd107fe7fd2099c0d8de274dc8a67e0c98613"
    ]
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "status": "OK"
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Transactions not found"
}

{
  "error": "Internal server error"
}

Submit block

Submit a mined block to the network

POST

https://xmr.nownodes.io/json_rpc

Sends a mined block to the Monero network for inclusion in the blockchain.

Body

application/json

jsonrpcstring

idstring

methodstring

paramsobject

Show child attributes

blockstring

Serialized block data to submit

Response

200OK

Submission result

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Submit a mined block to the network

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "submit_block",
    "params": {
      "block": "string"
    }
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "submit_block",
      "params": {
        "block": "string"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "submit_block",
  "params": {
    "block": "string"
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "submit_block",
  "params": {
    "block": "string"
  }
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "error": {
    "code": -7,
    "message": "Block not accepted"
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Sync info

Get synchronization information

POST

https://xmr.nownodes.io/json_rpc

Retrieve synchronization status and details about block queue and peers.

Body

application/json

jsonrpcstring

idstring

methodstring

Response

200OK

Node synchronization info retrieved successfully

400Bad Request

Bad Request - missing or invalid parameters

403Forbidden

Forbidden

404Not Found

Not Found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get synchronization information

curl -X POST 'https://xmr.nownodes.io/json_rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "sync_info"
  }'

const response = await fetch('https://xmr.nownodes.io/json_rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "0",
      "method": "sync_info"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "0",
  "method": "sync_info"
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "sync_info"
}

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "credits": 0,
    "height": 2287210,
    "next_needed_pruning_seed": 0,
    "overview": "[]",
    "peers": [
      {
        "info": {
          "address": "51.79.49.41:44317",
          "address_type": 1,
          "avg_download": 0,
          "avg_upload": 1,
          "connection_id": "718a970773e844618f3b830aa5775a45",
          "current_download": 0,
          "current_upload": 1,
          "height": 1,
          "host": "51.79.49.41",
          "incoming": true,
          "ip": "51.79.49.41",
          "live_time": 26,
          "local_ip": false,
          "localhost": false,
          "peer_id": "c1d50bcd29c89909",
          "port": "44317",
          "pruning_seed": 0,
          "recv_count": 468,
          "recv_idle_time": 5,
          "rpc_credits_per_hash": 0,
          "rpc_port": 0,
          "send_count": 35347,
          "send_idle_time": 3,
          "state": "normal",
          "support_flags": 1
        }
      }
    ],
    "status": "OK",
    "target_height": 2287203,
    "top_hash": "",
    "untrusted": false
  }
}

{
  "error": "Invalid request parameters"
}

Insufficient permissions

{
  "error": "Data not found"
}

{
  "error": "Internal server error"
}

Documentation

Authentication

Node

Add aux pow

Body

Response

Authorization

Check IP address banned

Body

Response

Authorization

Calc POW

Body

Response

Authorization

Flush cache

Body

Response

Authorization

Flush txpool

Body

Response

Authorization

Generate blocks

Body

Response

Authorization

Get alternate chains

Body

Response

Authorization

get bans

Body

Response

Authorization

Get block count

Body

Response

Authorization

Get block header by hash

Body

Response

Authorization

Get block header by height

Body

Response

Authorization

Get full block information

Body

Response

Authorization

Get coinbase tx sum

Body

Response

Authorization

Retrieve node connections

Body

Response

Authorization

Get fee estimate

Body

Response

Authorization

Get info

Body

Response

Authorization

Get last block header

Body

Response

Authorization

Get miner data

Body

Response

Authorization

Get output distribution

Body

Response

Authorization

Get output histogram