API Reference

v1.0.0

Base URL

https://zil.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

MAINNET / API-Reference

CreateTransaction

Create and send a new transaction

POST

https://zil.nownodes.io/

Creates a new transaction and broadcasts it to the Zilliqa network. The transaction can be a transfer of ZIL or an interaction with a smart contract.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<object>required

Transaction parameters object

Show child attributes

senderstringrequired

Address of the sender in Bech32 format

recipientstringrequired

Address of the recipient in Bech32 format

amountstringrequired

Amount to send in Qa (1 ZIL = 10^12 Qa)

gasPricestringrequired

Gas price in Qa

gasLimitintegerrequired

Maximum gas units allowed for the transaction

nonceintegerrequired

Transaction nonce to prevent replay attacks

datastring

(Optional) Hex-encoded data payload for smart contract interaction

Response

200OK

Transaction created and broadcasted successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Create and send a new transaction

curl -X POST 'https://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "CreateTransaction",
    "id": 1,
    "params": [
      {
        "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
        "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
        "amount": "1000000000000",
        "gasPrice": "1000000000",
        "gasLimit": 5000,
        "nonce": 10,
        "data": "0xabcdef"
      }
    ]
  }'

const response = await fetch('https://zil.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "CreateTransaction",
      "id": 1,
      "params": [
        {
          "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
          "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
          "amount": "1000000000000",
          "gasPrice": "1000000000",
          "gasLimit": 5000,
          "nonce": 10,
          "data": "0xabcdef"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "CreateTransaction",
  "id": 1,
  "params": [
    {
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "data": "0xabcdef"
    }
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "CreateTransaction",
  "id": 1,
  "params": [
    {
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "recipient": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "data": "0xabcdef"
    }
  ]
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "tranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
    "receipt": {}
  }
}

DSBlockListing

List DS blocks with pagination

POST

https://zil.nownodes.io/

Returns a paginated list of DS blocks from the blockchain, where each page contains a defined number of blocks. The most recent blocks are listed first by default.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<integer>required

Array with pagination parameters:

max: Maximum number of blocks to return (default 10)
offset: Offset from the latest block (default 0)

Response

200OK

Paginated DS block listing retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

List DS blocks with pagination

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Data": [
      {
        "DSBlockNum": "12345",
        "DSBlockHash": "0xabcdef1234567890",
        "LeaderPubKey": "03a1b2c3...",
        "Difficulty": "123456789",
        "DifficultyDS": "987654321",
        "Timestamp": "1625247600"
      }
    ],
    "NumPages": 25,
    "Page": 0
  }
}

default

Get latest DS block number

POST

https://zil.nownodes.io/GetLatestDsBlock

Returns the latest DS (Directory Service) block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Latest DS block number retrieved successfully

Authorization

api-keyAuthapiKey in header

Get latest DS block number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get DS block creation rate

POST

https://zil.nownodes.io/GetDSBlockRate

Returns the rate of DS block creation in blocks per second.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

DS block creation rate retrieved successfully

Authorization

api-keyAuthapiKey in header

Get DS block creation rate

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get latest transaction block number

POST

https://zil.nownodes.io/GetLatestTxBlock

Returns the latest transaction (Tx) block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Latest Tx block number retrieved successfully

Authorization

api-keyAuthapiKey in header

Get latest transaction block number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get network ID

POST

https://zil.nownodes.io/GetNetworkId

Returns the network ID of the connected Zilliqa network.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Network ID retrieved successfully

Authorization

api-keyAuthapiKey in header

Get network ID

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get miner information

POST

https://zil.nownodes.io/GetMinerInfo

Returns information about the miner of the node.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Miner information retrieved successfully

Authorization

api-keyAuthapiKey in header

Get miner information

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "address": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "nodeVersion": "v6.1.0-rc1",
    "isMining": true,
    "currentShardID": 2
  }
}

Get node type

POST

https://zil.nownodes.io/GetNodeType

Returns the type of the current node.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Node type retrieved successfully

Authorization

api-keyAuthapiKey in header

Get node type

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get number of DS blocks

POST

https://zil.nownodes.io/GetNumDSBlocks

