Nano RPC - account_balance

v1.0.0

Base URL

https://xno.nownodes.ioNOWNodes Nano mainnet endpoint

Executes the Nano node RPC action account_balance.

Authentication

api-keyAuthapiKey

NOWNodes API key passed in the api-key header.

API Key: api-key in header

Node / Accounts

Accounts

Nano Accounts RPC methods

account_balance

POST

https://xno.nownodes.io/

Executes the Nano node RPC action account_balance.

Body

application/json

actionstringaccount_balancerequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

account_balance

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "account_balance",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "account_balance",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "account_balance",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "account_balance",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "balance": "10000",
  "pending": "10000",
  "receivable": "10000"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

account_block_count

POST

https://xno.nownodes.io/

Executes the Nano node RPC action account_block_count.

Body

application/json

actionstringaccount_block_countrequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

account_block_count

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "account_block_count",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "account_block_count",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "account_block_count",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "account_block_count",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "block_count": "19"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

account_history

POST

https://xno.nownodes.io/

Executes the Nano node RPC action account_history.

Body

application/json

actionstringaccount_historyrequired

accountstringrequired

countstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

account_history

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "account_history",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "count": "10"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "account_history",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
      "count": "10"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "account_history",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
  "count": "10"
}

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

Request Body

{
  "action": "account_history",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
  "count": "10"
}

