Arbitrum Node API - Debug Trace Block By Hash

v1.0.0

Base URLs

https://tao.nownodes.io

https://tao.nownodes.ioTAO RPC

https://tao.example.io

Returns the possible tracing result number by executing all transactions in the block specified by the block hash with a tracer

Authentication

api-keyAuthapiKey

API Key: api-key in header

DEBUG

debug_traceBlockByHash

Trace block by hash

POST

https://tao.nownodes.io/

Returns the possible tracing result number by executing all transactions in the block specified by the block hash with a tracer

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | object>required

Show child attributes

Any of

string

object

idintegerrequired

Response

200OK

Block transaction traces by hash

400Bad Request

Bad Request

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace block by hash

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceBlockByHash",
    "params": [
      "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
      {
        "tracer": "callTracer"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByHash",
  "params": [
    "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByHash",
  "params": [
    "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "type": "CALL",
      "from": "0x8894e0a0c962cb723c1976a4421c95949be2d4e3",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "value": "0x0",
      "gas": "0x30d40",
      "gasUsed": "0x7148",
      "input": "0xa9059cbb0000000000000000000000002c46b28e4bac6b0188baf722f17f5f36e217033000000000000000000000000000000000000000000000000058d15e176280000",
      "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
      "calls": [
        {
          "type": "STATICCALL",
          "from": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "to": "0x8894e0a0c962cb723c1976a4421c95949be2d4e3",
          "gas": "0x2e010",
          "gasUsed": "0x1388",
          "input": "0x70a08231000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "output": "0x0000000000000000000000000000000000000000000b56ea85ae38dd000000",
          "calls": [
            {}
          ]
        }
      ]
    }
  ]
}

debug_traceBlockByNumber

Trace block by number

POST

https://tao.nownodes.io/

Returns the tracing result by executing all transactions in the block specified by number with a tracer

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | object>required

Show child attributes

Any of

string

object

idintegerrequired

Response

200OK

Block transaction traces by number

400Bad Request

Bad Request

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace block by number

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceBlockByNumber",
    "params": [
      "0xccde12",
      {
        "tracer": "callTracer"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "params": [
    "0xccde12",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "params": [
    "0xccde12",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "type": "CALL",
      "from": "0x3b5b09d988ba5be25d130a6959a7e4dc5cad4578",
      "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
      "value": "0x2386f26fc10000",
      "gas": "0x55730",
      "gasUsed": "0x3d227",
      "input": "0x7ff36ab5000000000000000000000000000000000000000000000000000b8d442e2d8b000000000000000000000000000003b5b09d988ba5be25d130a6959a7e4dc5cad45780000000000000000000000000000000000000000000000000000000064a571e9",
      "output": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000002e90edd00000",
      "calls": [
        {
          "type": "CALL",
          "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
          "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "value": "0x2386f26fc10000",
          "gas": "0x12e04",
          "gasUsed": "0x8fc",
          "input": "0xd0e30db0",
          "output": "0x",
          "calls": [
            {}
          ]
        }
      ]
    }
  ]
}

debug_traceCall

Trace call execution

POST

https://tao.nownodes.io/

Returns the number of possible tracing result by executing an eth call within the context of the given block execution

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<object | string>required

Show child attributes

Any of

object

string

idintegerrequired

Response

200OK

Call execution trace

400Bad Request

Bad Request

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace call execution

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceCall",
    "params": [
      {
        "from": null,
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
      },
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "debug_traceCall",
      "params": [
        {
          "from": null,
          "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
        },
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_traceCall",
  "params": [
    {
      "from": None,
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
    },
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_traceCall",
  "params": [
    {
      "from": null,
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
    },
    "latest"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "failed": false,
    "gas": 24034,
    "returnValue": "0000000000000000000000000000000000000000000000000858898f93629000",
    "structLogs": [
      {
        "pc": 0,
        "op": "PUSH1",
        "gas": 599978568,
        "gasCost": 3,
        "depth": 1,
        "error": "string",
        "stack": [
          "string"
        ],
        "memory": [
          "string"
        ],
        "storage": {},
        "refund": 0
      }
    ]
  }
}

debug_traceTransaction

Trace transaction execution

POST

https://tao.nownodes.io/

Returns all traces of a given transaction

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | object>required

Show child attributes

Any of

string

object

idintegerrequired

Response

200OK

Transaction execution trace

400Bad Request

Bad Request

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace transaction execution

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceTransaction",
    "params": [
      "0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
      {
        "tracer": "callTracer"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_traceTransaction",
  "params": [
    "0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_traceTransaction",
  "params": [
    "0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "type": "CALL",
    "from": "0x688c1de81ce07a698679928ae319bbe503da1a5d",
    "to": "0xf15176bc2a8d95102e21641fc0c3b1a9990d2d2d",
    "value": "0x0",
    "gas": "0x226c9",
    "gasUsed": "0x1a529",
    "input": "0xaea01419000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000500000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000b7180b07bd1906c59af640bd8eeab367b7594f9af0fc90ecd5ebe7c0a1be8a4e536f3393fd943b12745241929d83318675e662c725c1ede53fcb3b8396277bf617b5839bd4d6e005d4dda81701f87378e34cb9cbd113c435db0c10ac07f2465579615210131a0c66381308e606e3b6da4a360285b8865010f14d3c3f92aa9043d6d48b0e6493b6b63887c0fbfe88c48d280c01cbf4df2a77a7221536436b02c0382ab5368bb19710ec9ba7bf6375faf6d4936e21152556361682e63b083f0b61402ac2171cc082861c603adf7e26abfc9c196e8fe07491088f1a887a8e2124e90f9b26afe29ac9f0c44594eb6ad83ce13fc4362fb86cd71e5d8133548a9ed2165d90a60b7959951ce31ebe733f8e648987339c66246b7dcab61eae5c6f95604a2133af90e4ee678878c0c249c07e4f3159c5e7bef52a67baf54e075715cc39b4795940b8f2632eabc4a68d61d83c4ed2a4b4a2a1d80da98ee8a74a0d497924866",
    "output": "string",
    "error": "string",
    "revertReason": "string",
    "calls": [
      {}
    ]
  }
}

EVM

eth_accounts

Ethereum method - eth_accounts

POST

https://tao.nownodes.io/

Returns an array of addresses controlled by the client.

Body

application/json

jsonrpcstringrequired

JSON-RPC version identifier

methodstringrequired

Name of the JSON-RPC method

paramsarrayrequired

No parameters are required for this method. This must be an empty array.

idintegerrequired

Unique identifier for the JSON-RPC request

Response

200OK

A list of Ethereum addresses

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_accounts

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  ]
}

eth_blockNumber

Ethereum method - eth_blockNumber

POST

https://tao.nownodes.io/

Returns the number of the latest block on the chain in hexadecimal format.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version

methodstringrequired

Name of the method being called

paramsarrayrequired

This method does not take parameters; always send an empty array.

idintegerrequired

A unique ID for the request

Response

200OK

The latest block number

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_blockNumber

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_call

Ethereum method - eth_call

POST

https://tao.nownodes.io/

Executes a call to a contract or address and returns the result without broadcasting a transaction.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<object | string>required

The first object specifies the call transaction object. The second (optional) parameter specifies the block context.

Show child attributes

One of

fromstring

Address the call is sent from (optional)

tostringrequired

Target address for the call (required)

gasstring

Gas provided for the call, as hex

gasPricestring

Gas price in wei, as hex

valuestring

Amount of ETH sent, as hex (optional)

datastring

Compiled contract method call data

(Optional) Integer block number, or the string "latest", "earliest", or "pending".

string

idintegerrequired

Response

200OK

Result of the call

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_call

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
      }
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_call",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

200

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

eth_chainId

Ethereum method - eth_chainId

POST

https://tao.nownodes.io/

Returns the hexadecimal string of the current chain ID.

Body

application/json

jsonrpcstringrequired

JSON-RPC protocol version

methodstringrequired

Name of the method to call

paramsarrayrequired

This method does not require parameters. Use an empty array.

idintegerrequired

Unique identifier for the request

Response

200OK

Chain ID response

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_chainId

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_estimateGas

Estimate Gas for Transaction

POST

https://tao.nownodes.io/

Simulates a transaction and returns an estimate of how much gas would be used.

Body

application/json

jsonrpcstringrequired

JSON-RPC protocol version

methodstringrequired

The method name

paramsArray<object | string>required

The transaction call object and an optional block tag.

Show child attributes

One of

fromstring

Address the transaction is sent from (optional)

tostringrequired

Destination address of the call

gasstring

Gas limit provided for execution (optional)

gasPricestring

Gas price in wei (optional)

valuestring

Amount of ETH to send, in hexadecimal wei (optional)

datastring

The compiled input data for the transaction (optional)

Optional block tag (e.g., "latest", "earliest", or a block number)

string

idintegerrequired

Request identifier

Response

200OK

Estimated gas amount

Authorization

api-keyAuthapiKey in header

Estimate Gas for Transaction

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_estimateGas",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_estimateGas",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

200

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

eth_gasPrice

Get Suggested Gas Price

POST

https://tao.nownodes.io/

Returns the current gas price in wei as a hexadecimal string. This value is a node estimate based on recent blocks and mempool activity.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsarrayrequired

This method takes an empty array.

idintegerrequired

Request identifier

Response

200OK

Suggested gas price in wei

Authorization

api-keyAuthapiKey in header

Get Suggested Gas Price

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_getBalance

Get ETH Balance of an Address

POST

https://tao.nownodes.io/

Retrieves the balance (in wei) of a given Ethereum address. You can specify the block parameter to get the balance at a specific block.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array with 2 parameters:

Address (20-byte hex string with '0x' prefix)
Block tag (e.g., 'latest', 'earliest', 'pending', or block number in hex)

idintegerrequired

Request ID

Response

200OK

Balance (in wei) as hex string

Authorization

api-keyAuthapiKey in header

Get ETH Balance of an Address

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

200

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

eth_getBlockByHash

Get Block by Hash

POST

https://tao.nownodes.io/

Returns the block information for the specified block hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

Block hash (string)
Boolean flag — if true, return full transactions; if false, only hashes.

idintegerrequired

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

Get Block by Hash

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x1b4",
    "hash": "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79",
    "parentHash": "0x5e8d5f58b0c1be8c3a3d172a41f9f4e35f2f15d5b3347f17a6c11a3aeadf9c10",
    "nonce": "0x0000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd7f8974fb5ac78d9e7a6ccfbcc2fdb5d98a9fdb716e0df485b4d39a5a6f85ebd",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "miner": "0x829BD824B016326A401d083B33D092293333A830",
    "difficulty": "0x027f07",
    "totalDifficulty": "0x027f07",
    "extraData": "0x",
    "size": "0x027f07",
    "gasLimit": "0x9f759",
    "gasUsed": "0x9f759",
    "timestamp": "0x54e34e8e",
    "transactions": [
      "0x9f1c04b814a153e1b9f11b60d4e0f9349d07f9251e9b7b60aebb21721c8c07d7"
    ],
    "uncles": [
      "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347"
    ]
  }
}

eth_getBlockByNumber

Get Block by Number

POST

https://tao.nownodes.io/

Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

Block number (hex string, e.g., "0x1b4") or special tags ("latest", "earliest", "pending")
Boolean flag — if true, return full transactions; if false, only hashes.

idintegerrequired

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

Get Block by Number

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "0x1b4",
    false
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "0x1b4",
    false
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x1b4",
    "hash": "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79",
    "parentHash": "0x5e8d5f58b0c1be8c3a3d172a41f9f4e35f2f15d5b3347f17a6c11a3aeadf9c10",
    "nonce": "0x0000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd7f8974fb5ac78d9e7a6ccfbcc2fdb5d98a9fdb716e0df485b4d39a5a6f85ebd",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "miner": "0x829BD824B016326A401d083B33D092293333A830",
    "difficulty": "0x027f07",
    "totalDifficulty": "0x027f07",
    "extraData": "0x",
    "size": "0x027f07",
    "gasLimit": "0x9f759",
    "gasUsed": "0x9f759",
    "timestamp": "0x54e34e8e",
    "transactions": [
      "0x9f1c04b814a153e1b9f11b60d4e0f9349d07f9251e9b7b60aebb21721c8c07d7"
    ],
    "uncles": [
      "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347"
    ]
  }
}

eth_getBlockReceipts

Get All Transaction Receipts for a Block

POST

https://tao.nownodes.io/

Returns an array of transaction receipts for every transaction in the block specified by block number or block hash.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

One parameter:

Block identifier, which can be either:
- block number as hex string (e.g. "0x10d4f")
- or block hash as hex string (0x-prefixed)

idintegerrequired

Request identifier

Response

200OK

Array of transaction receipts in the block

Authorization

api-keyAuthapiKey in header

Get All Transaction Receipts for a Block

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockReceipts",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "transactionHash": "0x5f4e3b4f5c4c4a6a93c2a3c9d1f47ee7e54b1f4e8a8e0cfd3aabb8a7a8295f7a",
      "transactionIndex": "0x1",
      "blockHash": "0xabc123def456...",
      "blockNumber": "0x10d4f",
      "from": "0x1234567890abcdef1234567890abcdef12345678",
      "to": "0xabcdefabcdefabcdefabcdefabcdefabcdef",
      "cumulativeGasUsed": "0x5208",
      "gasUsed": "0x5208",
      "contractAddress": "0xcontractaddresshere",
      "logs": [
        {
          "removed": false,
          "logIndex": "0x0",
          "transactionIndex": "0x1",
          "transactionHash": "0x5f4e3b4f5c4c4a6a93c2a3c9d1f47ee7e54b1f4e8a8e0cfd3aabb8a7a8295f7a",
          "blockHash": "0xabc123def456...",
          "blockNumber": "0x10d4f",
          "address": "0xcontractaddresshere",
          "data": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
          ]
        }
      ],
      "status": "0x1",
      "root": "0x..."
    }
  ]
}

eth_getBlockTransactionCountByHash

Get Transaction Count by Block Hash

POST

https://tao.nownodes.io/

Returns the number of transactions contained in the block with the given hash.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array containing a single parameter:

Block hash as a hex string (32 bytes with 0x prefix)

idintegerrequired

Request ID

Response

200OK

Number of transactions in the block

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByHash",
  "params": [
    "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79"
  ],
  "id": 1
}

200

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

eth_getBlockTransactionCountByNumber

Get Transaction Count by Block Number

POST

https://tao.nownodes.io/

Returns the number of transactions contained in the block with the given block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array containing a single parameter:

Block number as a hex string (e.g. "0x10d4f" for block 69007) or
predefined block tags such as "latest", "earliest", or "pending"

idintegerrequired

Request ID

Response

200OK

Number of transactions in the block

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Number

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

200

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

eth_getCode

Get Contract Bytecode at Address

POST

https://tao.nownodes.io/

Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".

Body

application/json

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with two elements:

The address to get the code for (hex string, 0x-prefixed).
The block number or block tag (e.g., "latest", "earliest", "pending").

idintegerrequired

Request identifier.

Response

200OK

Contract bytecode in hex format

Authorization

api-keyAuthapiKey in header

Get Contract Bytecode at Address

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x6080604052348015600f57600080fd5b5060..."
}

eth_getFilterChanges

Get Filter Changes

POST

https://tao.nownodes.io/

Returns an array of logs that occurred since the last poll for the specified filter ID. The filter must have been previously created with eth_newFilter or eth_newBlockFilter or eth_newPendingTransactionFilter.

Body

application/json

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with a single element:

The filter ID (hex string).

idintegerrequired

Request identifier.

Response

200OK

Array of log objects or transaction hashes depending on filter type

Authorization

api-keyAuthapiKey in header

Get Filter Changes

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getFilterChanges",
  "params": [
    "0x16"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000000003e8",
      "blockNumber": "0x1b4",
      "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "transactionIndex": "0x0",
      "blockHash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

eth_getFilterLogs

Get Filter Logs

POST

https://tao.nownodes.io/

Returns all logs matching a filter with the specified filter ID. The filter must have been previously created with eth_newFilter.

Body

application/json

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with one element:

The filter ID (hex string).

idintegerrequired

Request identifier.

Response

200OK

Array of log objects matching the filter

Authorization

api-keyAuthapiKey in header

Get Filter Logs

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getFilterLogs",
  "params": [
    "0x16"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000000003e8",
      "blockNumber": "0x1b4",
      "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "transactionIndex": "0x0",
      "blockHash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

eth_getLogs

Get Logs

POST

https://tao.nownodes.io/

Returns an array of logs that match the filter criteria specified in the params. The filter object supports filtering by block range, addresses, and topics.

Body

application/json

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Parameters array with one element: the filter object.

Show child attributes

fromBlockstring

Starting block number (hex string) or "earliest", "latest", "pending".

toBlockstring

Ending block number (hex string) or "earliest", "latest", "pending".

addressstring | Array<string>

Contract address or list of addresses from which logs should originate.

topicsarray

Array of topic filters. Each topic can be a string, null, or an array of strings for OR filtering.

idintegerrequired

Request identifier.

Response

200OK

Array of log objects matching the filter

Authorization

api-keyAuthapiKey in header

Get Logs

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "fromBlock": "0x1b4",
        "toBlock": "0x1f4",
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          null,
          [
            "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
            "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
          ]
        ]
      }
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getLogs",
      "params": [
        {
          "fromBlock": "0x1b4",
          "toBlock": "0x1f4",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            null,
            [
              "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
              "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
            ]
          ]
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000000003e8",
      "blockNumber": "0x1b4",
      "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "transactionIndex": "0x0",
      "blockHash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

eth_getStorageAt

Get Storage At

POST

https://tao.nownodes.io/

Returns the value stored at position in the storage of the contract at address at the given blockNumber.

Body

application/json

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array:

address: string - Contract address to query storage from.
position: string - Storage slot position (hex string).
block number: string - Block number or keywords ("latest", "earliest", "pending").

idintegerrequired

Request identifier.

Response

200OK

Storage slot value at the specified position

Authorization

api-keyAuthapiKey in header

Get Storage At

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getStorageAt",
    "params": [
      "0x1234567890abcdef1234567890abcdef12345678",
      "0x0",
      "latest"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "0x0",
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "0x0",
    "latest"
  ],
  "id": 1
}

200

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

eth_getTransactionByBlockHashAndIndex

Get Transaction by Block Hash and Index

POST

https://tao.nownodes.io/

Retrieves the transaction from a block using the block's hash and the transaction's index position within the block.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Parameters:

blockHash (string): The 32-byte hash of the block.
transactionIndex (string): The transaction index (hex).

idintegerrequired

Response

200OK

A transaction object or null if no transaction was found.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Hash and Index

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockHashAndIndex",
  "params": [
    "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "0x0"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "blockNumber": "0x5daf3b",
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "gas": "0x5208",
    "gasPrice": "0x4a817c800",
    "hash": "0x3f1c...",
    "input": "0x",
    "nonce": "0x15",
    "to": "0x85h1c2d44cf8531a24b1030f78134677856f7b9f",
    "transactionIndex": "0x0",
    "value": "0x7f110",
    "type": "0x0"
  }
}

eth_getTransactionByBlockNumberAndIndex

Get Transaction by Block Number and Index

POST

https://tao.nownodes.io/

Returns the information about a transaction using the block number and the transaction index within the block.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Parameters:

Block number in hex format (e.g., "0x5daf3b")
Transaction index in the block (e.g., "0x0")

idintegerrequired

Response

200OK

A transaction object, or null if not found.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Number and Index

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72",
    "nonce": "0x15",
    "blockHash": "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "blockNumber": "0x5daf3b",
    "transactionIndex": "0x0",
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0x85h1c2d44cf8531a24b1030f78134677856f7b9f",
    "value": "0x7f110",
    "gas": "0x5208",
    "gasPrice": "0x4a817c800",
    "input": "0x",
    "type": "0x0"
  }
}

eth_getTransactionByHash

Get transaction by hash

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Array containing a single transaction hash

idintegerrequired

Response

200OK

Transaction object or null

Authorization

api-keyAuthapiKey in header

Get transaction by hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByHash",
  "params": [
    "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72",
    "nonce": "0x15",
    "blockHash": "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "blockNumber": "0x5daf3b",
    "transactionIndex": "0x0",
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0x85h1c2d44cf8531a24b1030f78134677856f7b9f",
    "value": "0x7f110",
    "gas": "0x5208",
    "gasPrice": "0x4a817c800",
    "input": "0x",
    "type": "0x0"
  }
}

eth_getTransactionCount

Get transaction count (nonce) for address

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

address: The address to check for transaction count.
block: The block parameter (e.g., "latest", "earliest", "pending").

idintegerrequired

Response

200OK

Hex encoded nonce (transaction count)

Authorization

api-keyAuthapiKey in header

Get transaction count (nonce) for address

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x742d35cc6634c0532925a3b844bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x742d35cc6634c0532925a3b844bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

200

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

eth_getTransactionReceipt

Get transaction receipt by hash

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

idintegerrequired

Response

200OK

Transaction receipt if mined, otherwise null

Authorization

api-keyAuthapiKey in header

Get transaction receipt by hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": [
    "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "transactionHash": "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7",
    "transactionIndex": "0x0",
    "blockHash": "0x9b559a...",
    "blockNumber": "0x5daf3b",
    "from": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
    "to": "0x53d284357ec70ce289d6d64134dfac8e511c8a3d",
    "cumulativeGasUsed": "0x5208",
    "gasUsed": "0x5208",
    "contractAddress": null,
    "logs": [],
    "logsBloom": "0x000...",
    "status": "0x1"
  }
}

eth_getUncleByBlockHashAndIndex

Get uncle block by block hash and index

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

blockHash: 32-byte block hash
index: the uncle index as hex (e.g., "0x0" for the first uncle)

idintegerrequired

Response

200OK

Uncle block object or null

Authorization

api-keyAuthapiKey in header

Get uncle block by block hash and index

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockHashAndIndex",
  "params": [
    "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
    "0x0"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockHashAndIndex",
  "params": [
    "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
    "0x0"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x5daf3c",
    "hash": "0xabc123...",
    "parentHash": "0xdef456...",
    "miner": "0x1234567890abcdef1234567890abcdef12345678",
    "difficulty": "0x3e8",
    "totalDifficulty": "0x1d4c",
    "extraData": "0x",
    "size": "0x220",
    "gasLimit": "0x7a1200",
    "gasUsed": "0x5208",
    "timestamp": "0x5bad55",
    "transactions": []
  }
}

eth_getUncleByBlockNumberAndIndex

Get uncle block by block number and index

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

blockNumber: The block number as hex string (e.g., "0x10fb78"), or "latest", "earliest", "pending".
index: The uncle index as hex (e.g., "0x0" for the first uncle).

idintegerrequired

Response

200OK

Uncle block object or null

Authorization

api-keyAuthapiKey in header

Get uncle block by block number and index

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x5daf3c",
    "hash": "0xabc123abc123abc123abc123abc123abc123abc123abc123abc123abc123abc1",
    "parentHash": "0xdef456def456def456def456def456def456def456def456def456def456def4",
    "miner": "0x1234567890abcdef1234567890abcdef12345678",
    "difficulty": "0x3e8",
    "totalDifficulty": "0x1d4c",
    "extraData": "0x",
    "size": "0x220",
    "gasLimit": "0x7a1200",
    "gasUsed": "0x5208",
    "timestamp": "0x5bad55",
    "transactions": []
  }
}

eth_getUncleCountByBlockHash

Get the number of uncle blocks by block hash

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

An array containing the block hash.

idintegerrequired

Response

200OK

Number of uncles in the block

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockHash",
  "params": [
    "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
  ],
  "id": 1
}

200

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

eth_getUncleCountByBlockNumber

Get the number of uncle blocks by block number

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

An array containing the block number as a hex string.

idintegerrequired

Response

200OK

Number of uncle blocks in the block

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block number

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockNumber",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

200

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

eth_maxPriorityFeePerGas

Get recommended maxPriorityFeePerGas value

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsarrayrequired

No parameters are required.

idintegerrequired

Response

200OK

Returns the suggested maxPriorityFeePerGas value

Authorization

api-keyAuthapiKey in header

Get recommended maxPriorityFeePerGas value

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_newBlockFilter

Create a new block filter

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<any>required

This method does not require any parameters.

idintegerrequired

Response

200OK

Filter ID created successfully

Authorization

api-keyAuthapiKey in header

Create a new block filter

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_newFilter

Create a new log filter

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<object>required

Array with one object describing the filter options.

Show child attributes

fromBlockstring

Starting block number or tag ("latest", "earliest", "pending").

toBlockstring

Ending block number or tag.

addressstring | Array<string> | null

topicsArray<string | Array<string>> | null

Array of topic filters. Topics are 32-byte hashes identifying events.

Show child attributes

One of

string

Array<string>

idintegerrequired

Response

200OK

Filter ID created successfully

Authorization

api-keyAuthapiKey in header

Create a new log filter

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newFilter",
    "params": [
      {
        "fromBlock": "latest",
        "toBlock": "latest",
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "topics": [
          "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
        ]
      }
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_newFilter",
      "params": [
        {
          "fromBlock": "latest",
          "toBlock": "latest",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "topics": [
            "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
          ]
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_newFilter",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      ]
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_newFilter",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      ]
    }
  ],
  "id": 1
}

200

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

eth_newPendingTransactionFilter

Create a filter for pending transactions

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<any>required

No parameters required for this method

idintegerrequired

Request identifier

Response

200OK

Filter ID created successfully

Authorization

api-keyAuthapiKey in header

Create a filter for pending transactions

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_sendRawTransaction

Send a raw signed transaction

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

paramsArray<string>required

Array containing a single signed transaction data (hex string)

idintegerrequired

Request ID

Response

200OK

Transaction successfully sent

Authorization

api-keyAuthapiKey in header

Send a raw signed transaction

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [
    "0xf86b808504a817c800825208940000000000000000000000000000000000000000880de0b6b3a76400008026a0c6a6..."
  ],
  "id": 1
}

200

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

eth_sendTransaction

Send a transaction using node-managed account

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<object>required

Transaction object

Show child attributes

fromstring

Address the transaction is sent from

tostring

Address the transaction is directed to

gasstring

Gas provided for the transaction (hex)

gasPricestring

Gas price in wei (hex)

valuestring

Value sent with the transaction in wei (hex)

datastring

(Optional) Data for contract interaction

idintegerrequired

Response

200OK

Transaction successfully sent

Authorization

api-keyAuthapiKey in header

Send a transaction using node-managed account

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendTransaction",
    "params": [
      {
        "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
        "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "gas": "0x5208",
        "gasPrice": "0x3b9aca00",
        "value": "0x16345785d8a0000",
        "data": "0x"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sendTransaction",
      "params": [
        {
          "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
          "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "gas": "0x5208",
          "gasPrice": "0x3b9aca00",
          "value": "0x16345785d8a0000",
          "data": "0x"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_sendTransaction",
  "params": [
    {
      "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
      "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "gas": "0x5208",
      "gasPrice": "0x3b9aca00",
      "value": "0x16345785d8a0000",
      "data": "0x"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendTransaction",
  "params": [
    {
      "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
      "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "gas": "0x5208",
      "gasPrice": "0x3b9aca00",
      "value": "0x16345785d8a0000",
      "data": "0x"
    }
  ],
  "id": 1
}

200

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

eth_sign

Sign arbitrary data using eth_sign

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

[address, data]

address: The account that will sign the data
data: The data to be signed (must be a hex string)

idintegerrequired

Response

200OK

Returns the signature of the message

Authorization

api-keyAuthapiKey in header

Sign arbitrary data using eth_sign

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sign",
  "params": [
    "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
    "0x68656c6c6f20776f726c64"
  ],
  "id": 1
}

200

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

eth_signTransaction

POST

https://tao.nownodes.io/

Signs a transaction locally with the private key of the specified account.

Body

application/json

jsonrpcstringrequired

methodstringeth_signTransactionrequired

paramsArray<object>required

Array with a single object representing the transaction to sign.

Show child attributes

fromstringrequired

The address of the account that will sign the transaction.

tostring

The destination address of the transaction.

gasstring

Gas limit for the transaction, as a hex string.

gasPricestring

Gas price in wei, as a hex string.

valuestring

Amount of wei to send, as a hex string.

datastring

Data payload of the transaction, hex encoded.

noncestring

Nonce of the transaction, as a hex string.

chainIdinteger

The chain ID to protect against replay attacks.

idintegerrequired

Response

200OK

JSON-RPC response with the signed transaction data

Authorization

api-keyAuthapiKey in header

eth_signTransaction

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_signTransaction",
    "params": [
      {
        "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
        "gas": "0x5208",
        "gasPrice": "0x4a817c800",
        "value": "0xde0b6b3a7640000",
        "data": "0x",
        "nonce": "0x1",
        "chainId": 1
      }
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_signTransaction",
      "params": [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
          "gas": "0x5208",
          "gasPrice": "0x4a817c800",
          "value": "0xde0b6b3a7640000",
          "data": "0x",
          "nonce": "0x1",
          "chainId": 1
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

200

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

eth_syncing

Check if node is syncing

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsarrayrequired

Must be an empty array.

idintegerrequired

Response

200OK

Returns sync status object or false

Authorization

api-keyAuthapiKey in header

Check if node is syncing

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "startingBlock": "0x384",
    "currentBlock": "0x386",
    "highestBlock": "0x454"
  }
}

eth_uninstallFilter

Uninstall an existing filter

POST

https://tao.nownodes.io/

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

idintegerrequired

Response

200OK

Success or failure of the uninstall operation

Authorization

api-keyAuthapiKey in header

Uninstall an existing filter

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_uninstallFilter",
  "params": [
    "0x16"
  ],
  "id": 1
}

200

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

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

net_listening

POST

https://tao.nownodes.io/

Checks if the client is listening for network connections.

Body

application/json

jsonrpcstringrequired

methodstringnet_listeningrequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with listening status

Authorization

api-keyAuthapiKey in header

net_listening

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

net_peerCount

POST

https://tao.nownodes.io/

Returns the number of peers currently connected to the client.

Body

application/json

jsonrpcstringrequired

methodstringnet_peerCountrequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the number of connected peers

Authorization

api-keyAuthapiKey in header

net_peerCount

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

net_version

POST

https://tao.nownodes.io/

Returns the current network ID of the Ethereum client.

Body

application/json

jsonrpcstringrequired

methodstringnet_versionrequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the current network ID

Authorization

api-keyAuthapiKey in header

net_version

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

web3_clientVersion

POST

https://tao.nownodes.io/

Returns the current Ethereum client version.

Body

application/json

jsonrpcstringrequired

methodstringweb3_clientVersionrequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the client version string

Authorization

api-keyAuthapiKey in header

web3_clientVersion

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "Geth/v1.10.8-stable-26675454/linux-amd64/go1.16.6"
}

web3_sha3

POST

https://tao.nownodes.io/

Computes the Keccak-256 (SHA-3) hash of the given hex-encoded data.

Body

application/json

jsonrpcstringrequired

methodstringweb3_sha3required

paramsArray<string>required

Array containing a single hex-encoded data string to hash.

idintegerrequired

Response

200OK

JSON-RPC response with the Keccak-256 hash of the input data

Authorization

api-keyAuthapiKey in header

web3_sha3

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "web3_sha3",
  "params": [
    "0x68656c6c6f"
  ],
  "id": 1
}

200

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

JSON-RPC

author

Submit a fully formatted extrinsic

POST

https://tao.nownodes.io/author_submitExtrinsic

Sends a fully formatted extrinsic to the chain for processing.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing the encoded extrinsic

Response

200OK

Extrinsic submission result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Submit a fully formatted extrinsic

curl -X POST 'https://tao.nownodes.io/author_submitExtrinsic' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "author_submitExtrinsic",
    "params": [
      "0x...extrinsic"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitExtrinsic",
  "params": [
    "0x...extrinsic"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitExtrinsic",
  "params": [
    "0x...extrinsic"
  ]
}

200

{
  "jsonrpc": "2.0",
  "error": {
    "code": 1002,
    "message": "Verification Error: invalid signature"
  },
  "id": "test"
}

Submit and subscribe to an extrinsic until unsubscribed

POST

https://tao.nownodes.io/author_submitAndWatchExtrinsic

Submits an extrinsic and allows monitoring its status until it is finalized or unsubscribed.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing the encoded extrinsic

Response

200OK

Extrinsic submission and watch result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Submit and subscribe to an extrinsic until unsubscribed

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitAndWatchExtrinsic",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitAndWatchExtrinsic",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "extrinsicHash": "0x123456789abcdef...7890",
    "status": {
      "Finalized": "0xabc123blockhash..."
    }
  },
  "id": "test"
}

Retrieve all pending extrinsics

POST

https://tao.nownodes.io/author_pendingExtrinsics

Returns a list of all pending extrinsics, optionally grouped by sender.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

List of pending extrinsics

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve all pending extrinsics

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_pendingExtrinsics",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_pendingExtrinsics",
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "result": [
    "0x5d028400bc47b8533..."
  ],
  "id": "test"
}

chain

Get the hash of the last finalized block

POST

https://tao.nownodes.io/chain_getFinalizedHead

Returns the hash of the block that was finalized on the chain.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Method parameters (empty array)

Response

200OK

Hash of the last finalized block

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get the hash of the last finalized block

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getFinalizedHead",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getFinalizedHead",
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "result": "0xb0e62ed11652d7562cb63598140c5eb7ac4f2086f0970334ce8472d403c66e1f",
  "id": "test"
}

Get block by hash

POST

https://tao.nownodes.io/chain_getBlock

Returns full information of a block, including header, extrinsics, and digest.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing block hash to retrieve

Response

200OK

Full block details

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block by hash

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlock",
  "params": [
    "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlock",
  "params": [
    "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block": {
      "header": {
        "parentHash": "0xd1b678077a900e1b03747ba5ade6c47960fe7ead346c8722289dbc3d9f1c9dc9",
        "number": "0x160303a",
        "stateRoot": "0x53e1c568f798214ff4406c8db027e4e05a1bc30c486ed391ebd0263ce74f3dc2",
        "extrinsicsRoot": "0xa4afa163cf63cc5851f7af044db5d25bc0229aa44645aadb1d98f9ec87f5ce63",
        "digest": {
          "logs": []
        }
      },
      "extrinsics": []
    },
    "justifications": null
  },
  "id": "test"
}

Get block hash by block number

POST

https://tao.nownodes.io/chain_getBlockHash

Returns the block hash using the block number in the chain.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<integer>required

Array containing block number

Response

200OK

Block hash by block number

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block hash by block number

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlockHash",
  "params": [
    20440517
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlockHash",
  "params": [
    20440517
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0x1e2dc73f800f496f8fc2e1ab3e8b8037267546cf24198b0c6e5a7b87e8b38320",
  "id": "test"
}

payment

Retrieve fee information for an encoded extrinsic

POST

https://tao.nownodes.io/payment_queryInfo

Returns detailed fee information (weight, partial fee, etc.) for a given encoded extrinsic.

Body

application/json

JSON-RPC request containing encoded extrinsic

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing encoded extrinsic(s) to query fee info for

Response

200OK

Fee information for the extrinsic

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve fee information for an encoded extrinsic

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "payment_queryInfo",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "payment_queryInfo",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "weight": 12345678,
    "partialFee": "1000000000000"
  },
  "id": "test"
}

state

Retrieve storage for a given key

POST

https://tao.nownodes.io/state_getStorage

Returns the value stored under a specific key at the latest block or a given block.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing storage keys

Response

200OK

Returns the value stored at the specified key

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve storage for a given key

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorage",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorage",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0xf08af92e88010000",
  "id": "test"
}

Get the runtime version

POST

https://tao.nownodes.io/state_getRuntimeVersion

Returns version information about the runtime, including spec version, implementation version, and transaction version.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

Runtime version information

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get the runtime version

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getRuntimeVersion",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getRuntimeVersion",
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "specName": "kusama",
    "implName": "parity-kusama",
    "authoringVersion": 2,
    "specVersion": 1002000,
    "implVersion": 0,
    "transactionVersion": 25,
    "stateVersion": 1
  },
  "id": "test"
}

Retrieve runtime metadata

POST

https://tao.nownodes.io/state_getMetadata

Returns the runtime metadata, which includes information about modules, calls, storage, and events.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

Runtime metadata in hex format

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve runtime metadata

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getMetadata",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getMetadata",
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "result": "0x6e74696d653e000500485472616e73616374696f6e5061796d656e74...",
  "id": "test"
}

Returns proof of storage entries at a specific block state

POST

https://tao.nownodes.io/state_getReadProof

Provides a cryptographic proof for the existence and content of storage entries at a given block.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

List of storage keys for which to generate proof

Response

200OK

Proof of storage entries

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Returns proof of storage entries at a specific block state

curl -X POST 'https://tao.nownodes.io/state_getReadProof' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_getReadProof",
    "params": [
      "keys: Vec<StorageKey>"
    ]
  }'

const response = await fetch('https://tao.nownodes.io/state_getReadProof', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "test",
      "method": "state_getReadProof",
      "params": [
        "keys: Vec<StorageKey>"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getReadProof",
  "params": [
    "keys: Vec<StorageKey>"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getReadProof",
  "params": [
    "keys: Vec<StorageKey>"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "at": "0xabc123blockhash...",
    "proof": [
      "0xproofdata1...",
      "0xproofdata2..."
    ]
  },
  "id": "test"
}

Retrieves the storage hash

POST

https://tao.nownodes.io/state_getStorageHash

Returns the hash of the storage value stored under a specific key.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

Storage key(s) to compute hash

Response

200OK

Storage hash result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieves the storage hash

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageHash",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageHash",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0xabc123def4567890...",
  "id": "test"
}

Retrieves the storage size

POST

https://tao.nownodes.io/state_getStorageSize

Returns the size in bytes of the storage value under a specific key.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

Storage key(s) to measure

Response

200OK

Storage size result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieves the storage size

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageSize",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageSize",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0x0000000000000032",
  "id": "test"
}

Query historical storage entries

POST

https://tao.nownodes.io/state_queryStorage

Returns the storage changes between two blocks for a set of keys.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

List of storage keys and block range

Response

200OK

Query storage result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Query historical storage entries

curl -X POST 'https://tao.nownodes.io/state_queryStorage' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_queryStorage",
    "params": [
      "StorageKeys",
      "fromBlock",
      "toBlock"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorage",
  "params": [
    "StorageKeys",
    "fromBlock",
    "toBlock"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorage",
  "params": [
    "StorageKeys",
    "fromBlock",
    "toBlock"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block": "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4",
    "changes": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7",
        "0x0000000000000000000000000000000000000000000000000000000000000000"
      ]
    ]
  },
  "id": "test"
}

Query storage entries at a specific block

POST

https://tao.nownodes.io/state_queryStorageAt

Returns the storage values for given keys at a specified block hash.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

List of storage keys and block hash

Response

200OK

Storage entries at block

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Query storage entries at a specific block

curl -X POST 'https://tao.nownodes.io/state_queryStorageAt' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_queryStorageAt",
    "params": [
      "StorageKeys",
      "fromBlock"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorageAt",
  "params": [
    "StorageKeys",
    "fromBlock"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorageAt",
  "params": [
    "StorageKeys",
    "fromBlock"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7",
      "0x0000000000000000000000000000000000000000000000000000000000000000"
    ]
  ],
  "id": "test"
}

system

Retrieve the name of the chain

POST

https://tao.nownodes.io/system_chain

Returns the network name (e.g., Kusama, Polkadot) the node is connected to.

Body

application/json

JSON-RPC request to get chain name

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Should be empty for this method

Response

200OK

Chain name

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve the name of the chain

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "system_chain",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "system_chain",
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "result": "Kusama",
  "id": "test"
}

Retrieve custom properties from chain spec

POST

https://tao.nownodes.io/system_properties

Returns chain-specific properties such as token symbol, decimals, and address format.

Body

application/json

JSON-RPC request to get system properties

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Should be empty for this method

Response

200OK

System properties of the chain

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve custom properties from chain spec

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "system_properties",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "system_properties",
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "ss58Format": 2,
    "tokenDecimals": 12,
    "tokenSymbol": "KSM"
  },
  "id": "test"
}

NODE

chainHeadV1Body

chainHead_v1_body

POST

https://tao.nownodes.io/

Fetches the body of a chain head block using two hex parameters.

Body

application/json

jsonrpcstringrequired

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

methodstringchainHead_v1_bodyrequired

The RPC method to invoke.

paramsArray<string>required

Array containing two hex-encoded string parameters: the first is typically a block hash, the second may be a secondary identifier or nonce.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the block body or status.

Authorization

api-keyAuthapiKey in header

chainHead_v1_body

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chainHead_v1_body",
  "params": [
    "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
    "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "chainHead_v1_body",
  "params": [
    "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
    "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102"
  ],
  "id": 1
}

200

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

chainHeadV1Call

chainHead_v1_call

POST

https://tao.nownodes.io/

Calls a runtime method against the state at a specific block identified by two hex hashes.

Body

application/json

jsonrpcstringrequired

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

methodstringchainHead_v1_callrequired

The RPC method to invoke.

paramsArray<string>required

Array containing four positional parameters: - first hex string (e.g., block hash) - second hex string (e.g., a sub-identifier) - method name (e.g., "Core_version") - hex-encoded call data (often "0x" for simple calls)

idintegerrequired

Request identifier.

Response

200OK

Successful response with the result of the runtime call.

Authorization

api-keyAuthapiKey in header

chainHead_v1_call

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chainHead_v1_call",
    "params": [
      "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
      "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102",
      "Core_version",
      "0x"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chainHead_v1_call",
  "params": [
    "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
    "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102",
    "Core_version",
    "0x"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "chainHead_v1_call",
  "params": [
    "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
    "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102",
    "Core_version",
    "0x"
  ],
  "id": 1
}

200

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

chainHeadV1Continue

chainHead_v1_continue

POST

https://tao.nownodes.io/

Continues an active chain head subscription.

Body

application/json

jsonrpcstringrequired

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

methodstringchainHead_v1_continuerequired

The RPC method to invoke.

paramsArray<string>required

Array containing two string parameters: the follow_id (subscription identifier) and the operation_id.

idintegerrequired

Request identifier.

Response

200OK

Successful continuation; no data is returned.

Authorization

api-keyAuthapiKey in header

chainHead_v1_continue

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chainHead_v1_continue",
  "params": [
    "follow_id",
    "operation_id"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "chainHead_v1_continue",
  "params": [
    "follow_id",
    "operation_id"
  ],
  "id": 1
}

200

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

chainHeadV1Header

chainHead_v1_header

POST

https://tao.nownodes.io/

Fetches the header of a chain head block using two hex parameters.

Body

application/json

jsonrpcstringrequired

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

methodstringchainHead_v1_headerrequired

The RPC method to invoke.

paramsArray<string>required

Array containing two hex-encoded string parameters: typically a block hash and a secondary identifier.

idintegerrequired

Request identifier.

Response

200OK

Successful response; typically null when data is not immediately available.

Authorization

api-keyAuthapiKey in header

chainHead_v1_header

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chainHead_v1_header",
  "params": [
    "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
    "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "chainHead_v1_header",
  "params": [
    "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
    "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102"
  ],
  "id": 1
}

200

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

chainHeadV1StopOperation

chainHead_v1_stopOperation

POST

https://tao.nownodes.io/

Stops an active chain head operation.

Body

application/json

jsonrpcstringrequired

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

methodstringchainHead_v1_stopOperationrequired

The RPC method to invoke.

paramsArray<string>required

Array containing two string parameters: the follow_id (subscription identifier) and the operation_id.

idintegerrequired

Request identifier.

Response

200OK

Successful stop; no data is returned.

Authorization

api-keyAuthapiKey in header

chainHead_v1_stopOperation

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chainHead_v1_stopOperation",
  "params": [
    "follow_id",
    "operation_id"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "chainHead_v1_stopOperation",
  "params": [
    "follow_id",
    "operation_id"
  ],
  "id": 1
}

200

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

chainHeadV1Storage

chainHead_v1_storage

POST

https://tao.nownodes.io/

Retrieves storage data for the given block and storage query items.

Body

application/json

jsonrpcstringrequired

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

methodstringchainHead_v1_storagerequired

The RPC method to invoke.

paramsArray<string | Array<object>>required

Array containing three elements: - first element: a hex-encoded string (e.g., block hash) - second element: another hex-encoded string - third element: an array of storage query objects, each with a key (hex string) and type (e.g., "value").

Show child attributes

Any of

A hex-encoded parameter.

string

Array<object>

Show child attributes

keystringrequired

Hex-encoded storage key.

typestringrequired

Type of the storage entry (e.g., "value").

idintegerrequired

Request identifier.

Response

200OK

Successful response with storage query status.

Authorization

api-keyAuthapiKey in header

chainHead_v1_storage

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chainHead_v1_storage",
    "params": [
      "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
      "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102",
      [
        {
          "key": "0x26aa141073d12421db58c45d3395bc5d",
          "type": "value"
        }
      ]
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chainHead_v1_storage",
      "params": [
        "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
        "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102",
        [
          {
            "key": "0x26aa141073d12421db58c45d3395bc5d",
            "type": "value"
          }
        ]
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chainHead_v1_storage",
  "params": [
    "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
    "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102",
    [
      {
        "key": "0x26aa141073d12421db58c45d3395bc5d",
        "type": "value"
      }
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "chainHead_v1_storage",
  "params": [
    "0xe31b64304856f688094f3b095ebc920af0fcdc2078222729231201e389384bff",
    "0xdb348f3b095ebc920af0fcdc2078222729231201e389384be709bf950b330102",
    [
      {
        "key": "0x26aa141073d12421db58c45d3395bc5d",
        "type": "value"
      }
    ]
  ],
  "id": 1
}

200

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

chainSpecV1ChainName

chainSpec_v1_chainName

POST

https://tao.nownodes.io/

Retrieves the chain name from the chain specification.

Body

application/json

jsonrpcstringrequired

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

methodstringchainSpec_v1_chainNamerequired

The RPC method to invoke.

paramsarrayrequired

Empty array – this method takes no parameters.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the chain name.

Authorization

api-keyAuthapiKey in header

chainSpec_v1_chainName

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

chainSpecV1GenesisHash

chainSpec_v1_genesisHash

POST

https://tao.nownodes.io/

Retrieves the genesis hash of the chain.

Body

application/json

jsonrpcstringrequired

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

methodstringchainSpec_v1_genesisHashrequired

The RPC method to invoke.

paramsarrayrequired

Empty array – this method takes no parameters.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the genesis hash.

Authorization

api-keyAuthapiKey in header

chainSpec_v1_genesisHash

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "genesis_hash": "0x2f0555cc76fc2840a25a6ea3b9637146806f1f44b090c175ffde2a7e5ab36c03"
  }
}

chainSpecV1Properties

chainSpec_v1_properties

POST

https://tao.nownodes.io/

Retrieves the properties of the chain specification.

Body

application/json

jsonrpcstringrequired

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

methodstringchainSpec_v1_propertiesrequired

The RPC method to invoke.

paramsarrayrequired

Empty array – this method takes no parameters.

idintegerrequired

Request identifier.

Response

200OK

Successful response with chain properties.

Authorization

api-keyAuthapiKey in header

chainSpec_v1_properties

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "ss58Format": 42,
    "tokenDecimals": 9,
    "tokenSymbol": "TAO"
  }
}

delegateInfoGetDelegate

delegateInfo_getDelegate

POST

https://tao.nownodes.io/

Retrieves delegate information for the given public key.

Body

application/json

jsonrpcstringrequired

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

methodstringdelegateInfo_getDelegaterequired

The RPC method to invoke.

paramsArray<Array<integer>>required

Array containing a single element: an array of 32 integers representing the delegate's public key bytes.

idintegerrequired

Request identifier.

Response

200OK

Successful response with delegate information.

Authorization

api-keyAuthapiKey in header

delegateInfo_getDelegate

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "delegateInfo_getDelegate",
    "params": [
      [
        2,
        119,
        135,
        70,
        198,
        110,
        9,
        235,
        20,
        208,
        38,
        51,
        0,
        137,
        224,
        46,
        241,
        247,
        5,
        87,
        52,
        42,
        251,
        46,
        18,
        129,
        203,
        150,
        243,
        4,
        74,
        168
      ]
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "delegateInfo_getDelegate",
      "params": [
        [
          2,
          119,
          135,
          70,
          198,
          110,
          9,
          235,
          20,
          208,
          38,
          51,
          0,
          137,
          224,
          46,
          241,
          247,
          5,
          87,
          52,
          42,
          251,
          46,
          18,
          129,
          203,
          150,
          243,
          4,
          74,
          168
        ]
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "delegateInfo_getDelegate",
  "params": [
    [
      2,
      119,
      135,
      70,
      198,
      110,
      9,
      235,
      20,
      208,
      38,
      51,
      0,
      137,
      224,
      46,
      241,
      247,
      5,
      87,
      52,
      42,
      251,
      46,
      18,
      129,
      203,
      150,
      243,
      4,
      74,
      168
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "delegateInfo_getDelegate",
  "params": [
    [
      2,
      119,
      135,
      70,
      198,
      110,
      9,
      235,
      20,
      208,
      38,
      51,
      0,
      137,
      224,
      46,
      241,
      247,
      5,
      87,
      52,
      42,
      251,
      46,
      18,
      129,
      203,
      150,
      243,
      4,
      74,
      168
    ]
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "delegate_data": [
      0
    ]
  }
}

delegateInfoGetDelegated

delegateInfo_getDelegated

POST

https://tao.nownodes.io/

Retrieves the total stake delegated to the account identified by the given public key.

Body

application/json

jsonrpcstringrequired

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

methodstringdelegateInfo_getDelegatedrequired

The RPC method to invoke.

paramsArray<Array<integer>>required

Array containing a single element: an array of 32 integers representing the delegate's public key bytes.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the amount of delegated stake.

Authorization

api-keyAuthapiKey in header

delegateInfo_getDelegated

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "delegateInfo_getDelegated",
    "params": [
      [
        2,
        119,
        135,
        70,
        198,
        110,
        9,
        235,
        20,
        208,
        38,
        51,
        0,
        137,
        224,
        46,
        241,
        247,
        5,
        87,
        52,
        42,
        251,
        46,
        18,
        129,
        203,
        150,
        243,
        4,
        74,
        168
      ]
    ],
    "id": 1
  }'

const response = await fetch('https://tao.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "delegateInfo_getDelegated",
      "params": [
        [
          2,
          119,
          135,
          70,
          198,
          110,
          9,
          235,
          20,
          208,
          38,
          51,
          0,
          137,
          224,
          46,
          241,
          247,
          5,
          87,
          52,
          42,
          251,
          46,
          18,
          129,
          203,
          150,
          243,
          4,
          74,
          168
        ]
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "delegateInfo_getDelegated",
  "params": [
    [
      2,
      119,
      135,
      70,
      198,
      110,
      9,
      235,
      20,
      208,
      38,
      51,
      0,
      137,
      224,
      46,
      241,
      247,
      5,
      87,
      52,
      42,
      251,
      46,
      18,
      129,
      203,
      150,
      243,
      4,
      74,
      168
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "delegateInfo_getDelegated",
  "params": [
    [
      2,
      119,
      135,
      70,
      198,
      110,
      9,
      235,
      20,
      208,
      38,
      51,
      0,
      137,
      224,
      46,
      241,
      247,
      5,
      87,
      52,
      42,
      251,
      46,
      18,
      129,
      203,
      150,
      243,
      4,
      74,
      168
    ]
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "delegated_stake": [
      0
    ]
  }
}

neuronInfoGetNeuron

neuronInfo_getNeuron

POST

https://tao.nownodes.io/

Retrieves neuron information for a given subnet ID and UID.

Body

application/json

jsonrpcstringrequired

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

methodstringneuronInfo_getNeuronrequired

The RPC method to invoke.

paramsArray<integer>required

Array containing two elements: the subnet ID (netuid) and the neuron UID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with neuron information.

Authorization

api-keyAuthapiKey in header

neuronInfo_getNeuron

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "netuid": 1,
    "uid": 164,
    "stake": 71,
    "rank": 228,
    "trust": 100,
    "consensus": 200,
    "incentive": 50,
    "dividends": 30,
    "emission": 500000,
    "active": 1,
    "last_update": 123456,
    "validator_trust": 150,
    "validator_consensus": 180,
    "pruning_score": 0,
    "axon_info": 0,
    "prometheus_info": 0
  }
}

neuronInfoGetNeuronLite

neuronInfo_getNeuronLite

POST

https://tao.nownodes.io/

Retrieves lightweight neuron information for a given subnet ID and UID.

Body

application/json

jsonrpcstringrequired

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

methodstringneuronInfo_getNeuronLiterequired

The RPC method to invoke.

paramsArray<integer>required

Array containing two elements: the subnet ID (netuid) and the neuron UID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with lightweight neuron information.

Authorization

api-keyAuthapiKey in header

neuronInfo_getNeuronLite

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "netuid": 1,
    "uid": 164,
    "stake": 71,
    "rank": 228,
    "trust": 100,
    "consensus": 200,
    "incentive": 50,
    "dividends": 30,
    "emission": 500000,
    "active": 1,
    "last_update": 123456,
    "validator_trust": 150,
    "pruning_score": 0
  }
}

neuronInfoGetNeurons

neuronInfo_getNeurons

POST

https://tao.nownodes.io/

Retrieves the list of neuron UIDs registered in the specified subnet.

Body

application/json

jsonrpcstringrequired

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

methodstringneuronInfo_getNeuronsrequired

The RPC method to invoke.

paramsArray<integer>required

Array containing a single element: the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the list of neuron UIDs.

Authorization

api-keyAuthapiKey in header

neuronInfo_getNeurons

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "neuron_uids": [
      1,
      4,
      164,
      0
    ]
  }
}

subnetInfoGetAllDynamicInfo

subnetInfo_getAllDynamicInfo

POST

https://tao.nownodes.io/

Retrieves all dynamic information for all subnets.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getAllDynamicInforequired

The RPC method to invoke.

paramsarrayrequired

Method parameters. An empty array.

idintegerrequired

Request identifier.

Response

200OK

Successful response with all subnet dynamic information.

Authorization

api-keyAuthapiKey in header

subnetInfo_getAllDynamicInfo

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "element_0": 5,
    "element_1": 2,
    "element_2": 1,
    "element_3": 0
  }
}

subnetInfoGetAllMechagraphs

subnetInfo_getAllMechagraphs

POST

https://tao.nownodes.io/

Retrieves all mechagraphs from every subnet.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getAllMechagraphsrequired

The RPC method to invoke.

paramsarrayrequired

Method parameters. An empty array.

idintegerrequired

Request identifier.

Response

200OK

Successful response containing mechagraphs for all subnets.

Authorization

api-keyAuthapiKey in header

subnetInfo_getAllMechagraphs

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "subnet_id": 1,
      "block": 314567,
      "shape": [
        32,
        32,
        3
      ],
      "data": "iVBORw0KGgoAAAANSUhEUgAAAAUA..."
    },
    {
      "subnet_id": 2,
      "block": 314568,
      "shape": [
        64,
        64
      ],
      "data": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

subnetInfoGetAllMetagraphs

subnetInfo_getAllMetagraphs

POST

https://tao.nownodes.io/

Retrieves the complete metagraph for every subnet in the network.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getAllMetagraphsrequired

The RPC method to invoke.

paramsarrayrequired

Method parameters. An empty array.

idintegerrequired

Request identifier.

Response

200OK

Successful response with all subnet metagraphs.

Authorization

api-keyAuthapiKey in header

subnetInfo_getAllMetagraphs

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "subnet_id": 1,
      "block": 398765,
      "tao": 125000.5,
      "alpha": 98000,
      "emission": 0.025,
      "neurons": [
        {
          "uid": 0,
          "hotkey": "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY",
          "coldkey": "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty",
          "stake": 10000,
          "rank": 0.95,
          "trust": 0.99,
          "consensus": 0.88,
          "incentive": 0.75,
          "dividends": 120.5,
          "last_update": 398760,
          "validator_permit": true,
          "validator_trust": 0.98,
          "axon_info": {
            "ip": "192.168.1.10",
            "port": 8091,
            "ip_type": 4,
            "protocol": 1,
            "placeholder1": 0,
            "placeholder2": 0
          },
          "prometheus_info": {
            "ip": "192.168.1.10",
            "port": 9091,
            "ip_type": 4,
            "protocol": 1,
            "placeholder1": 0,
            "placeholder2": 0
          }
        }
      ]
    }
  ]
}

subnetInfoGetColdkeyAutoStakeHotkey

subnetInfo_getColdkeyAutoStakeHotkey

POST

https://tao.nownodes.io/

Returns the list of auto-stake hotkeys (or their count) for the given coldkey address and subnet ID.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getColdkeyAutoStakeHotkeyrequired

The RPC method to invoke.

paramsarray[object Object][object Object]required

Array containing two elements: the coldkey SS58 address and the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the auto-stake hotkey information.

Authorization

api-keyAuthapiKey in header

subnetInfo_getColdkeyAutoStakeHotkey

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "subnetInfo_getColdkeyAutoStakeHotkey",
  "params": [
    "5CaEd14Wjz6h6Yy4Z74GSa2sdPjUm1oNsdrxX7sXz1HPsn63",
    1
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "subnetInfo_getColdkeyAutoStakeHotkey",
  "params": [
    "5CaEd14Wjz6h6Yy4Z74GSa2sdPjUm1oNsdrxX7sXz1HPsn63",
    1
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    0
  ]
}

subnetInfoGetDynamicInfo

subnetInfo_getDynamicInfo

POST

https://tao.nownodes.io/

Retrieves dynamic information for a specific subnet identified by its ID.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getDynamicInforequired

The RPC method to invoke.

paramsArray<integer>required

Method parameters containing exactly one element: the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with subnet dynamic information.

Authorization

api-keyAuthapiKey in header

subnetInfo_getDynamicInfo

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "element_0": 1,
    "element_1": 4,
    "element_2": 226,
    "element_3": 238,
    "element_4": 117
  }
}

subnetInfoGetLockCost

subnetInfo_getLockCost

POST

https://tao.nownodes.io/

Retrieves the current lock cost (in RAO) for registering a new subnet.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getLockCostrequired

The RPC method to invoke.

paramsarrayrequired

Method parameters. An empty array.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the current lock cost.

Authorization

api-keyAuthapiKey in header

subnetInfo_getLockCost

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

subnetInfoGetMechagraph

subnetInfo_getMechagraph

POST

https://tao.nownodes.io/

Retrieves the mechagraph for a specific subnet and block/identifier.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getMechagraphrequired

The RPC method to invoke.

paramsarray[object Object][object Object]required

Array of two integers: subnet ID and a block/identifier.

idintegerrequired

Request identifier.

Response

200OK

Successful response with mechagraph data.

Authorization

api-keyAuthapiKey in header

subnetInfo_getMechagraph

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "element_0": 1,
    "element_1": 4,
    "element_2": 16,
    "element_3": 5,
    "element_4": 1,
    "element_5": 0,
    "element_6": 0,
    "element_7": 0,
    "element_8": 0,
    "element_9": 0,
    "element_10": 0,
    "element_11": 12
  }
}

subnetInfoGetMetagraph

subnetInfo_getMetagraph

POST

https://tao.nownodes.io/

Retrieves the metagraph of a single subnet identified by its ID.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getMetagraphrequired

The RPC method to invoke.

paramsArray<integer>required

Array with one element: the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response containing the subnet metagraph.

Authorization

api-keyAuthapiKey in header

subnetInfo_getMetagraph

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "element_0": 1,
    "element_1": 4,
    "element_2": 16,
    "element_3": 5,
    "element_4": 1,
    "element_5": 0,
    "element_6": 0,
    "element_7": 0,
    "element_8": 0,
    "element_9": 0,
    "element_10": 0,
    "element_11": 0
  }
}

subnetInfoGetSelectiveMechagraph

subnetInfo_getSelectiveMechagraph

POST

https://tao.nownodes.io/

Fetches specific mechagraph values for a subnet, block, and a list of indices.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSelectiveMechagraphrequired

The RPC method to invoke.

paramsArray<integer | Array<integer>>required

Parameters: [subnet_id, block_number, array_of_indices]. - subnet_id (integer) - block_number (integer) – the block or identifier - indices (array of integers) – the mechagraph indices to retrieve

Show child attributes

One of

Subnet ID or block number.

integer

Array<integer>

idintegerrequired

Request identifier.

Response

200OK

Successful response with selected mechagraph data.

Authorization

api-keyAuthapiKey in header

subnetInfo_getSelectiveMechagraph

curl -X POST 'https://tao.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "subnetInfo_getSelectiveMechagraph",
    "params": [
      1,
      0,
      [
        10,
        11,
        12
      ]
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "subnetInfo_getSelectiveMechagraph",
  "params": [
    1,
    0,
    [
      10,
      11,
      12
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "subnetInfo_getSelectiveMechagraph",
  "params": [
    1,
    0,
    [
      10,
      11,
      12
    ]
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "subnet_id": 1,
    "block": 0,
    "value_index_10": 0,
    "value_index_11": 0,
    "value_index_12": 0
  }
}

subnetInfoGetSelectiveMetagraph

subnetInfo_getSelectiveMetagraph

POST

https://tao.nownodes.io/

Fetches selected metagraph values for a specific subnet by providing a list of indices.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSelectiveMetagraphrequired

The RPC method to invoke.

paramsArray<integer | Array<integer>>required

Parameters: [subnet_id, array_of_indices]. - subnet_id (integer): the target subnet. - indices (array of integers): the metagraph positions to return.

Show child attributes

One of

Subnet identifier.

integer

Array<integer>

idintegerrequired

Request identifier.

Response

200OK

Successful response with the requested selective metagraph data.

Authorization

api-keyAuthapiKey in header

subnetInfo_getSelectiveMetagraph

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "subnetInfo_getSelectiveMetagraph",
  "params": [
    1,
    [
      10,
      15,
      20
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "subnetInfo_getSelectiveMetagraph",
  "params": [
    1,
    [
      10,
      15,
      20
    ]
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "element_0": 1,
    "element_1": 0,
    "element_2": 0,
    "element_3": 0,
    "element_4": 0
  }
}

subnetInfoGetSubnetHyperparams

subnetInfo_getSubnetHyperparams

POST

https://tao.nownodes.io/

Retrieves the hyperparameters of a single subnet identified by its ID.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSubnetHyperparamsrequired

The RPC method to invoke.

paramsArray<integer>required

Array containing a single element: the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with subnet hyperparameters.

Authorization

api-keyAuthapiKey in header

subnetInfo_getSubnetHyperparams

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "subnet_id": 1,
    "min_allowed_weights": 40,
    "max_weight_limit": 254,
    "tempo": 255,
    "min_difficulty": 100,
    "max_difficulty": 10000,
    "adjustment_interval": 100,
    "target_registrations_per_interval": 2,
    "activity_cutoff": 5000,
    "bonds_moving_average": 900000,
    "alpha": 0,
    "kappa": 0,
    "placeholder_12": 0,
    "placeholder_13": 0,
    "placeholder_14": 0
  }
}

subnetInfoGetSubnetHyperparamsV2

subnetInfo_getSubnetHyperparamsV2

POST

https://tao.nownodes.io/

Retrieves the V2 hyperparameters of a single subnet identified by its ID.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSubnetHyperparamsV2required

The RPC method to invoke.

paramsArray<integer>required

Array containing a single element: the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with subnet hyperparameters (V2).

Authorization

api-keyAuthapiKey in header

subnetInfo_getSubnetHyperparamsV2

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "subnet_id": 1,
    "min_allowed_weights": 40,
    "max_weight_limit": 254,
    "tempo": 255,
    "min_difficulty": 100,
    "max_difficulty": 10000,
    "adjustment_interval": 100,
    "target_registrations_per_interval": 2,
    "activity_cutoff": 5000,
    "bonds_moving_average": 900000,
    "alpha": 0,
    "kappa": 0,
    "placeholder_12": 0,
    "placeholder_13": 0,
    "placeholder_14": 0
  }
}

subnetInfoGetSubnetInfoV2

subnetInfo_getSubnetInfo_v2

POST

https://tao.nownodes.io/

Retrieves the V2 information fields of a single subnet identified by its ID.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSubnetInfo_v2required

The RPC method to invoke.

paramsArray<integer>required

Array containing a single element: the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with subnet information (V2).

Authorization

api-keyAuthapiKey in header

subnetInfo_getSubnetInfo_v2

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "netuid": 1,
    "active": 4,
    "min_allowed_weights": 40,
    "max_weight_limit": 254,
    "tempo": 100,
    "emission": 1000000,
    "max_allowed_uids": 4096,
    "min_validator_stake": 100000,
    "max_validators": 64,
    "validator_epoch_length": 100,
    "validator_epochs_per_reset": 60,
    "immunity_period": 1000,
    "activity_cutoff": 5000,
    "bonds_moving_average": 900000,
    "alpha": 0,
    "kappa": 0,
    "subnet_version": 1
  }
}

subnetInfoGetSubnetInfo

subnetInfo_getSubnetInfo

POST

https://tao.nownodes.io/

Retrieves all information fields of a single subnet identified by its ID.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSubnetInforequired

The RPC method to invoke.

paramsArray<integer>required

Array containing a single element: the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with subnet information.

Authorization

api-keyAuthapiKey in header

subnetInfo_getSubnetInfo

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "netuid": 1,
    "difficulty": 100000,
    "difficulty_target": 100000,
    "tempo": 100,
    "emission": 1000000,
    "max_allowed_uids": 4096,
    "max_allowed_weights": 18,
    "min_allowed_weights": 2,
    "max_weight_limit": 1000,
    "min_validator_stake": 100000,
    "max_validators": 64,
    "validator_epoch_length": 100,
    "validator_epochs_per_reset": 60,
    "last_adjustment_block": 123456,
    "last_adjustment_alpha": 100000,
    "immunity_period": 1000,
    "activity_cutoff": 5000,
    "min_difficulty": 100,
    "max_difficulty": 10000,
    "adjustment_interval": 100,
    "target_registrations_per_interval": 2,
    "bonds_moving_average": 900000,
    "alpha": 0,
    "kappa": 0,
    "subnet_version": 1
  }
}

subnetInfoGetSubnetsInfoV2

subnetInfo_getSubnetsInfo_v2

POST

https://tao.nownodes.io/

Retrieves the identifiers of all currently registered subnets using the V2 endpoint.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSubnetsInfo_v2required

The RPC method to invoke.

paramsarrayrequired

Empty array – this method takes no parameters.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the list of subnet IDs (V2).

Authorization

api-keyAuthapiKey in header

subnetInfo_getSubnetsInfo_v2

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "subnet_ids": [
      5,
      2,
      1,
      99,
      0
    ]
  }
}

subnetInfoGetSubnetsInfo

subnetInfo_getSubnetsInfo

POST

https://tao.nownodes.io/

Retrieves the identifiers of all currently registered subnets.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSubnetsInforequired

The RPC method to invoke.

paramsarrayrequired

Empty array – this method takes no parameters.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the list of subnet IDs.

Authorization

api-keyAuthapiKey in header

subnetInfo_getSubnetsInfo

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "subnet_ids": [
      5,
      2,
      1,
      99
    ]
  }
}

subnetInfoGetSubnetState

subnetInfo_getSubnetState

POST

https://tao.nownodes.io/

Retrieves the current state of a single subnet identified by its ID.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSubnetStaterequired

The RPC method to invoke.

paramsArray<integer>required

Array containing a single element: the subnet ID.

idintegerrequired

Request identifier.

Response

200OK

Successful response with subnet state.

Authorization

api-keyAuthapiKey in header

subnetInfo_getSubnetState

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "netuid": 1,
    "active": 4,
    "emission": 1,
    "tempo": 4,
    "min_allowed_weights": 40,
    "max_allowed_weights": 254,
    "max_weight_limit": 1000,
    "min_validator_stake": 100000,
    "max_validators": 64,
    "validator_epoch_length": 100,
    "validator_epochs_per_reset": 60,
    "immunity_period": 1000,
    "activity_cutoff": 5000,
    "bonds_moving_average": 900000,
    "alpha": 0,
    "kappa": 0,
    "subnet_version": 1
  }
}

subnetInfoGetSubnetToPrune

subnetInfo_getSubnetToPrune

POST

https://tao.nownodes.io/

Retrieves the subnet ID that is next in line for pruning.

Body

application/json

jsonrpcstringrequired

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

methodstringsubnetInfo_getSubnetToPrunerequired

The RPC method to invoke.

paramsarrayrequired

Empty array – this method takes no parameters.

idintegerrequired

Request identifier.

Response

200OK

Successful response with the subnet ID to prune.

Authorization

api-keyAuthapiKey in header

subnetInfo_getSubnetToPrune

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

swapCurrentAlphaPrice

swap_currentAlphaPrice

POST

https://tao.nownodes.io/

Retrieves the current alpha price for the specified swap pool.

Body

application/json

jsonrpcstringrequired

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

methodstringswap_currentAlphaPricerequired

The RPC method to invoke.

paramsArray<integer>required

Array containing a single integer element (e.g., pool ID).

idintegerrequired

Request identifier.

Response

200OK

Successful response with the current alpha price.

Authorization

api-keyAuthapiKey in header

swap_currentAlphaPrice

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

swapSimSwapAlphaForTao

swap_simSwapAlphaForTao

POST

https://tao.nownodes.io/

Simulates swapping Alpha tokens to Tao and returns the resulting output breakdown.

Body

application/json

jsonrpcstringrequired

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

methodstringswap_simSwapAlphaForTaorequired

The RPC method to invoke.

paramsArray<integer>required

Array containing two integer elements: the pool ID and the amount of Alpha to swap (in RAO or smallest unit).

idintegerrequired

Request identifier.

Response

200OK

Successful response with the simulation result.

Authorization

api-keyAuthapiKey in header

swap_simSwapAlphaForTao

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "swap_output": [
      130,
      203,
      148,
      0
    ]
  }
}

swapSimSwapTaoForAlpha

swap_simSwapTaoForAlpha

POST

https://tao.nownodes.io/

Simulates swapping Tao tokens to Alpha and returns the resulting output breakdown.

Body

application/json

jsonrpcstringrequired

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

methodstringswap_simSwapTaoForAlpharequired

The RPC method to invoke.

paramsArray<integer>required

Array containing two integer elements: the pool ID and the amount of Tao to swap (in RAO, the smallest unit).

idintegerrequired

Request identifier.

Response

200OK

Successful response with the simulation result.

Authorization

api-keyAuthapiKey in header

swap_simSwapTaoForAlpha

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "swap_output": [
      5,
      27,
      147,
      59,
      0
    ]
  }
}

Documentation

Authentication

DEBUG

debug_traceBlockByHash

Body

Response

Authorization

debug_traceBlockByNumber

Body

Response

Authorization

debug_traceCall

Body

Response

Authorization

debug_traceTransaction

Body

Response

Authorization

EVM

eth_accounts

Body

Response

Authorization

eth_blockNumber

Body

Response

Authorization

eth_call

Body

Response

Authorization

eth_chainId

Body

Response

Authorization

eth_estimateGas

Body

Response

Authorization

eth_gasPrice

Body

Response

Authorization

eth_getBalance

Body

Response

Authorization

eth_getBlockByHash

Body

Response

Authorization

eth_getBlockByNumber

Body

Response

Authorization

eth_getBlockReceipts

Body

Response

Authorization

eth_getBlockTransactionCountByHash

Body

Response

Authorization

eth_getBlockTransactionCountByNumber

Body

Response

Authorization

eth_getCode

Body

Response

Authorization

eth_getFilterChanges

Body

Response

Authorization

eth_getFilterLogs

Body

Response

Authorization