Returns the total number of DS blocks created so far.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Number of DS blocks retrieved successfully

Authorization

api-keyAuthapiKey in header

Get number of DS blocks

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get number of peers

POST

https://zil.nownodes.io/GetNumPeers

Returns the number of peers connected to this node.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Number of peers retrieved successfully

Authorization

api-keyAuthapiKey in header

Get number of peers

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get number of transactions

POST

https://zil.nownodes.io/GetNumTransactions

Returns the total number of transactions processed so far.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Number of transactions retrieved successfully

Authorization

api-keyAuthapiKey in header

Get number of transactions

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get number of transaction blocks

POST

https://zil.nownodes.io/GetNumTxBlocks

Returns the total number of transaction blocks created so far.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Number of transaction blocks retrieved successfully

Authorization

api-keyAuthapiKey in header

Get number of transaction blocks

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get previous mining difficulty

POST

https://zil.nownodes.io/GetPrevDifficulty

Returns the mining difficulty of the previous transaction block.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Previous transaction block difficulty retrieved successfully

Authorization

api-keyAuthapiKey in header

Get previous mining difficulty

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get previous DS block difficulty

POST

https://zil.nownodes.io/GetPrevDSDifficulty

Returns the mining difficulty of the previous DS block.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Previous DS block difficulty retrieved successfully

Authorization

api-keyAuthapiKey in header

Get previous DS block difficulty

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get current sharding structure

POST

https://zil.nownodes.io/GetShardingStructure

Returns the current sharding structure of the Zilliqa network including shards and DS committee members.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Sharding structure retrieved successfully

Authorization

api-keyAuthapiKey in header

Get current sharding structure

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "shards": [
      {
        "shardID": 0,
        "nodes": [
          "node1.example.com"
        ]
      }
    ],
    "dsCommittee": [
      "dsnode1.example.com"
    ]
  }
}

Get node software version

POST

https://zil.nownodes.io/GetVersion

Returns the current node software version.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Node version retrieved successfully

Authorization

api-keyAuthapiKey in header

Get node software version

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get total coin supply

POST

https://zil.nownodes.io/GetTotalCoinSupply

Returns the total circulating supply of ZIL coins.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Total coin supply retrieved successfully

Authorization

api-keyAuthapiKey in header

Get total coin supply

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

Get transaction block details by block number

POST

https://zil.nownodes.io/GetTxBlock

Returns detailed information about a specific transaction block by its number.

Body

application/json

jsonrpcstring

JSON-RPC version

methodstring

Method name

idinteger

Request ID

paramsArray<integer>

Array with block number (height) as parameter

Response

200OK

Transaction block details retrieved successfully

Authorization

api-keyAuthapiKey in header

Get transaction block details by block number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "header": {
      "blockNum": 12345,
      "prevBlockHash": "0xabcdef1234567890...",
      "timestamp": 1627889182,
      "txCount": 10,
      "dsBlockNum": 789,
      "gasLimit": "5000000"
    },
    "txs": [
      {
        "txID": "0x1234abcd5678ef90",
        "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
        "recipient": "zil1p9xtfkr6x0js4v5hj8q9k3j0e6p3vxtl7hsv8z",
        "amount": "1000000000000",
        "gasPrice": "1000000000",
        "gasUsed": "21000",
        "data": "0x"
      }
    ]
  }
}

Get transaction block creation rate

POST

https://zil.nownodes.io/GetTxBlockRate

Returns the average rate at which transaction blocks are created.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Transaction block creation rate retrieved successfully

Authorization

api-keyAuthapiKey in header

Get transaction block creation rate

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetBalance

Get balance of a Zilliqa address

POST

https://zil.nownodes.io/

Retrieves the current balance of a specified Zilliqa address in Qa (1 ZIL = 10^12 Qa).

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string>required

Array containing the Zilliqa address to query

Response

200OK

Balance retrieval successful

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get balance of a Zilliqa address

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "balance": "25000000000000",
    "nonce": 15
  }
}

GetBlockchainInfo

Get blockchain metadata

POST

https://zil.nownodes.io/

Returns high-level information about the blockchain's current state, such as DS and transaction block numbers, difficulties, and gas prices.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request identifier