{
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
  "history": [
    {
      "type": "send",
      "account": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
      "amount": "1000",
      "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
      "confirmed": "true"
    }
  ]
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

account_info

POST

https://xno.nownodes.io/

Executes the Nano node RPC action account_info.

Body

application/json

actionstringaccount_inforequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

account_info

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "account_info",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "account_info",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "account_info",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "account_info",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "frontier": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "open_block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "representative_block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "balance": "1000000000000000000000000000000",
  "modified_timestamp": "1720000000",
  "block_count": "100",
  "account_version": "2",
  "confirmation_height": "100",
  "confirmation_height_frontier": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

account_representative

POST

https://xno.nownodes.io/

Executes the Nano node RPC action account_representative.

Body

application/json

actionstringaccount_representativerequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

account_representative

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "account_representative",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "account_representative",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "account_representative",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "account_representative",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "representative": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

account_weight

POST

https://xno.nownodes.io/

Executes the Nano node RPC action account_weight.

Body

application/json

actionstringaccount_weightrequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

account_weight

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "account_weight",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "account_weight",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "account_weight",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "account_weight",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "weight": "10000"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

accounts_balances

POST

https://xno.nownodes.io/

Executes the Nano node RPC action accounts_balances.

Body

application/json

actionstringaccounts_balancesrequired

accountsArray<string>required

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

accounts_balances

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "accounts_balances",
    "accounts": [
      "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
      "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
    ]
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "accounts_balances",
      "accounts": [
        "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
        "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "accounts_balances",
  "accounts": [
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  ]
}

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

Request Body

{
  "action": "accounts_balances",
  "accounts": [
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  ]
}

{
  "balances": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": {
      "balance": "1000",
      "pending": "0",
      "receivable": "0"
    }
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

accounts_frontiers

POST

https://xno.nownodes.io/

Executes the Nano node RPC action accounts_frontiers.

Body

application/json

actionstringaccounts_frontiersrequired

accountsArray<string>required

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

accounts_frontiers

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "accounts_frontiers",
    "accounts": [
      "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
      "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
    ]
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "accounts_frontiers",
      "accounts": [
        "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
        "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "accounts_frontiers",
  "accounts": [
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  ]
}

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

Request Body

{
  "action": "accounts_frontiers",
  "accounts": [
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  ]
}

{
  "frontiers": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

accounts_receivable

POST

https://xno.nownodes.io/

Executes the Nano node RPC action accounts_receivable.

Body

application/json

actionstringaccounts_receivablerequired

accountsArray<string>required

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

accounts_receivable

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "accounts_receivable",
    "accounts": [
      "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
      "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
    ]
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "accounts_receivable",
      "accounts": [
        "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
        "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "accounts_receivable",
  "accounts": [
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  ]
}

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

Request Body

{
  "action": "accounts_receivable",
  "accounts": [
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  ]
}

{
  "blocks": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": [
      "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
    ]
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

accounts_representatives

POST

https://xno.nownodes.io/

Executes the Nano node RPC action accounts_representatives.

Body

application/json

actionstringaccounts_representativesrequired

accountsArray<string>required

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

accounts_representatives

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "accounts_representatives",
    "accounts": [
      "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
      "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
    ]
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "accounts_representatives",
      "accounts": [
        "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
        "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "accounts_representatives",
  "accounts": [
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  ]
}

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

Request Body

{
  "action": "accounts_representatives",
  "accounts": [
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  ]
}

{
  "representatives": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7"
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

Node / Blocks

Blocks

Nano Blocks RPC methods

block_account

POST

https://xno.nownodes.io/

Executes the Nano node RPC action block_account.

Body

application/json

actionstringblock_accountrequired

hashstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

block_account

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "block_account",
    "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "block_account",
      "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "block_account",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

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

Request Body

{
  "action": "block_account",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

{
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

block_count

POST

https://xno.nownodes.io/

Executes the Nano node RPC action block_count.

Body

application/json

actionstringblock_countrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

block_count

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "block_count"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "block_count"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "block_count"
}

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

Request Body

{
  "action": "block_count"
}

{
  "count": "180000000",
  "unchecked": "0",
  "cemented": "179999000",
  "full": "180000000"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

block_hash

POST

https://xno.nownodes.io/

Executes the Nano node RPC action block_hash.

Body

application/json

actionstringblock_hashrequired

hashstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

block_hash

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "block_hash",
    "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "block_hash",
      "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "block_hash",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

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

Request Body

{
  "action": "block_hash",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

{
  "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

blocks

POST

https://xno.nownodes.io/

Executes the Nano node RPC action blocks.

Body

application/json

actionstringblocksrequired

hashesArray<string>required

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

blocks

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "blocks",
    "hashes": [
      "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
    ]
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "blocks",
      "hashes": [
        "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "blocks",
  "hashes": [
    "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  ]
}

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

Request Body

{
  "action": "blocks",
  "hashes": [
    "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  ]
}

{
  "blocks": {
    "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C": {
      "block_account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
      "amount": "1000",
      "balance": "1000",
      "height": "1",
      "local_timestamp": "1720000000",
      "confirmed": "true",
      "contents": {}
    }
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

Node / Ledger

Ledger

Nano Ledger RPC methods

available_supply

POST

https://xno.nownodes.io/

Executes the Nano node RPC action available_supply.

Body

application/json

actionstringavailable_supplyrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

available_supply

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "available_supply"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "available_supply"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "available_supply"
}

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

Request Body

{
  "action": "available_supply"
}

{
  "available": "133248061996216572282917317807824970865"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

chain

POST

https://xno.nownodes.io/

Executes the Nano node RPC action chain.

Body

application/json

actionstringchainrequired

blockstringrequired

countstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

chain

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "chain",
    "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
    "count": "10"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "chain",
      "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
      "count": "10"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "chain",
  "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "count": "10"
}

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

Request Body

{
  "action": "chain",
  "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "count": "10"
}

{
  "blocks": [
    "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  ]
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

delegators_count

POST

https://xno.nownodes.io/

Executes the Nano node RPC action delegators_count.

Body

application/json

actionstringdelegators_countrequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

delegators_count

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "delegators_count",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "delegators_count",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "delegators_count",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "delegators_count",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "success": ""
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

delegators

POST

https://xno.nownodes.io/

Executes the Nano node RPC action delegators.

Body

application/json

actionstringdelegatorsrequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

delegators

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "delegators",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "delegators",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "delegators",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "delegators",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "success": ""
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

frontier_count

POST

https://xno.nownodes.io/

Executes the Nano node RPC action frontier_count.

Body

application/json

actionstringfrontier_countrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

frontier_count

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "frontier_count"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "frontier_count"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "frontier_count"
}

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

Request Body

{
  "action": "frontier_count"
}

{
  "count": "1000000"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

frontiers

POST

https://xno.nownodes.io/

Executes the Nano node RPC action frontiers.

Body

application/json

actionstringfrontiersrequired

accountstringrequired

countstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

frontiers

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "frontiers",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "count": "10"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "frontiers",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
      "count": "10"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "frontiers",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
  "count": "10"
}

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

Request Body

{
  "action": "frontiers",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
  "count": "10"
}

{
  "frontiers": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

ledger

POST

https://xno.nownodes.io/

Executes the Nano node RPC action ledger.

Body

application/json

actionstringledgerrequired

accountstringrequired

countstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

ledger

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "ledger",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
    "count": "10"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "ledger",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
      "count": "10"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "ledger",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
  "count": "10"
}

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

Request Body

{
  "action": "ledger",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3",
  "count": "10"
}

{
  "accounts": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": {
      "frontier": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
      "open_block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
      "representative_block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
      "balance": "1000",
      "modified_timestamp": "1720000000",
      "block_count": "1"
    }
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

receivable_exists

POST

https://xno.nownodes.io/

Executes the Nano node RPC action receivable_exists.

Body

application/json

actionstringreceivable_existsrequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

receivable_exists

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "receivable_exists",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "receivable_exists",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "receivable_exists",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "receivable_exists",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "exists": "1"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

receivable

POST

https://xno.nownodes.io/

Executes the Nano node RPC action receivable.

Body

application/json

actionstringreceivablerequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

receivable

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "receivable",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "receivable",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "receivable",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "receivable",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "blocks": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": [
      "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
    ]
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

representatives_online

POST

https://xno.nownodes.io/

Executes the Nano node RPC action representatives_online.

Body

application/json

actionstringrepresentatives_onlinerequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

representatives_online

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "representatives_online"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "representatives_online"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "representatives_online"
}

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

Request Body

{
  "action": "representatives_online"
}

{
  "representatives": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": "1000000000000000000000000000000"
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

representatives

POST

https://xno.nownodes.io/

Executes the Nano node RPC action representatives.

Body

application/json

actionstringrepresentativesrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

representatives

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "representatives"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "representatives"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "representatives"
}

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

Request Body

{
  "action": "representatives"
}

{
  "representatives": {
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": "1000000000000000000000000000000"
  }
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

successors

POST

https://xno.nownodes.io/

Executes the Nano node RPC action successors.

Body

application/json

actionstringsuccessorsrequired

blockstringrequired

countstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

successors

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "successors",
    "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
    "count": "10"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "successors",
      "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
      "count": "10"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "successors",
  "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "count": "10"
}

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

Request Body

{
  "action": "successors",
  "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "count": "10"
}

{
  "blocks": [
    "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  ]
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

Node / Node

Node

Nano Node RPC methods

process

POST

https://xno.nownodes.io/

Executes the Nano node RPC action process.

Body

application/json

actionstringprocessrequired

hashstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

process

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "process",
    "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "process",
      "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "process",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

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

Request Body

{
  "action": "process",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

{
  "block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

telemetry

POST

https://xno.nownodes.io/

Executes the Nano node RPC action telemetry.

Body

application/json

actionstringtelemetryrequired

addressstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

telemetry

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "telemetry",
    "address": "::ffff:192.168.1.10"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "telemetry",
      "address": "::ffff:192.168.1.10"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "telemetry",
  "address": "::ffff:192.168.1.10"
}

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

Request Body

{
  "action": "telemetry",
  "address": "::ffff:192.168.1.10"
}

{
  "block_count": "180000000",
  "cemented_count": "179999000",
  "unchecked_count": "0",
  "account_count": "1000000",
  "bandwidth_cap": "10485760",
  "peer_count": "120",
  "protocol_version": "21",
  "uptime": "86400",
  "genesis_block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "major_version": "28",
  "minor_version": "0",
  "patch_version": "0",
  "pre_release_version": "0",
  "maker": "0",
  "timestamp": "1720000000000",
  "active_difficulty": "fffffff800000000"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

version

POST

https://xno.nownodes.io/

Executes the Nano node RPC action version.

Body

application/json

actionstringversionrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

version

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "version"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "version"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "version"
}

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

Request Body

{
  "action": "version"
}

{
  "rpc_version": "1",
  "store_version": "24",
  "protocol_version": "21",
  "node_vendor": "Nano V28.0",
  "store_vendor": "LMDB 0.9.31",
  "network": "live"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

Node / Utilities

Utilities

Nano Utilities RPC methods

nano_to_raw

POST

https://xno.nownodes.io/

Executes the Nano node RPC action nano_to_raw.

Body

application/json

actionstringnano_to_rawrequired

amountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

nano_to_raw

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "nano_to_raw",
    "amount": "1000000000000000000000000000000"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "nano_to_raw",
      "amount": "1000000000000000000000000000000"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "nano_to_raw",
  "amount": "1000000000000000000000000000000"
}

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

Request Body

{
  "action": "nano_to_raw",
  "amount": "1000000000000000000000000000000"
}

{
  "amount": "1000000000000000000000000000000"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

raw_to_nano

POST

https://xno.nownodes.io/

Executes the Nano node RPC action raw_to_nano.

Body

application/json

actionstringraw_to_nanorequired

amountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

raw_to_nano

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "raw_to_nano",
    "amount": "1000000000000000000000000000000"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "raw_to_nano",
      "amount": "1000000000000000000000000000000"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "raw_to_nano",
  "amount": "1000000000000000000000000000000"
}

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

Request Body

{
  "action": "raw_to_nano",
  "amount": "1000000000000000000000000000000"
}

{
  "amount": "1"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

validate_account_number

POST

https://xno.nownodes.io/

Executes the Nano node RPC action validate_account_number.

Body

application/json

actionstringvalidate_account_numberrequired

accountstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

validate_account_number

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "validate_account_number",
    "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "validate_account_number",
      "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "validate_account_number",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

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

Request Body

{
  "action": "validate_account_number",
  "account": "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
}

{
  "valid": "1"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

Node / Work

Work

Nano Work RPC methods

work_generate

POST

https://xno.nownodes.io/

Executes the Nano node RPC action work_generate.

Body

application/json

actionstringwork_generaterequired

hashstringrequired

difficultystringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

work_generate

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "work_generate",
    "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
    "difficulty": "fffffff800000000"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "work_generate",
      "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
      "difficulty": "fffffff800000000"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "work_generate",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "difficulty": "fffffff800000000"
}

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

Request Body

{
  "action": "work_generate",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "difficulty": "fffffff800000000"
}

{
  "work": "2bf29ef00786a6bc",
  "difficulty": "fffffff800000000",
  "multiplier": "1.0"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

work_validate

POST

https://xno.nownodes.io/

Executes the Nano node RPC action work_validate.

Body

application/json

actionstringwork_validaterequired

hashstringrequired

workstringrequired

Response

200OK

Successful Nano RPC response

400Bad Request

Invalid request

401Unauthorized

Missing or invalid API key

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Node or server error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

work_validate

curl -X POST 'https://xno.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "work_validate",
    "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
    "work": "2bf29ef00786a6bc"
  }'

const response = await fetch('https://xno.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "action": "work_validate",
      "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
      "work": "2bf29ef00786a6bc"
    }),
});

const data = await response.json();

import requests

payload = {
  "action": "work_validate",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "work": "2bf29ef00786a6bc"
}

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

Request Body

{
  "action": "work_validate",
  "hash": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "work": "2bf29ef00786a6bc"
}

{
  "valid_all": "1",
  "valid_receive": "1",
  "difficulty": "fffffff800000000",
  "multiplier": "1.0"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid request"
}

Documentation

Authentication

Node / Accounts

Accounts

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Node / Blocks

Blocks

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Node / Ledger

Ledger

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization