Ethereum JSON-RPC

v1.0.0

Base URL

https://fil.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

MAINNET / EVM

eth_accounts

Ethereum method - eth_accounts

POST

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

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

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

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

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

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

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

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array with 2 parameters:

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

idintegerrequired

Request ID

Response

200OK

Balance (in wei) as hex string

Authorization

api-keyAuthapiKey in header

Get ETH Balance of an Address

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_getBlockByHash

Get Block by Hash

POST

https://fil.nownodes.io/rpc/v1

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

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

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

idintegerrequired

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

Get Block by Hash

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_getBlockByNumber

Get Block by Number

POST

https://fil.nownodes.io/rpc/v1

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

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

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

idintegerrequired

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

Get Block by Number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_getBlockReceipts

Get All Transaction Receipts for a Block

POST

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

MAINNET / LOTUS

BeaconGetEntry

Filecoin.BeaconGetEntry

POST

https://fil.nownodes.io/rpc/v0

Returns the drand beacon entry that corresponds to the given Filecoin chain epoch. Each epoch maps to a specific drand round, and the returned entry contains the round number and the randomness data (signature) produced by the drand network.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<integer>required

Ordered list of parameters. Contains a single element: the Filecoin chain epoch (block height) for which to retrieve the beacon entry.

idintegerrequired

An identifier for this JSON-RPC request. The same value is echoed back in the response so the caller can correlate requests with responses.

Response

200OK

Successful response containing the beacon entry for the requested epoch.

Authorization

api-keyAuthapiKey in header

Filecoin.BeaconGetEntry

curl -X POST 'https://fil.nownodes.io/rpc/v0' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.BeaconGetEntry",
    "params": [
      3500000
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.BeaconGetEntry",
  "params": [
    3500000
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.BeaconGetEntry",
  "params": [
    3500000
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Round": 3595845,
    "Data": "puCJLBYbDtfh9v8W+ibQCosioetEi8JhLJ0J72NFJ4RR+u2dXfZSqfbGVRbf+BEsDN8CprLwUbOaMiW8lpZCHBkBbRiZleD9ebe6ErKX+lph26A6Osan29JGUfc2lITN"
  }
}

ChainBlockstoreInfo

Filecoin.ChainBlockstoreInfo

POST

https://fil.nownodes.io/rpc/v1

Returns some basic operational information about the underlying blockstore used by the Lotus node for storing chain and state data. This is useful for monitoring disk usage and compaction activity.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<any>required

This method takes no parameters. The params array must be empty.

idintegerrequired

An identifier for this JSON-RPC request. The same value is echoed back in the response.

Response

200OK

Successful response containing blockstore information.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainBlockstoreInfo

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainBlockstoreInfo",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainBlockstoreInfo",
  "params": [],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "base epoch": 5785269,
    "compacting": true,
    "compactions": 254,
    "hotstore size": 182067393682,
    "prunes": 0,
    "warmup epoch": 5194235
  }
}

ChainGetBlock

Filecoin.ChainGetBlock

POST

https://fil.nownodes.io/rpc/v1

Returns the block header identified by the given CID. The block header contains all consensus-critical fields including miner address, tickets, election proof, parent links, state roots, and signatures.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object>required

Ordered list of parameters. Contains a single CID object identifying the block to retrieve.

Show child attributes

/string

The CID string of the block header, encoded as a base32 CIDv1 (dag-cbor + blake2b-256).

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the full block header.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetBlock

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetBlock",
    "params": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetBlock",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetBlock",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Miner": "f02002827",
    "Ticket": {
      "VRFProof": "kcj56CB0589LTIvi052OCQ5ZeHI4pt3XUYtzLe40IyPyH3GQ4r47GMgD4DIfbHn9AcCDAHWfegEnm7gGVrzb/YLF3Tkcraslu1B2KiBd8DBQAz7rcF1tl8twcRRlW3Ad"
    },
    "ElectionProof": {
      "WinCount": 1,
      "VRFProof": "leF4NJylq3HbjG9nobNZyJlqkvG8T6K+5NpKL4VKZov+W+rQBssQQHXJ6+QsH8xVEDm+agfzHnGRVjeD1q/yCVpZa7odv8oJvO0ocHfRKnFQwSE+Bjgi82P/hOWmU/OL"
    },
    "BeaconEntries": [
      {
        "Round": 3595845,
        "Data": "puCJLBYbDtfh9v8W+ibQCosioetEi8JhLJ0J72NFJ4RR+u2dXfZSqfbGVRbf+BEsDN8CprLwUbOaMiW8lpZCHBkBbRiZleD9ebe6ErKX+lph26A6Osan29JGUfc2lITN"
      }
    ],
    "WinPoStProof": [
      {
        "PoStProof": 3,
        "ProofBytes": "uXxtjKmWCoPL6CAziWzCPlZaUQBgIxpp+GhPPvKj7oqzga9v3YShfOEL3jrsDuF5pFPBTn0fxlpe+bDsa5bILwMe89eJnCLCbt3IJHzAxkglDwp3bo+85KYwT7rN3zd6FZOoXfvgNdiVghN1N/l1Jgdh+mTwQhLqoa1UbgqRKnkzdVBB3FZTSGfEpGXrru/wsLgSKd3Zz3c4hUsgBJdO86WQPFaO0IFUzO9GDxS5lRhb51pU9EJzh1+thL9ypewe"
      }
    ],
    "Parents": [
      {
        "/": "bafy2bzacecp4opy4aewg6pajgni4qx5v3seofld5siocrwsszs66hbikd7bgo"
      },
      {
        "/": "bafy2bzaced4au4ib7c5mnm7ycgnougjgyc75w5vqktstllmayczwy7vrn4hyy"
      }
    ],
    "ParentWeight": "82903725898",
    "Height": 3500000,
    "ParentStateRoot": {
      "/": "bafy2bzacedhvvhg6wki77oakvpseypz4rsi52mzoau4qfgz4j6ooggpsmw3a6"
    },
    "ParentMessageReceipts": {
      "/": "bafy2bzaceaez4xikmcawdywsp5y3uepvh7nwyownkjksr6gyqaipz5xyxhnso"
    },
    "Messages": {
      "/": "bafy2bzacebxsunkmy3a3eye6k5eiw6eozukupphsvgdhtdgpfuxck6nfbu2xa"
    },
    "BLSAggregate": {
      "Type": 2,
      "Data": "rPybpYr4T9+d+6NoYKMqM+SWId0T2gKJFkDaI1tggDE1kWtbRWACiqhoiOsCaDT9CjHchsC7P5+jMWt3m+Vv0SL2vwRkf8haC//KZY0Gh3dQ+gvuH71umWreahUw8lfB"
    },
    "Timestamp": 1703306400,
    "BlockSig": {
      "Type": 2,
      "Data": "llqBnyFtcdNiolJlBCPk8Y++vIDQ/LKcEwWSPPTTqu5/d1RDrFkfQvujGVL/edW6Dcel0UwnNvnunoc+hqWfFsK2n7Oufu73pX6IVhFHRebd2srtAm64kIvkfb81t7j2"
    },
    "ForkSignaling": 0,
    "ParentBaseFee": "100"
  }
}