paramsarrayrequired

Must be an empty array

Response

200OK

Blockchain metadata successfully returned

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get blockchain metadata

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "CurrentDSEpoch": "1250",
    "CurrentMiniEpoch": "3768",
    "NumPeers": "50",
    "NumTxBlocks": "3700",
    "NumDSBlocks": "1250",
    "NumTransactions": "180000",
    "TransactionRate": "3",
    "TxBlockRate": "1",
    "DSBlockRate": "1",
    "CurrentDifficulty": "1000000000",
    "CurrentDSDifficulty": "1500000000",
    "GasPrice": "2000000000"
  }
}

GetContractAddressFromTransactionID

Get smart contract address from transaction ID

POST

https://zil.nownodes.io/

Retrieves the smart contract address that is associated with a given transaction ID (hash). Useful to identify which contract was interacted with in the specified transaction.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string>required

Array with one parameter — transaction ID (hash)

Response

200OK

Smart contract address retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get smart contract address from transaction ID

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetCurrentDSComm

Get current DS committee

POST

https://zil.nownodes.io/

Returns the current Directory Service (DS) committee that is responsible for consensus. Each DS committee member is represented by its public key.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsarrayrequired

Should be an empty array

Response

200OK

Current DS committee retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get current DS committee

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    "027fefab0c9c4f1a44c23b0f32d45a3ef3b53bfae265cf69e5..."
  ]
}

GetCurrentDSEpoch

Get current DS epoch

POST

https://zil.nownodes.io/

Returns the current DS epoch number. A DS epoch represents a period of consensus rounds managed by a particular DS committee.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsarrayrequired

Should be an empty array

Response

200OK

Successfully retrieved current DS epoch number

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get current DS epoch

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetCurrentMiniEpoch

Get current Tx (Mini) epoch

POST

https://zil.nownodes.io/

Returns the current Mini Epoch number. A Mini Epoch (a.k.a. Tx Epoch) is a unit of time in which transaction blocks are produced.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsarrayrequired

Should be an empty array

Response

200OK

Current mini epoch number successfully retrieved

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get current Tx (Mini) epoch

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetDsBlock

Get a specific DS block

POST

https://zil.nownodes.io/

Returns details about a Directory Service (DS) block identified by its block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<integer>required

Array containing a single DS block number

Response

200OK

DS block data returned successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get a specific DS block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "header": {
      "BlockNum": "1234",
      "Difficulty": "123456789",
      "DifficultyDS": "987654321",
      "LeaderPubKey": "03a1b2c3...",
      "PoWDSWinners": [
        "03a1b2...",
        "0243c4..."
      ],
      "Timestamp": "1625247600"
    },
    "signature": "abcdef1234567890"
  }
}

GetDSBlockRate

Get DS block creation rate

POST

https://zil.nownodes.io/

Returns the rate of DS block creation in blocks per second.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successful response with DS block production rate

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get DS block creation rate

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetLatestDsBlock

Get latest DS block number

POST

https://zil.nownodes.io/

Returns the latest DS (Directory Service) block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successful response with the latest DS block

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get latest DS block number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "BlockNum": "105",
    "Difficulty": "0",
    "LeaderPubKey": "02f86a2c...",
    "PoWWinners": [
      "02f86a2c..."
    ],
    "PreviousHash": "d2f85a129f...",
    "Signature": "3045022100...",
    "Timestamp": "1687687243",
    "Hash": "03f4b3cfa8..."
  }
}

GetLatestTxBlock

Get latest transaction block number

POST

https://zil.nownodes.io/

Returns the latest transaction (Tx) block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Latest Tx block details retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get latest transaction block number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "BlockNum": "193847",
    "Difficulty": "18446744073709551615",
    "DSBlockNum": "105",
    "GasLimit": "8000000",
    "GasUsed": "34000",
    "MinerPubKey": "02f86a2c3c1d6f88456c4...",
    "NumTxns": "5",
    "PrevBlockHash": "f2b6fabc1f0b9c...",
    "StateRootHash": "ab567c9ee...",
    "Timestamp": "1687687300",
    "TxnHash": "12345abcf...",
    "Hash": "e56f12a3..."
  }
}

GetMinerInfo

Get miner information

POST

https://zil.nownodes.io/

Returns information about the miner of the node.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved miner information

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get miner information

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "PubKey": "02f86a2c3c1d6f88456c4a...",
    "IP": "192.168.1.100",
    "Port": "33133",
    "Role": "DS",
    "Committee": "DS Committee"
  }
}

GetMinimumGasPrice

Get current minimum gas price

POST

https://zil.nownodes.io/

Retrieves the current minimum gas price (in Qa) required for a transaction to be accepted by the Zilliqa network.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

Response

200OK

Current minimum gas price retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get current minimum gas price

curl -X POST 'https://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "GetMinimumGasPrice",
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "GetMinimumGasPrice",
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "GetMinimumGasPrice",
  "id": 1
}

200

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

GetNetworkId

Get network ID

POST

https://zil.nownodes.io/

Returns the network ID of the connected Zilliqa network.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved the network ID

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get network ID

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetNodeType

Get node type

POST

https://zil.nownodes.io/

Returns the type of the current node.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved node type

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get node type

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetNumDSBlocks

Get number of DS blocks

POST

https://zil.nownodes.io/

Returns the total number of DS blocks created so far.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved number of DS blocks

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get number of DS blocks

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetNumPeers

Get number of peers

POST

https://zil.nownodes.io/

Returns the number of peers connected to this node.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved number of peers

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get number of peers

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetNumTransactions

Get number of transactions

POST

https://zil.nownodes.io/

Returns the total number of transactions processed so far.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved transaction count

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get number of transactions

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetNumTxBlocks

Get number of transaction blocks

POST

https://zil.nownodes.io/

Returns the total number of transaction blocks created so far.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved number of Tx blocks

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get number of transaction blocks

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetNumTxnsDSEpoch

Get number of transactions in current DS epoch

POST

https://zil.nownodes.io/

Retrieves the total number of transactions processed during the current Directory Service (DS) epoch.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

Response

200OK

Number of transactions in the DS epoch retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get number of transactions in current DS epoch

curl -X POST 'https://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "GetNumTxnsDSEpoch",
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "GetNumTxnsDSEpoch",
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "GetNumTxnsDSEpoch",
  "id": 1
}

200

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

GetNumTxnsTxEpoch

Get number of transactions in current Tx epoch

POST

https://zil.nownodes.io/

Retrieves the total number of transactions processed during the current transaction (Tx) epoch on the Zilliqa blockchain.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

Response

200OK

Number of transactions in the Tx epoch retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get number of transactions in current Tx epoch

curl -X POST 'https://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "GetNumTxnsTxEpoch",
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "GetNumTxnsTxEpoch",
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "GetNumTxnsTxEpoch",
  "id": 1
}

200

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

GetPrevDifficulty

Get previous mining difficulty

POST

https://zil.nownodes.io/

Returns the mining difficulty of the previous transaction block.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved previous block difficulty

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get previous mining difficulty

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetPrevDSDifficulty

Get previous DS block difficulty

POST

https://zil.nownodes.io/

Returns the mining difficulty of the previous DS block.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved previous DS block difficulty

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get previous DS block difficulty

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetRecentTransactions

Retrieve recent transactions

POST

https://zil.nownodes.io/

Returns a list of recent transactions on the Zilliqa blockchain. Optionally supports parameters such as limit (number of transactions).

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<integer | string>

Optional parameters array.

Show child attributes

One of

integer

string

Response

200OK

Recent transactions retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Retrieve recent transactions

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "tranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "receiver": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "timestamp": 1625247600,
      "status": "SUCCESS"
    }
  ]
}

GetShardingStructure

Get current sharding structure

POST

https://zil.nownodes.io/

Returns the current sharding structure of the Zilliqa network including shards and DS committee members.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved sharding structure

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get current sharding structure

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "shards": [
      {
        "shardID": 0,
        "nodes": [
          {
            "PubKey": "02f86a2c3c1d6f88456c4a...",
            "IP": "192.168.1.100",
            "Port": "33133"
          }
        ]
      }
    ],
    "dsCommittee": [
      {
        "PubKey": "02f86a2c3c1d6f88456c4a...",
        "IP": "192.168.1.101",
        "Port": "33134"
      }
    ]
  }
}

GetSmartContractCode

Get smart contract source code by address

POST

https://zil.nownodes.io/

Retrieves the source code and metadata of a smart contract deployed on the Zilliqa blockchain. Requires the smart contract address as a parameter.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string>required

Array containing one parameter — smart contract address

Response

200OK

Smart contract source code retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get smart contract source code by address

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "address": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "code": "contract MyContract\nfield myField : Uint32 = 0\ntransition Increment()\n  myField := builtin add myField 1\nend\n",
    "abi": [
      {
        "name": "Increment",
        "input": [
          {
            "name": "amount",
            "type": "Uint32"
          }
        ],
        "output": "Unit"
      }
    ],
    "metadata": {
      "author": "Alice",
      "email": "[email protected]",
      "version": "1.0"
    }
  }
}

GetSmartContractInit

Get smart contract initial state and parameters

POST

https://zil.nownodes.io/

Retrieves the initial state (init) of a deployed smart contract by its address. This includes the contract’s parameters set during deployment.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string>required

Array with one parameter — smart contract address

Response

200OK

Smart contract initial state retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get smart contract initial state and parameters

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "vname": "owner",
      "type": "ByStr20",
      "value": "0xabcdef1234567890abcdef1234567890abcdef12"
    }
  ]
}

GetSmartContracts

Get list of deployed smart contracts

POST

https://zil.nownodes.io/

Retrieves a paginated list of smart contracts deployed on the Zilliqa blockchain. Supports optional parameters for pagination such as page number and limit.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<object>required

Parameters for pagination (optional)

Show child attributes

pageinteger

Page number starting from 1

limitinteger

Number of contracts to return per page

Response

200OK

List of smart contracts retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get list of deployed smart contracts

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "GetSmartContracts",
  "id": 1,
  "params": [
    {
      "page": 1,
      "limit": 10
    }
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "GetSmartContracts",
  "id": 1,
  "params": [
    {
      "page": 1,
      "limit": 10
    }
  ]
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "totalCount": 100,
    "page": 1,
    "limit": 10,
    "contracts": [
      {
        "address": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
        "codeHash": "0xabcdef1234567890abcdef1234567890abcdef12",
        "deployTxHash": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
        "timestamp": 1627889182
      }
    ]
  }
}

GetSmartContractState

Get current state of a smart contract

POST

https://zil.nownodes.io/

Retrieves the current state (fields and their values) of a smart contract deployed on the Zilliqa blockchain by its address.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string>required

Array containing the smart contract address as a string

Response

200OK

Current smart contract state retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get current state of a smart contract

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetSmartContractSubState

Get specific sub-state of a smart contract

POST

https://zil.nownodes.io/

Retrieves the value(s) of a specific field or subset of the state of a deployed smart contract by its address. The field name and optional keys for nested state access can be specified.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | Array<string>>required

Parameters array: - smart contract address (string) - field name (string) - optional keys array (array of strings)

Show child attributes

One of

string

Array<string>

Response

200OK

Smart contract sub-state retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get specific sub-state of a smart contract

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "GetSmartContractSubState",
  "id": 1,
  "params": [
    "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "balances",
    [
      "0xabcdef1234567890abcdef1234567890abcdef12"
    ]
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "GetSmartContractSubState",
  "id": 1,
  "params": [
    "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "balances",
    [
      "0xabcdef1234567890abcdef1234567890abcdef12"
    ]
  ]
}

200

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

GetSoftConfirmedTransaction

Get details of a soft-confirmed transaction

POST

https://zil.nownodes.io/

Retrieves details of a transaction that has been soft-confirmed on the Zilliqa network, identified by its transaction ID.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string>required

Array containing the transaction ID to query

Response

200OK

Soft-confirmed transaction details retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get details of a soft-confirmed transaction

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "tranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
    "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "receiver": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
    "amount": "1000000000000",
    "gasPrice": "1000000000",
    "gasLimit": 5000,
    "nonce": 10,
    "status": "SUCCESS",
    "timestamp": 1625247600
  }
}

GetStateProof

Get cryptographic state proof

POST

https://zil.nownodes.io/

Retrieves a cryptographic proof (Merkle proof) for a specific part of the blockchain state, such as a smart contract state or account state. Useful for verifying data integrity.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | Array<string>>required

Parameters to specify the target for the state proof (e.g., contract address and keys)

Show child attributes

One of

string

Array<string>

Response

200OK

State proof retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get cryptographic state proof

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "GetStateProof",
  "id": 1,
  "params": [
    "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "balances",
    [
      "0xabcdef1234567890abcdef1234567890abcdef12"
    ]
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "GetStateProof",
  "id": 1,
  "params": [
    "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
    "balances",
    [
      "0xabcdef1234567890abcdef1234567890abcdef12"
    ]
  ]
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "proof": [
      "0xabcdef1234567890abcdef1234567890abcdef12"
    ],
    "rootHash": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
    "leafHash": "0x5678abcd1234ef905678abcd1234ef905678abcd1234ef905678abcd1234ef90"
  }
}

GetTotalCoinSupply

Get total coin supply

POST

https://zil.nownodes.io/

Returns the total circulating supply of ZIL coins.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved total coin supply

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get total coin supply

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetTransactionsForTxBlock

Retrieve transactions for a transaction block

POST

https://zil.nownodes.io/

Returns a list of transactions included in a transaction block specified by the block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

The method name

idintegerrequired

Request identifier

paramsArray<integer>required

Array containing the transaction block number

Response

200OK

Successful response with list of transactions

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Retrieve transactions for a transaction block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "tranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "receiver": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "timestamp": 1625247600,
      "status": "SUCCESS"
    }
  ]
}

GetTransactionsForTxBlockEx

Get extended transactions for a transaction block

POST

https://zil.nownodes.io/

Retrieves detailed and extended information about transactions included in a specific transaction block, identified by the block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<integer>required

Array containing the transaction block number

Response

200OK

Extended transactions for the specified transaction block retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get extended transactions for a transaction block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "tranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "receiver": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "version": 1,
      "receipt": {
        "cumulative_gas": "10000",
        "epoch_num": 123,
        "success": true,
        "error_message": null
      },
      "logs": [
        {
          "address": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
          "topics": [
            "topic1",
            "topic2"
          ],
          "data": "0xdeadbeef"
        }
      ],
      "timestamp": 1625247600,
      "status": "SUCCESS"
    }
  ]
}

GetTransactionStatus

Get status of a transaction

POST

https://zil.nownodes.io/

Retrieves the current status of a transaction identified by its transaction ID.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string>required

Array containing the transaction ID to query

Response

200OK

Transaction status retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get status of a transaction

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetTxBlock

Get transaction block details by block number

POST

https://zil.nownodes.io/

Returns detailed information about a specific transaction block by its number.

Body

application/json

jsonrpcstring

JSON-RPC version

methodstring

Method name

idinteger

Request ID

paramsArray<integer>

Array with block number (height) as parameter

Parameters

blockNumintegerrequiredquery

Block number (height) of the Tx block to retrieve

Response

200OK

Successfully retrieved transaction block details

400Bad Request

Invalid request or missing blockNum parameter

404Not Found

Transaction block not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get transaction block details by block number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "header": {
      "blockNum": 12345,
      "prevBlockHash": "0xabcdef1234567890...",
      "timestamp": 1627889182,
      "txCount": 10,
      "dsBlockNum": 789,
      "gasLimit": "5000000"
    },
    "txs": [
      {
        "txID": "0x1234abcd5678ef90",
        "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
        "recipient": "zil1p9xtfkr6x0js4v5hj8q9k3j0e6p3vxtl7hsv8z",
        "amount": "1000000000000",
        "gasPrice": "1000000000",
        "gasUsed": "21000",
        "data": "0x"
      }
    ]
  }
}

GetTxBlockRate

Get transaction block creation rate

POST

https://zil.nownodes.io/

Returns the average rate at which transaction (Tx) blocks are created in the Zilliqa blockchain, typically measured in blocks per second or blocks per minute.

Body

application/json

jsonrpcstring

JSON-RPC version

methodstring

Method name

idinteger

Request ID

paramsarray

Parameters array (empty for this method)

Response

200OK

Successfully retrieved transaction block rate

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get transaction block creation rate

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

GetTxnBodiesForTxBlock

Get transaction bodies for a transaction block

POST

https://zil.nownodes.io/

Retrieves detailed transaction bodies included in a specific transaction block, identified by the block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<integer>required

Array containing the transaction block number

Response

200OK

Transaction bodies for the specified transaction block retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get transaction bodies for a transaction block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "tranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "receiver": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "timestamp": 1625247600,
      "status": "SUCCESS"
    }
  ]
}

GetTxnBodiesForTxBlockEx

Get extended transaction bodies for a transaction block

POST

https://zil.nownodes.io/

Retrieves detailed and extended information of transaction bodies included in a specific transaction block, identified by the block number.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<integer>required

Array containing the transaction block number

Response

200OK

Extended transaction bodies for the specified transaction block retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get extended transaction bodies for a transaction block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "tranID": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90",
      "sender": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
      "receiver": "zil1p8fss4jhh9e7k3fql89d2e2uzj4v9a0nxwucfa",
      "amount": "1000000000000",
      "gasPrice": "1000000000",
      "gasLimit": 5000,
      "nonce": 10,
      "version": 1,
      "receipt": {
        "cumulative_gas": "10000",
        "epoch_num": 123,
        "success": true,
        "error_message": null
      },
      "logs": [
        {
          "address": "zil1qyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszq",
          "topics": [
            "topic1",
            "topic2"
          ],
          "data": "0xdeadbeef"
        }
      ],
      "timestamp": 1625247600
    }
  ]
}

GetVersion

Get node software version

POST

https://zil.nownodes.io/

Returns the current node software version.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<string | integer | object | boolean>required

Parameters for the method (empty if none)

Show child attributes

One of

string

integer

object

boolean

Response

200OK

Successfully retrieved node version

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get node software version

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": "v6.1.0-rc1"
}

TxBlockListing

Get a list of transaction blocks

POST

https://zil.nownodes.io/

Returns a paginated list of transaction blocks. Supports parameters for pagination such as page number and limit.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request ID

paramsArray<object>required

Parameters for pagination (optional)

Show child attributes

pageinteger

Page number (starting from 1)

limitinteger

Number of blocks per page

Response

200OK

Transaction blocks listing retrieved successfully

400Bad Request

Invalid request

500Internal Server Error

Server error

Authorization

api-keyAuthapiKey in header

Get a list of transaction blocks

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "TxBlockListing",
  "id": 1,
  "params": [
    {
      "page": 1,
      "limit": 10
    }
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "TxBlockListing",
  "id": 1,
  "params": [
    {
      "page": 1,
      "limit": 10
    }
  ]
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "totalCount": 1000,
    "page": 1,
    "limit": 10,
    "blocks": [
      {
        "blockNum": 12345,
        "hash": "0xabcdef1234567890...",
        "timestamp": 1627889182,
        "txCount": 12
      }
    ]
  }
}

MAINNET / EVM

eth_accounts

Ethereum method - eth_accounts

POST

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

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

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

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

POST

https://zil.nownodes.io/

Returns the Ethereum coinbase address (i.e., the address that receives mining rewards).

Body

application/json

jsonrpcstringrequired

methodstringeth_coinbaserequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC Response with the coinbase address

Authorization

api-keyAuthapiKey in header

eth_coinbase

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_estimateGas

Estimate Gas for Transaction

POST

https://zil.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://zil.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://zil.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://zil.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_feeHistory

POST

https://zil.nownodes.io/

Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.

Body

application/json

jsonrpcstringrequired

methodstringrequired

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

Parameters:

blockCount — number of blocks in the requested range.
newestBlock — highest block number in the requested range (can be "latest").
rewardPercentiles — list of percentile values to sample priority fees from each block (optional).

Show child attributes

Any of

string

integer

Array<number>

idintegerrequired

Response

200OK

JSON-RPC Response with fee history data

Authorization

api-keyAuthapiKey in header

eth_feeHistory

curl -X POST 'https://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_feeHistory",
    "params": [
      "0x5",
      "latest",
      [
        10,
        50,
        90
      ]
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x5",
    "latest",
    [
      10,
      50,
      90
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x5",
    "latest",
    [
      10,
      50,
      90
    ]
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "oldestBlock": "0x10d4f",
    "baseFeePerGas": [
      "0x1dcd65000"
    ],
    "gasUsedRatio": [
      0.85
    ],
    "reward": [
      [
        "0x59682f00"
      ]
    ]
  }
}

eth_gasPrice

Get Suggested Gas Price

POST

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

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

Show child attributes

One of

Ethereum address

string

Block tag

string

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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": [
      "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_getBlockByHash

Get Block by Hash

POST

https://zil.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 | boolean>required

Array with 2 parameters:

Block hash (32-byte hex string with '0x' prefix)
Boolean to specify if full transaction objects are returned (true) or only transaction hashes (false)

Show child attributes

One of

Block hash (hex string)

string

Return full transaction objects if true; else return only transaction hashes

boolean

idintegerrequired

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

Get Block by Hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79"
  ],
  "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://zil.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 | boolean>required

Array with 2 parameters:

Block number (hex string, e.g., "0x1b4") or special tags ("latest", "earliest", "pending")
Boolean to specify if full transaction objects are returned (true) or only transaction hashes (false)

Show child attributes

One of

Block number as hex string or special tag

string

Return full transaction objects if true; else return only transaction hashes

boolean

idintegerrequired

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

Get Block by Number

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "0x1b4"
  ],
  "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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockReceipts",
    "params": [
      "0x10d4f"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockTransactionCountByHash",
    "params": [
      "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockTransactionCountByNumber",
    "params": [
      "0x10d4f"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getCode",
    "params": [
      "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getFilterChanges",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getFilterLogs",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

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

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

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByHash",
    "params": [
      "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": [
      "0x742d35cc6634c0532925a3b844bc454e4438f44e",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionReceipt",
    "params": [
      "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleByBlockHashAndIndex",
    "params": [
      "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
      "0x0"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleByBlockNumberAndIndex",
    "params": [
      "0x5daf3b",
      "0x0"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleCountByBlockHash",
    "params": [
      "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
    ],
    "id": 1
  }'

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleCountByBlockNumber",
    "params": [
      "0x10d4f"
    ],
    "id": 1
  }'

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

POST

https://zil.nownodes.io/

Returns the current mining hashrate reported by the client.

Body

application/json

jsonrpcstringrequired

methodstringeth_hashraterequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the current mining hashrate

Authorization

api-keyAuthapiKey in header

eth_hashrate

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_maxPriorityFeePerGas

Get recommended maxPriorityFeePerGas value

POST

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

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

POST

https://zil.nownodes.io/

Checks whether the Ethereum client is actively mining.

Body

application/json

jsonrpcstringrequired

methodstringeth_miningrequired

paramsarrayrequired

This method does not accept parameters.

idintegerrequired

Response

200OK

JSON-RPC Response indicating mining status

Authorization

api-keyAuthapiKey in header

eth_mining

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_newBlockFilter

Create a new block filter

POST

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

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

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendRawTransaction",
    "params": [
      "0xf86b808504a817c800825208940000000000000000000000000000000000000000880de0b6b3a76400008026a0980..."
    ],
    "id": 1
  }'

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

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

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_uninstallFilter",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

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

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

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

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

const response = await fetch('https://zil.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://zil.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://zil.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://zil.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "web3_sha3",
    "params": [
      "0x68656c6c6f"
    ],
    "id": 1
  }'

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

Documentation

Authentication

MAINNET / API-Reference

CreateTransaction

Body

Response

Authorization

DSBlockListing

Body

Response

Authorization

default

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

GetBalance

Body

Response

Authorization

GetBlockchainInfo

Body

Response

Authorization

GetContractAddressFromTransactionID

Body

Response

Authorization

GetCurrentDSComm

Body

Response

Authorization

GetCurrentDSEpoch