ChainGetBlockMessages

Filecoin.ChainGetBlockMessages

POST

https://fil.nownodes.io/rpc/v1

Returns all messages that were included in the block identified by the given CID. Messages are separated into BLS-signed and SECP256K1-signed categories. A combined list of all message CIDs is also returned.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object>required

Ordered list of parameters. Contains a single CID object identifying the block whose messages to retrieve.

Show child attributes

/string

The CID string of the block header.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing BLS messages, SECP256K1 signed messages, and a combined CID list.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetBlockMessages

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetBlockMessages",
    "params": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetBlockMessages",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetBlockMessages",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "BlsMessages": [
      {
        "Version": 0,
        "To": "f05",
        "From": "f02002827",
        "Nonce": 12345,
        "Value": "0",
        "GasLimit": 70000000,
        "GasFeeCap": "101",
        "GasPremium": "100",
        "Method": 5,
        "Params": null,
        "CID": {
          "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
        }
      }
    ],
    "SecpkMessages": [
      {
        "Message": {
          "Version": 0,
          "To": "f01234",
          "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
          "Nonce": 100,
          "Value": "1000000000000000000",
          "GasLimit": 10000000,
          "GasFeeCap": "101",
          "GasPremium": "100",
          "Method": 0,
          "Params": null,
          "CID": {
            "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
          }
        },
        "Signature": {
          "Type": 1,
          "Data": "FDNBM2hCQmHJLGh5ABQV..."
        },
        "CID": {
          "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
        }
      }
    ],
    "Cids": [
      {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      }
    ]
  }
}

ChainGetGenesis

Filecoin.ChainGetGenesis

POST

https://fil.nownodes.io/rpc/v1

Returns the genesis tipset, which is the very first tipset at epoch 0 that bootstraps the entire Filecoin blockchain. The genesis block contains the initial state of the network including the initial actor balances, verified registry, and system actors.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<any>required

This method takes no parameters. The params array must be empty.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the genesis tipset.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetGenesis

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetGenesis",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetGenesis",
  "params": [],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Cids": [
      {
        "/": "bafy2bzacecnamqgqmifpluoeldx7zzglxcljo6oja4vrmtj7432rphldpdmm2"
      }
    ],
    "Blocks": [
      {
        "Miner": "f00",
        "Ticket": {
          "VRFProof": "X4oDOWswmmD7fT0z3RNIPQVGS85f2dBhceeowoDiQhY="
        },
        "ElectionProof": {
          "WinCount": 0,
          "VRFProof": null
        },
        "BeaconEntries": [
          {
            "Round": 0,
            "Data": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
          }
        ],
        "WinPoStProof": null,
        "Parents": [
          {
            "/": "bafyreiaqpwbbyjo4a42saasj36kkrpv4tsherf2e7bvezkert2a7dhonoi"
          }
        ],
        "ParentWeight": "0",
        "Height": 0,
        "ParentStateRoot": {
          "/": "bafy2bzacech3yb7xlb7c57v2xh7rvmt4skeidk7z2g36llksaz4biflblbt24"
        },
        "ParentMessageReceipts": {
          "/": "bafy2bzacedswlcz5ddgqnyo3sak3jmhmkxashisnlpq6ujgyhe4mlobzpnhs6"
        },
        "Messages": {
          "/": "bafy2bzacecmda75ovposbdateg7eyhwij65zklgyijgcjwynlklmqazpwlhba"
        },
        "BLSAggregate": null,
        "Timestamp": 1598306400,
        "BlockSig": null,
        "ForkSignaling": 0,
        "ParentBaseFee": "100000000"
      }
    ],
    "Height": 0
  }
}

ChainGetMessage

Filecoin.ChainGetMessage

POST

https://fil.nownodes.io/rpc/v1

Reads a message from the chain blockstore by its CID. This returns the unsigned message body regardless of whether it was originally signed with BLS or SECP256K1. The message contains all fields necessary for execution including sender, recipient, value transfer, gas parameters, and actor method invocation details.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object>required

Ordered list of parameters. Contains a single CID object identifying the message to retrieve.

Show child attributes

/string

The CID string of the message.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the message.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetMessage

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetMessage",
    "params": [
      {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetMessage",
  "params": [
    {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetMessage",
  "params": [
    {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    }
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Version": 0,
    "To": "f01234",
    "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    "Nonce": 100,
    "Value": "1000000000000000000",
    "GasLimit": 10000000,
    "GasFeeCap": "101",
    "GasPremium": "100",
    "Method": 0,
    "Params": null,
    "CID": {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    }
  }
}

ChainGetMessagesInTipset

Filecoin.ChainGetMessagesInTipset

POST

https://fil.nownodes.io/rpc/v1

Returns all unique messages from all blocks in the specified tipset. Messages that appear in multiple blocks within the same tipset are de-duplicated (each message is returned only once). Each entry includes the message itself and its CID.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<Array<object>>required

Ordered list of parameters. Contains a single tipset key (array of block CIDs) identifying the tipset.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing de-duplicated messages from the tipset.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetMessagesInTipset

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetMessagesInTipset",
    "params": [
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ]
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetMessagesInTipset",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetMessagesInTipset",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "Cid": {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      },
      "Message": {
        "Version": 0,
        "To": "f01234",
        "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
        "Nonce": 100,
        "Value": "0",
        "GasLimit": 10000000,
        "GasFeeCap": "101",
        "GasPremium": "100",
        "Method": 0,
        "Params": null,
        "CID": {
          "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
        }
      }
    }
  ]
}

ChainGetNode

Filecoin.ChainGetNode

POST

https://fil.nownodes.io/rpc/v1

Fetches an IPLD (InterPlanetary Linked Data) node from the blockstore using a CID-based path. The path starts with a CID and may include slash-separated field names to traverse deeper into the CBOR DAG structure. Returns both the resolved CID and the deserialized object.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<string>required

Ordered list of parameters. Contains a single string: the IPLD path starting with a CID, optionally followed by slash-separated field names to traverse.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the resolved IPLD node.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetNode

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetNode",
    "params": [
      "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq/Messages"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetNode",
  "params": [
    "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq/Messages"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetNode",
  "params": [
    "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq/Messages"
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Cid": "bafy2bzacebxsunkmy3a3eye6k5eiw6eozukupphsvgdhtdgpfuxck6nfbu2xa",
    "Obj": {}
  }
}

ChainGetParentMessages

Filecoin.ChainGetParentMessages

POST

https://fil.nownodes.io/rpc/v1

Returns all messages from the parent tipset of the given block CID. These are the messages that were executed to produce the state that the given block builds on top of. Each entry includes the message CID and the full message body.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object>required

Ordered list of parameters. Contains a single CID object identifying the block whose parent messages to retrieve.

Show child attributes

/string

The CID string of the block.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the parent tipset's messages.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetParentMessages

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetParentMessages",
    "params": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetParentMessages",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetParentMessages",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "Cid": {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      },
      "Message": {
        "Version": 0,
        "To": "f01234",
        "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
        "Nonce": 100,
        "Value": "0",
        "GasLimit": 10000000,
        "GasFeeCap": "101",
        "GasPremium": "100",
        "Method": 0,
        "Params": null,
        "CID": {
          "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
        }
      }
    }
  ]
}

ChainGetParentReceipts

Filecoin.ChainGetParentReceipts

POST

https://fil.nownodes.io/rpc/v1

Returns the message execution receipts for all messages in the parent tipset of the given block. The receipts are ordered to correspond one-to-one with the messages returned by ChainGetParentMessages for the same block CID.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object>required

Ordered list of parameters. Contains a single CID object identifying the block whose parent receipts to retrieve.

Show child attributes

/string

The CID string of the block.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing an array of message execution receipts.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetParentReceipts

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetParentReceipts",
    "params": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetParentReceipts",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetParentReceipts",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "ExitCode": 0,
      "Return": null,
      "GasUsed": 3500000,
      "EventsRoot": {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      }
    }
  ]
}

ChainGetPath

Filecoin.ChainGetPath

POST

https://fil.nownodes.io/rpc/v1

Computes the path of tipset changes (revert and apply operations) required to traverse from one tipset to another. This is useful for determining what state transitions need to be undone and re-applied when the chain head changes, particularly during chain reorganizations.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<Array<object>>required

Ordered list of parameters containing two tipset keys. The first is the source tipset and the second is the destination tipset.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the path of head changes between the two tipsets.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetPath

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetPath",
    "params": [
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ],
      [
        {
          "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
        }
      ]
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetPath",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    [
      {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      }
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetPath",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    [
      {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      }
    ]
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "Type": "apply",
      "Val": {
        "Cids": [
          {
            "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
          }
        ],
        "Blocks": [
          {}
        ],
        "Height": 3500000
      }
    }
  ]
}

ChainGetRandomnessFromBeacon

Filecoin.ChainGetRandomnessFromBeacon

POST

https://fil.nownodes.io/rpc/v0

Returns randomness derived from the drand beacon at the specified epoch. The randomness is computed by hashing the beacon entry with a domain separation tag (personalization) and optional additional entropy. This is used for various protocol operations such as sector sealing and proof generation.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

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

Ordered list of parameters: tipset key, domain separation tag, epoch, and additional entropy.

Show child attributes

One of

Array<object>

Show child attributes

/string

CID of a block in the tipset.

Domain separation tag (DomainSeparationTag) - an integer that identifies the purpose of the randomness request to prevent cross-protocol attacks.

integer

The chain epoch at which to sample the beacon randomness.

integer

Base64-encoded additional entropy bytes to mix into the randomness derivation. Provides per-use uniqueness.

string

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the derived randomness value.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetRandomnessFromBeacon

curl -X POST 'https://fil.nownodes.io/rpc/v0' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetRandomnessFromBeacon",
    "params": [
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ],
      2,
      3500000,
      "Ynl0ZXM="
    ],
    "id": 1
  }'

const response = await fetch('https://fil.nownodes.io/rpc/v0', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "Filecoin.ChainGetRandomnessFromBeacon",
      "params": [
        [
          {
            "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
          }
        ],
        2,
        3500000,
        "Ynl0ZXM="
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetRandomnessFromBeacon",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    2,
    3500000,
    "Ynl0ZXM="
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetRandomnessFromBeacon",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    2,
    3500000,
    "Ynl0ZXM="
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "t9WGQHV7V/2GjNP3OH1NRnK2G5bGPFbVgfmRm/YMpVg="
}

ChainGetRandomnessFromTickets

Filecoin.ChainGetRandomnessFromTickets

POST

https://fil.nownodes.io/rpc/v0

Returns randomness derived from the chain tickets at the specified epoch. Ticket-based randomness uses the VRF ticket from block headers as the entropy source. The randomness is mixed with a domain separation tag and optional additional entropy for protocol-specific use.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

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

Ordered list of parameters: tipset key, domain separation tag, epoch, and additional entropy.

Show child attributes

One of

Array<object>

Show child attributes

/string

CID of a block in the tipset.

Domain separation tag (DomainSeparationTag) integer.

integer

The chain epoch at which to sample the ticket randomness.

integer

Base64-encoded additional entropy bytes.

string

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the derived randomness value.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetRandomnessFromTickets

curl -X POST 'https://fil.nownodes.io/rpc/v0' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetRandomnessFromTickets",
    "params": [
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ],
      1,
      3500000,
      "Ynl0ZXM="
    ],
    "id": 1
  }'

const response = await fetch('https://fil.nownodes.io/rpc/v0', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "Filecoin.ChainGetRandomnessFromTickets",
      "params": [
        [
          {
            "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
          }
        ],
        1,
        3500000,
        "Ynl0ZXM="
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetRandomnessFromTickets",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    1,
    3500000,
    "Ynl0ZXM="
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetRandomnessFromTickets",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    1,
    3500000,
    "Ynl0ZXM="
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "q1WGQHV7V/2GjNP3OH1NRnK2G5bGPFbVgfmRm/YMpVg="
}

ChainGetTipSet

Filecoin.ChainGetTipSet

POST

https://fil.nownodes.io/rpc/v1

Returns the tipset identified by the given tipset key (array of block CIDs). A tipset is the set of blocks that were mined at the same chain height by different miners. The returned object contains the CIDs, full block headers, and the epoch height.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<Array<object>>required

Ordered list of parameters. Contains a single tipset key (array of block CIDs).

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the full tipset.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetTipSet

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetTipSet",
    "params": [
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ]
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetTipSet",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetTipSet",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Cids": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "Blocks": [
      {}
    ],
    "Height": 3500000
  }
}

ChainGetTipSetAfterHeight

Filecoin.ChainGetTipSetAfterHeight

POST

https://fil.nownodes.io/rpc/v1

Returns the first non-null tipset at or after the specified epoch. If no blocks were mined at the exact requested height (a null round), it searches forward until it finds a tipset with blocks. The search starts from the given reference tipset.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<integer | Array<object>>required

Ordered list of parameters: the target epoch and a reference tipset key.

Show child attributes

One of

The target chain epoch (block height) at or after which to find a tipset.

integer

Array<object>

Show child attributes

/string

CID of a block in the tipset.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the tipset at or after the requested height.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetTipSetAfterHeight

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetTipSetAfterHeight",
    "params": [
      3500000,
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ]
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetTipSetAfterHeight",
  "params": [
    3500000,
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetTipSetAfterHeight",
  "params": [
    3500000,
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Cids": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "Blocks": [
      {}
    ],
    "Height": 3500000
  }
}

ChainGetTipSetByHeight

Filecoin.ChainGetTipSetByHeight

POST

https://fil.nownodes.io/rpc/v1

Returns the tipset at the specified chain epoch (height). If the tipset at the requested height is null (no blocks were mined at that epoch), it returns the most recent non-null tipset below the requested height. When the tipset key parameter is null, the current chain head is used as the reference point.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<integer | Array<object>>required

Ordered list of parameters: the target epoch and an optional reference tipset key.

Show child attributes

One of

The target chain epoch (block height).

integer

Array<object> | null

Show child attributes

/string

CID of a block in the tipset.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the tipset at the requested height.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainGetTipSetByHeight

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetTipSetByHeight",
    "params": [
      3500000,
      null
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetTipSetByHeight",
  "params": [
    3500000,
    null
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainGetTipSetByHeight",
  "params": [
    3500000,
    null
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Cids": [
      {
        "/": "bafy2bzaceddbenr2yziztsnl4jzxkdo4mlzf6h5fip4s4t2t2ymebiohl5z5c"
      },
      {
        "/": "bafy2bzaceblnztdrmihqnkqx6ktiqch655ai6ykwrt2m6p5nrjbr57ydv2k2e"
      },
      {
        "/": "bafy2bzacedmjvbzmuytqpwn2gykuweqabt4pfpjosas6xcyorjwfqhezxzjj6"
      },
      {
        "/": "bafy2bzacedww5xxb653wpthkzrozguw6cuzrg5e5f5hw4kqgfv5a7xu2feg4m"
      },
      {
        "/": "bafy2bzaceceacsuzsmccltjtsrmyypc3mr3ltpbczt3bjexqw6jax5xvdqrjg"
      },
      {
        "/": "bafy2bzacecyrsqstg5stqoyoa5vroogkaac6vydmpi2mfoon3a62qzpkihmni"
      },
      {
        "/": "bafy2bzacebbpvwugxjfk6jsa2q5k7fr7f34ljf7ngcqfytetag3n62kpjbsdo"
      },
      {
        "/": "bafy2bzaceai7swwvws4tmpq64pkxgel3yzmxgz5pi2xcv2qr7ipwxevp62oca"
      }
    ],
    "Blocks": [
      {
        "Miner": "f02002827",
        "Ticket": {
          "VRFProof": "kcj56CB0589LTIvi052OCQ5ZeHI4pt3XUYtzLe40IyPyH3GQ4r47GMgD4DIfbHn9AcCDAHWfegEnm7gGVrzb/YLF3Tkcraslu1B2KiBd8DBQAz7rcF1tl8twcRRlW3Ad"
        },
        "ElectionProof": {
          "WinCount": 1,
          "VRFProof": "leF4NJylq3HbjG9nobNZyJlqkvG8T6K+5NpKL4VKZov+W+rQBssQQHXJ6+QsH8xVEDm+agfzHnGRVjeD1q/yCVpZa7odv8oJvO0ocHfRKnFQwSE+Bjgi82P/hOWmU/OL"
        },
        "BeaconEntries": [
          {
            "Round": 3595845,
            "Data": "puCJLBYbDtfh9v8W+ibQCosioetEi8JhLJ0J72NFJ4RR+u2dXfZSqfbGVRbf+BEsDN8CprLwUbOaMiW8lpZCHBkBbRiZleD9ebe6ErKX+lph26A6Osan29JGUfc2lITN"
          }
        ],
        "WinPoStProof": [
          {
            "PoStProof": 3,
            "ProofBytes": "uXxtjKmWCoPL6CAziWzCPlZaUQBgIxpp+GhPPvKj7oqzga9v3YShfOEL3jrsDuF5pFPBTn0fxlpe+bDsa5bILwMe89eJnCLCbt3IJHzAxkglDwp3bo+85KYwT7rN3zd6FZOoXfvgNdiVghN1N/l1Jgdh+mTwQhLqoa1UbgqRKnkzdVBB3FZTSGfEpGXrru/wsLgSKd3Zz3c4hUsgBJdO86WQPFaO0IFUzO9GDxS5lRhb51pU9EJzh1+thL9ypewe"
          }
        ],
        "Parents": [
          {
            "/": "bafy2bzacecp4opy4aewg6pajgni4qx5v3seofld5siocrwsszs66hbikd7bgo"
          },
          {
            "/": "bafy2bzaced4au4ib7c5mnm7ycgnougjgyc75w5vqktstllmayczwy7vrn4hyy"
          }
        ],
        "ParentWeight": "82903725898",
        "Height": 3500000,
        "ParentStateRoot": {
          "/": "bafy2bzacedhvvhg6wki77oakvpseypz4rsi52mzoau4qfgz4j6ooggpsmw3a6"
        },
        "ParentMessageReceipts": {
          "/": "bafy2bzaceaez4xikmcawdywsp5y3uepvh7nwyownkjksr6gyqaipz5xyxhnso"
        },
        "Messages": {
          "/": "bafy2bzacebxsunkmy3a3eye6k5eiw6eozukupphsvgdhtdgpfuxck6nfbu2xa"
        },
        "BLSAggregate": {
          "Type": 2,
          "Data": "rPybpYr4T9+d+6NoYKMqM+SWId0T2gKJFkDaI1tggDE1kWtbRWACiqhoiOsCaDT9CjHchsC7P5+jMWt3m+Vv0SL2vwRkf8haC//KZY0Gh3dQ+gvuH71umWreahUw8lfB"
        },
        "Timestamp": 1703306400,
        "BlockSig": {
          "Type": 2,
          "Data": "llqBnyFtcdNiolJlBCPk8Y++vIDQ/LKcEwWSPPTTqu5/d1RDrFkfQvujGVL/edW6Dcel0UwnNvnunoc+hqWfFsK2n7Oufu73pX6IVhFHRebd2srtAm64kIvkfb81t7j2"
        },
        "ForkSignaling": 0,
        "ParentBaseFee": "100"
      }
    ],
    "Height": 3500000
  }
}

ChainHasObj

Filecoin.ChainHasObj

POST

https://fil.nownodes.io/rpc/v1

Checks whether a CBOR object identified by the given CID exists in the node's chain blockstore. Returns true if the object is present, false otherwise. This can be used to verify data availability before attempting to read it.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object>required

Ordered list of parameters. Contains a single CID object to check.

Show child attributes

/string

The CID string to look up in the blockstore.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response indicating whether the object exists.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainHasObj

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainHasObj",
    "params": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainHasObj",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainHasObj",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

200

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

ChainHead

Filecoin.ChainHead

POST

https://fil.nownodes.io/rpc/v1

Returns the current heaviest tipset (chain head) as tracked by this node. The chain head represents the latest consensus state of the Filecoin blockchain. It is updated every ~30 seconds as new blocks are produced.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<any>required

This method takes no parameters.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the current chain head tipset.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainHead

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainHead",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainHead",
  "params": [],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Cids": [
      {
        "/": "bafy2bzaceckjauv7cdrs6aj6oohdjd4vz4gc5c2e36duah245wtyrv6jqiife"
      },
      {
        "/": "bafy2bzacedfilxbnpt7wr6kc5jc3cyqgtzetrya4s5nqvggzdgmtvb2oljhhm"
      },
      {
        "/": "bafy2bzacebkq525eg6vh5e56atkfoohwj4wwutxgtfkguuouyrvtofirvhmfq"
      },
      {
        "/": "bafy2bzacedrqxhc4gzith64cb6faosenyvffhq6zsktnjrobyn7wv74quyncm"
      }
    ],
    "Blocks": [
      {
        "Miner": "f03161054",
        "Ticket": {
          "VRFProof": "mdr93QcpE2SC06HOEVCjgd0/8ti9jgPqVDFU3OWe0Lfiozgo8O2bDVTL8U+f3F3NDvjawCwHbbC+FJCVAornSza7RH/uhc/5LF+8zuTgz9zlqgpZu47tQIfa5f0dDOaw"
        },
        "ElectionProof": {
          "WinCount": 1,
          "VRFProof": "kI1BjxyLmfuHHwWF0GmpNHwSNeIaSvfyEXnBFndRtvtsRjfUF5MW7zv0nSBa/z0jEMa5ykkm0i7b/TEQN2fPjMKD6xh8xVbCPwxMggm4HQFyWDzVPkDlwBSSoL00zqTs"
        },
        "BeaconEntries": [
          {
            "Round": 26432632,
            "Data": "pPGyg2xtaKa1w8JmeCH7DBUAIVrbUvgvERATs3C4DRklmkDvYIuw0d+cW9ht8V34"
          }
        ],
        "WinPoStProof": [
          {
            "PoStProof": 3,
            "ProofBytes": "owmwp5OK/zcP09Caf/gf3SqtuO51h4FytkWQ6h7Sc8s9tsl3QgSHentWzL3sLW9OivDYlx2/191yCVy8dY3tZAtcD7VgaQRAHeBeOkh95Jq5AwPhFXK9uKcVPCm1NSfHCuEj3oH3YdqjKi9CKo3AN32GeRNTm1uloVk51pSkJc619j7FOhKuGYHZC4KAX8RqqJyDBaE8VjPj9qdcoh5B/stQlPnqrf7Ivy8WVobimCm5pmVnvt1/1/+ihU6Yf/4p"
          }
        ],
        "Parents": [
          {
            "/": "bafy2bzaceb2pcwegz567dscrrcwnjv65xiwcktaafimyvchcw46aquvd3rdvs"
          },
          {
            "/": "bafy2bzacec4bjidpolddqh6k22r75g2jj7aijssgwszjmohgjy7a5dhb53tcc"
          },
          {
            "/": "bafy2bzacebw5xltybc4pohierextz75ykxxjlr5lam4ckdhpfq7zxl3bhshqe"
          },
          {
            "/": "bafy2bzaceb5xhrjoiplvkat2dpg5lggjygi26ai36kvuaqs632w5jyjlp2vss"
          },
          {
            "/": "bafy2bzaceblpxqi2z4npwrh7d2qxdcgxua4tthetn74ihpd6iocfwtolofaxy"
          }
        ],
        "ParentWeight": "138604845913",
        "Height": 5793163,
        "ParentStateRoot": {
          "/": "bafy2bzacedbktmi2eh4gy2dnwnsnfoyowd4nvbi22j3zfx7swdrqmzybyz3i2"
        },
        "ParentMessageReceipts": {
          "/": "bafy2bzacea73k5imzhbrf5tpe76s7y5lmyex2byeebyvkrafzf5ix6vaftgoi"
        },
        "Messages": {
          "/": "bafy2bzacebcn4stlzbfdrtkgh4a5bf6iup3bciyaiqaadmtrl2pducvm62qai"
        },
        "BLSAggregate": {
          "Type": 2,
          "Data": "h8+iRBEcwIXRfJ+hGrkvB/Sa32aPSa3gOQMPwlCwe06FwE0F65UxeQnGO9rys4I0BpSIaPktYfAOEUIqABqO5AeXUfU3UTOtGJE9J0xA3yPIXspdt6zny7rN91+TuZ+8"
        },
        "Timestamp": 1772101290,
        "BlockSig": {
          "Type": 2,
          "Data": "g1Niy/wm/dFY1sGVVNVRnZv6QX4Vi50e9tH+VBSHFePg4tKWU3kmeszIfMHi93NHDvMbpQklLNr7+b2/YMp132xfFEprLca8+5gmUWqr8+KdYAipQKa9Vobxk3/EBlgu"
        },
        "ForkSignaling": 0,
        "ParentBaseFee": "100"
      }
    ],
    "Height": 5793163
  }
}

ChainReadObj

Filecoin.ChainReadObj

POST

https://fil.nownodes.io/rpc/v1

Reads the raw CBOR-encoded bytes of an object from the chain blockstore identified by its CID. Returns the raw bytes as a base64-encoded string. This is a low-level method useful for debugging or when you need the raw serialized form of an on-chain object.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object>required

Ordered list of parameters. Contains a single CID object.

Show child attributes

/string

CID string of the object.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the raw CBOR bytes of the object.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainReadObj

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainReadObj",
    "params": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainReadObj",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainReadObj",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    }
  ],
  "id": 1
}

200

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

ChainStatObj

Filecoin.ChainStatObj

POST

https://fil.nownodes.io/rpc/v1

Computes statistics (total size in bytes and number of IPLD links) for the DAG (Directed Acyclic Graph) rooted at the first CID parameter. If a second CID is provided, it returns the stats for the difference between the two DAGs (i.e., objects reachable from the first CID but not from the second).

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object>required

Ordered list of parameters: the target CID and a base CID for computing the diff.

Show child attributes

/string

CID string.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing DAG statistics.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainStatObj

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainStatObj",
    "params": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      },
      {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainStatObj",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    },
    {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainStatObj",
  "params": [
    {
      "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
    },
    {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    }
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Size": 1458236,
    "Links": 8750
  }
}

ChainTipSetWeight

Filecoin.ChainTipSetWeight

POST

https://fil.nownodes.io/rpc/v1

Computes and returns the chain weight of the specified tipset. Weight is a measure of the total amount of work contributed to the chain up to and including this tipset. It is used by the expected consensus protocol to determine the heaviest (canonical) chain.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<Array<object>>required

Ordered list of parameters. Contains a single tipset key.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the tipset weight.

Authorization

api-keyAuthapiKey in header

Filecoin.ChainTipSetWeight

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainTipSetWeight",
    "params": [
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ]
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainTipSetWeight",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainTipSetWeight",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

200

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

Discover

Filecoin.Discover

POST

https://fil.nownodes.io/rpc/v1

Returns the OpenRPC service discovery document for the Lotus RPC API. This document describes all available methods, their parameters, result types, and links to source code. It follows the OpenRPC specification and can be used by tools to auto-generate client libraries or documentation.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<any>required

This method takes no parameters.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the OpenRPC discovery document.

Authorization

api-keyAuthapiKey in header

Filecoin.Discover

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.Discover",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.Discover",
  "params": [],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "info": {
      "title": "Lotus RPC API",
      "version": "1.35.0"
    },
    "methods": [
      {
        "deprecated": false,
        "description": "```go\nfunc (s *FullNodeStruct) ChainBlockstoreInfo...",
        "externalDocs": {
          "description": "Github remote link",
          "url": "https://github.com/filecoin-project/lotus/blob/master/api/proxy_gen.go#L1368"
        },
        "name": "Filecoin.ChainBlockstoreInfo",
        "paramStructure": "by-position",
        "params": [
          {
            "deprecated": false,
            "description": "cid.Cid",
            "name": "p1",
            "required": true,
            "schema": {},
            "summary": ""
          }
        ],
        "result": {
          "deprecated": false,
          "description": "map[string]interface{}",
          "name": "map[string]interface{}",
          "required": true,
          "schema": {},
          "summary": ""
        },
        "summary": "ChainBlockstoreInfo returns some basic information about the blockstore\n"
      }
    ]
  }
}

ID

Filecoin.ID

POST

https://fil.nownodes.io/rpc/v1

Returns the libp2p peer identity (Peer ID) of this Filecoin node. The Peer ID is a unique cryptographic identifier derived from the node's public key and is used for peer-to-peer network communication, peer discovery, and connection authentication.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<any>required

This method takes no parameters.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the node's libp2p peer ID.

Authorization

api-keyAuthapiKey in header

Filecoin.ID

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ID",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.ID",
  "params": [],
  "id": 1
}

200

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

MinerGetBaseInfo

Filecoin.MinerGetBaseInfo

POST

https://fil.nownodes.io/rpc/v1

Returns mining base information for a specific miner at a given epoch, looking back from the provided tipset. This includes the miner's power, the sectors eligible for winning PoSt, and the beacon entries needed to construct a valid block. Returns null if the miner has no power at the given tipset.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

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

Ordered list of parameters: miner address, target epoch, and reference tipset key.

Show child attributes

One of

The miner (storage provider) address to query.

string

The chain epoch for which to compute mining base info.

integer

Array<object>

Show child attributes

/string

CID of a block in the tipset.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing mining base info, or null if the miner has no eligible power.

Authorization

api-keyAuthapiKey in header

Filecoin.MinerGetBaseInfo

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.MinerGetBaseInfo",
    "params": [
      "f01234",
      3500000,
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ]
    ],
    "id": 1
  }'

const response = await fetch('https://fil.nownodes.io/rpc/v1', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "Filecoin.MinerGetBaseInfo",
      "params": [
        "f01234",
        3500000,
        [
          {
            "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
          }
        ]
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.MinerGetBaseInfo",
  "params": [
    "f01234",
    3500000,
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.MinerGetBaseInfo",
  "params": [
    "f01234",
    3500000,
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "MinerPower": "1125899906842624",
    "NetworkPower": "30584230297960448000",
    "Sectors": [
      {
        "SealProof": 8,
        "SectorNumber": 1,
        "SectorKey": {},
        "SealedCID": {
          "/": "bagboea4b5abcbicxvg..."
        }
      }
    ],
    "WorkerKey": "f3abc...",
    "SectorSize": 34359738368,
    "PrevBeaconEntry": {
      "Round": 3595845,
      "Data": "puCJLBYbDtfh9v8W+ibQCosioetEi8JhLJ0J72NFJ4RR+u2dXfZSqfbGVRbf+BEsDN8CprLwUbOaMiW8lpZCHBkBbRiZleD9ebe6ErKX+lph26A6Osan29JGUfc2lITN"
    },
    "BeaconEntries": [
      {
        "Round": 3595846,
        "Data": "abc123..."
      }
    ],
    "EligibleForMining": true
  }
}

MpoolGetNonce

Filecoin.MpoolGetNonce

POST

https://fil.nownodes.io/rpc/v1

Returns the next available nonce for the specified address. This takes into account both the confirmed on-chain nonce and any pending messages in the local message pool (mempool). The returned nonce is the value that should be used for the next message from this address.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<string>required

Ordered list of parameters. Contains a single address string.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the next nonce.

Authorization

api-keyAuthapiKey in header

Filecoin.MpoolGetNonce

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.MpoolGetNonce",
    "params": [
      "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.MpoolGetNonce",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.MpoolGetNonce",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za"
  ],
  "id": 1
}

200

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

MpoolPending

Filecoin.MpoolPending

POST

https://fil.nownodes.io/rpc/v1

Returns all pending messages in the message pool that are valid for the specified tipset. The message pool (mpool) is a local cache of pending messages that miners use to select transactions for inclusion in new blocks. Messages remain in the pool until they are included in a block, replaced by a higher gas message, or pruned.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<Array<object>>required

Ordered list of parameters. Contains a single tipset key which specifies the chain state for message validity check.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing array of pending signed messages.

Authorization

api-keyAuthapiKey in header

Filecoin.MpoolPending

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.MpoolPending",
    "params": [
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ]
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.MpoolPending",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.MpoolPending",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ]
  ],
  "id": 1
}

200

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

StateAccountKey

Filecoin.StateAccountKey

POST

https://fil.nownodes.io/rpc/v1

Returns the public key address (f1 or f3) associated with an account actor. This method resolves ID addresses (f0) to their corresponding public key addresses. It only works for account actors; calling it on non-account actors (miners, multisigs, etc.) will result in an error.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<string | array>required

Ordered list of parameters containing the address to lookup and an optional tipset key.

Show child attributes

One of

The Filecoin address to resolve. Can be f0, f1, or f3 format. For f1/f3, returns the same address.

string

TipSet key for state context. Use null for current head.

array | null

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the public key address.

Authorization

api-keyAuthapiKey in header

Filecoin.StateAccountKey

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateAccountKey",
    "params": [
      "f0123456",
      null
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.StateAccountKey",
  "params": [
    "f0123456",
    null
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.StateAccountKey",
  "params": [
    "f0123456",
    null
  ],
  "id": 1
}

200

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

StateCall

Filecoin.StateCall

POST

https://fil.nownodes.io/rpc/v1

Performs a dry-run execution of a message against the specified chain state without persisting any changes. This is useful for gas estimation, testing contract calls, debugging failed transactions, and validating message parameters before actual submission.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object | array>required

Ordered list containing the message to simulate and an optional tipset key for state context.

Show child attributes

One of

Versioninteger

Message format version (always 0).

Tostring

Target actor address.

Fromstring

Sender address (must exist on-chain).

Nonceinteger

Message nonce (can be any value for simulation).

Valuestring

Transfer amount in attoFIL.

GasLimitinteger

Maximum gas for execution.

GasFeeCapstring

Max fee per gas (can be "0" for simulation).

GasPremiumstring

Priority fee per gas (can be "0" for simulation).

Methodinteger

Actor method number to invoke.

Paramsstring | null

CBOR-encoded method parameters (Base64).

TipSet key for state context. Null uses chain head.

array | null

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response with detailed execution results.

Authorization

api-keyAuthapiKey in header

Filecoin.StateCall

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateCall",
    "params": [
      {
        "Version": 0,
        "To": "f01234",
        "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
        "Nonce": 0,
        "Value": "0",
        "GasLimit": 10000000,
        "GasFeeCap": "0",
        "GasPremium": "0",
        "Method": 0,
        "Params": null
      },
      null
    ],
    "id": 1
  }'

const response = await fetch('https://fil.nownodes.io/rpc/v1', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "Filecoin.StateCall",
      "params": [
        {
          "Version": 0,
          "To": "f01234",
          "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
          "Nonce": 0,
          "Value": "0",
          "GasLimit": 10000000,
          "GasFeeCap": "0",
          "GasPremium": "0",
          "Method": 0,
          "Params": null
        },
        null
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.StateCall",
  "params": [
    {
      "Version": 0,
      "To": "f01234",
      "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      "Nonce": 0,
      "Value": "0",
      "GasLimit": 10000000,
      "GasFeeCap": "0",
      "GasPremium": "0",
      "Method": 0,
      "Params": None
    },
    null
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.StateCall",
  "params": [
    {
      "Version": 0,
      "To": "f01234",
      "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      "Nonce": 0,
      "Value": "0",
      "GasLimit": 10000000,
      "GasFeeCap": "0",
      "GasPremium": "0",
      "Method": 0,
      "Params": null
    },
    null
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "MsgCid": {
      "/": "bafy2bzaceb6nbpdoa63zxbfck22sxvkusmk3jizh7widc7cohn7sus23no5cs"
    },
    "Msg": {
      "Version": 0,
      "To": "f01234",
      "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      "Nonce": 963734,
      "Value": "0",
      "GasLimit": 4611686018427388000,
      "GasFeeCap": "0",
      "GasPremium": "0",
      "Method": 0,
      "Params": null,
      "CID": {
        "/": "bafy2bzaceb6nbpdoa63zxbfck22sxvkusmk3jizh7widc7cohn7sus23no5cs"
      }
    },
    "MsgRct": {
      "ExitCode": 0,
      "Return": null,
      "GasUsed": 0,
      "EventsRoot": null
    },
    "GasCost": {
      "Message": null,
      "GasUsed": "0",
      "BaseFeeBurn": "0",
      "OverEstimationBurn": "0",
      "MinerPenalty": "0",
      "MinerTip": "0",
      "Refund": "0",
      "TotalCost": "0"
    },
    "ExecutionTrace": {
      "Msg": {
        "From": "f033259",
        "To": "f01234",
        "Value": "0",
        "Method": 0,
        "Params": null,
        "ParamsCodec": 0,
        "GasLimit": 9223372036854776,
        "ReadOnly": false
      },
      "MsgRct": {
        "ExitCode": 0,
        "Return": null,
        "ReturnCodec": 0
      },
      "InvokedActor": {
        "Id": 1234,
        "State": {
          "Code": {
            "/": "bafk2bzaceautzxqsrstcxerpxtykn4syogslbiwpsfoh562jex262vxeluc4w"
          },
          "Head": {
            "/": "bafy2bzacedqnjnstx2h4ytcuzmh23tcvfh4ez7pu67mz76b5qotrpxhosmngq"
          },
          "Nonce": 0,
          "Balance": "0",
          "DelegatedAddress": null
        }
      },
      "GasCharges": [
        {
          "Name": "none",
          "tg": 0,
          "cg": 0,
          "sg": 0,
          "tt": 0
        }
      ],
      "Subcalls": null
    },
    "Error": "",
    "Duration": 1970507
  }
}

StateLookupID

Filecoin.StateLookupID

POST

https://fil.nownodes.io/rpc/v1

Resolves any Filecoin address to its corresponding on-chain ID address (f0 format). ID addresses are compact numeric identifiers assigned to actors when they are created on-chain. This method is useful for normalizing addresses, optimizing message size, and looking up actor state. Returns an error if the address does not exist on-chain.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<string | array>required

Ordered list containing the address to resolve and an optional tipset key for state context.

Show child attributes

One of

The Filecoin address to resolve. Supports f1, f2, f3, and f4 formats. f0 addresses are returned as-is.

string

TipSet key for state context. Use null for current head.

array | null

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the ID address.

Authorization

api-keyAuthapiKey in header

Filecoin.StateLookupID

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateLookupID",
    "params": [
      "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      null
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.StateLookupID",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    null
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.StateLookupID",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    null
  ],
  "id": 1
}

200

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

StateReadState

Filecoin.StateReadState

POST

https://fil.nownodes.io/rpc/v1

Reads the complete state of an actor from the chain state tree. Returns the actor's balance, code CID (which determines the actor type), and internal state data. The state structure varies depending on the actor type (account, miner, multisig, payment channel, etc.).

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<string | array>required

Ordered list containing the actor address and an optional tipset key for state context.

Show child attributes

One of

The address of the actor whose state to read. Can be any valid Filecoin address format.

string

TipSet key for state context. Use null for current head.

array | null

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the actor's state.

Authorization

api-keyAuthapiKey in header

Filecoin.StateReadState

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateReadState",
    "params": [
      "f01234",
      null
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.StateReadState",
  "params": [
    "f01234",
    null
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.StateReadState",
  "params": [
    "f01234",
    null
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Balance": "0",
    "Code": {
      "/": "bafk2bzaceautzxqsrstcxerpxtykn4syogslbiwpsfoh562jex262vxeluc4w"
    },
    "State": {
      "Info": {
        "/": "bafy2bzacebr6djrnzgpf7fc5pvmke6wwufmfldcosovr6cb5bkmw5nomxorjc"
      },
      "PreCommitDeposits": "0",
      "LockedFunds": "0",
      "VestingFunds": null,
      "FeeDebt": "0",
      "InitialPledge": "0",
      "PreCommittedSectors": {
        "/": "bafy2bzaceamp42wmmgr2g2ymg46euououzfyck7szknvfacqscohrvaikwfay"
      },
      "PreCommittedSectorsCleanUp": {
        "/": "bafy2bzaceaa2jny7gkgdwnid4kuldau6bnvgyss5bszo4uy6uikrncvdu5mc2"
      },
      "AllocatedSectors": {
        "/": "bafy2bzacedgt3fssxtvxnnlrmcwshsf3lyzts52ca744ujq4uwqlzwkst4rcm"
      },
      "Sectors": {
        "/": "bafy2bzaceb47p7svfxpwp7bclt6og7kl73fvrz2fd6owhecugnci55zbcfwd2"
      },
      "ProvingPeriodStart": 3120720,
      "CurrentDeadline": 1,
      "Deadlines": {
        "/": "bafy2bzacedogdgi67tk44dhdetx7mvx65kgb3v4o47gf6xsmejaiwi672n476"
      },
      "EarlyTerminations": [
        0
      ],
      "DeadlineCronActive": false
    }
  }
}

StateReplay

Filecoin.StateReplay

POST

https://fil.nownodes.io/rpc/v1

Re-executes a message that was already included in the chain to retrieve detailed execution information including traces and gas costs. Unlike StateSearchMsg which returns the stored receipt, StateReplay actually re-runs the execution providing full traces for debugging and analysis.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<Array<object> | object>required

Ordered list containing the tipset key for execution context and the message CID to replay.

Show child attributes

One of

Array<object> | null

Show child attributes

/string

Block CID.

/string

Message CID.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response with execution replay results. Structure is identical to StateCall response including message, receipt, gas costs, and full execution traces.

Authorization

api-keyAuthapiKey in header

Filecoin.StateReplay

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateReplay",
    "params": [
      [
        {
          "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
        }
      ],
      {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      }
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.StateReplay",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.StateReplay",
  "params": [
    [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    }
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "MsgCid": {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    },
    "Msg": {
      "Version": 0,
      "To": "f01234",
      "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      "Nonce": 42,
      "Value": "1000000000000000000",
      "GasLimit": 10000000,
      "GasFeeCap": "1500000000",
      "GasPremium": "1000000",
      "Method": 0,
      "Params": null
    },
    "MsgRct": {
      "ExitCode": 0,
      "Return": null,
      "GasUsed": 435623,
      "EventsRoot": null
    },
    "GasCost": {
      "GasUsed": "435623",
      "BaseFeeBurn": "4356230000000",
      "OverEstimationBurn": "12345600000",
      "MinerPenalty": "0",
      "MinerTip": "435623000",
      "Refund": "95327740000000",
      "TotalCost": "4804476600000"
    },
    "ExecutionTrace": {
      "Msg": {
        "From": "f033259",
        "To": "f01234",
        "Value": "1000000000000000000",
        "Method": 0
      },
      "MsgRct": {
        "ExitCode": 0,
        "Return": null
      },
      "GasCharges": [],
      "Subcalls": null
    },
    "Error": "",
    "Duration": 45678901
  }
}

StateSearchMsg

Filecoin.StateSearchMsg

POST

https://fil.nownodes.io/rpc/v1

Searches the blockchain for a message by its CID and returns the message receipt along with the tipset where it was included. The search starts from the specified tipset and proceeds backwards. Can optionally find messages that were replaced by another message with the same nonce but higher gas.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<array | object | integer | boolean>required

Ordered list containing tipset key, message CID, lookback limit, and allowReplaced flag.

Show child attributes

One of

TipSet key to start search from. Use null for chain head.

array | null

/string

Message CID.

Maximum epochs to search backwards. Use -1 for unlimited (search to genesis).

integer

Whether to return info if the message was replaced by another message with same sender/nonce.

boolean

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing message lookup result. Returns null if the message was not found within the search range.

Authorization

api-keyAuthapiKey in header

Filecoin.StateSearchMsg

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateSearchMsg",
    "params": [
      null,
      {
        "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
      },
      -1,
      true
    ],
    "id": 1
  }'

const response = await fetch('https://fil.nownodes.io/rpc/v1', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "Filecoin.StateSearchMsg",
      "params": [
        null,
        {
          "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
        },
        -1,
        true
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.StateSearchMsg",
  "params": [
    null,
    {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    },
    -1,
    true
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.StateSearchMsg",
  "params": [
    null,
    {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    },
    -1,
    true
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Message": {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    },
    "Receipt": {
      "ExitCode": 0,
      "Return": null,
      "GasUsed": 435623,
      "EventsRoot": null
    },
    "ReturnDec": null,
    "TipSet": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "Height": 3500000
  }
}

WalletBalance

Filecoin.WalletBalance

POST

https://fil.nownodes.io/rpc/v1

Returns the current FIL balance for any Filecoin address. The balance is returned in attoFIL (the smallest unit, where 1 FIL = 10^18 attoFIL). Supports all address types including f0 (ID), f1 (SECP256K1), f2 (Actor), f3 (BLS), and f4 (Delegated/Ethereum-compatible).

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<string>required

Ordered list of parameters. Contains a single address string.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the account balance.

Authorization

api-keyAuthapiKey in header

Filecoin.WalletBalance

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.WalletBalance",
    "params": [
      "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.WalletBalance",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "Filecoin.WalletBalance",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za"
  ],
  "id": 1
}

200

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

Documentation

Authentication

MAINNET / EVM

eth_accounts

Body

Response

Authorization

eth_blockNumber

Body

Response

Authorization

eth_call

Body

Response

Authorization

eth_chainId

Body

Response

Authorization

eth_coinbase

Body

Response

Authorization

eth_estimateGas

Body

Response

Authorization

eth_feeHistory

Body

Response

Authorization

eth_gasPrice

Body

Response

Authorization

eth_getBalance

Body

Response

Authorization

eth_getBlockByHash

Body

Response

Authorization

eth_getBlockByNumber

Body

Response

Authorization

eth_getBlockReceipts

Body

Response

Authorization

eth_getBlockTransactionCountByHash

Body

Response

Authorization

eth_getBlockTransactionCountByNumber

Body

Response

Authorization

eth_getCode

Body

Response

Authorization

eth_getFilterChanges

Body

Response

Authorization

eth_getFilterLogs

Body

Response

Authorization

eth_getLogs

Body

Response

Authorization

eth_getStorageAt

Body

Response

Authorization

eth_getTransactionByBlockHashAndIndex