📘
Supported on BASE (mainnet) only.

API Endpoint

The format of a BASE API endpoint is
https://open-platform.nodereal.io/{{apiKey}}/base/

Here is an example:
https://open-platform.nodereal.io/4c0a1c23661a4e26bcbcwed461e34ea9/base/

Ethereum JSON-RPC API

eth_accounts

Returns an array of addresses owned by the client.

Parameters

N/A

Returns

An array of addresses owned by the client

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_accounts","id":1,"jsonrpc":"2.0"}'

eth_blockNumber

Returns the latest block number of the blockchain.

Parameters

N/A

Returns

An integer value of the latest block number encoded as hexadecimal

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_blockNumber","params":[],"id":1,"jsonrpc":"2.0"}'

eth_call

Executes a new message call immediately without creating a transaction on the blockchain.

Parameters

transaction- object - The transaction call object which contains the following fields:
- from- string - (optional) The address from which the transaction is sent
- to- string - The address to which the transaction is addressed
- gas- integer - (optional) The integer of gas provided for the transaction execution
- gasPrice- integer - (optional) The integer of gasPrice used for each paid gas encoded as hexadecimal
- value- integer - (optional) The integer of value sent with this transaction encoded as hexadecimal
- data- string - (optional) The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation
blockNumber/tag - string - The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized

Returns

data- The return value of the executed contract method

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_call","params":[{"from":null,"to":"0x6b175474e89094c44da98b954eedeac495271d0f","data":"0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"}, "latest"],"id":1,"jsonrpc":"2.0"}'

eth_chainId

Returns the current network/chain ID, used to sign replay-protected transaction introduced in EIP-155.

Parameters

N/A

Returns

It returns a hexadecimal value in string format which represents an integer of the chain ID

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_chainId","params":[],"id":1,"jsonrpc":"2.0"}'

eth_estimateGas

Returns an estimation of gas for a given transaction.

Parameters

transaction- object - The transaction call object:
- from- string - (optional) The address from which the transaction is sent
- to- string - The address to which the transaction is addressed
- gas- integer - (optional) The integer of gas provided for the transaction execution
- gasPrice- integer - (optional) The integer of gasPrice used for each paid gas encoded as hexadecimal
- value- integer - (optional) The integer of value sent with this transaction encoded as hexadecimal
- data- string - (optional) The hash of the method signature and encoded parameters.

Returns

quantity- The estimated amount of gas used

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_estimateGas","params":[{"from":"0x8D97689C9818892B700e27F316cc3E41e17fBeb9","to":"0xd3CdA913deB6f67967B99D67aCDFa1712C293601","value":"0x186a0"}],"id":1,"jsonrpc":"2.0"}'

eth_feeHistory

Returns the collection of historical gas information.

Parameters

blockCount- string/integer - The number of blocks in the requested range. Between 1 and 1024 blocks can be requested in a single query. It will return less than the requested range if not all blocks are available
newestBlock- string - The highest number block of the requested range in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
rewardPercentiles- integer - A list of percentile values with a monotonic increase in value. The transactions will be ranked by effective tip per gas for each block in the requested range, and the corresponding effective tip for the percentile will be calculated while taking gas consumption into consideration

Returns

oldestBlock- The lowest number block of the returned range encoded in hexadecimal format
baseFeePerGas- An array of block base fees per gas. This includes the next block after the newest of the returned range, because this value can be derived from the newest block. Zeroes are returned for pre-EIP-1559 blocks
gasUsedRatio- An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit
reward- (Optional) An array of effective priority fees per gas data points from a single block. All zeroes are returned if the block is empty

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_feeHistory","params":[4, "latest", [25, 75]],"id":1,"jsonrpc":"2.0"}'

eth_gasPrice

Returns the current gas price on the network in wei.

Parameters

N/A

Returns

The hexadecimal value of the current gas price in wei

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_gasPrice","params":[],"id":1,"jsonrpc":"2.0"}'

eth_getBalance

Returns the balance of given account address in wei.

Parameters

address- string - The address (20 bytes) to check for balance
blockNumber/tag - string - The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized

Returns

result- The ETH balance of the specified address in hexadecimal value, measured in wei

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBalance","params":["0x622Fbe99b3A378FAC736bf29d7e23B85E18816eB", "latest"],"id":1,"jsonrpc":"2.0"}'

eth_getBlockByHash

Returns information of the block matching the given block hash.

Parameters

hash - string - The hash (32 bytes) of the block
transaction detail flag - boolean - (default: false) It returns the full transaction objects when it is true otherwise it returns only the hashes of the transactions

Returns

object- A block object, or null when no block was found
- baseFeePerGas- A string of the base fee encoded in hexadecimal format. Please note that this response field will not be included in a block requested before the EIP-1559 upgrade
- difficulty-The integer of the difficulty for this block encoded as a hexadecimal
- extraData- The “extra data” field of this block
- gasLimit- The maximum gas allowed in this block encoded as a hexadecimal
- gasUsed- The total used gas by all transactions in this block encoded as a hexadecimal
- hash- The block hash of the requested block. null if pending
- l1BatchNumber- The L1 batch number of the block
- l1BatchTimestamp- The L1 batch timestamp of the block
- logsBloom- The bloom filter for the logs of the block. null if pending
- miner- The address of the beneficiary to whom the mining rewards were given
- mixHash- A string of a 256-bit hash encoded as a hexadecimal
- nonce- The hash of the generated proof-of-work. null if pending
- number- The block number of the requested block encoded as a hexadecimal. null if pending
- parentHash- The hash of the parent block
- receiptsRoot- The root of the receipts trie of the block
- sha3Uncles- The SHA3 of the uncles data in the block
- size- The size of this block in bytes as an Integer value encoded as hexadecimal
- stateRoot- The root of the final state trie of the block
- timestamp- The unix timestamp for when the block was collated
- totalDifficulty- The integer of the total difficulty of the chain until this block encoded as a hexadecimal
- transactions- An array of transaction objects - please see eth_getTransactionByHash for exact shape
- transactionsRoot- The root of the transaction trie of the block
- uncles- An array of uncle hashes

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBlockByHash","params":["0x8125d2cdb126d1eb9c40bd3a3a1c00633d5698c0af4dfa90ef2ad32ba81b6f52",false],"id":1,"jsonrpc":"2.0"}'

eth_getBlockByNumber

Returns information of the block matching the given block number.

Parameters

blockNumber/tag - string - The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized
transaction detail flag - boolean - (default: false) The method returns the full transaction objects when this value is true otherwise, it returns only the hashes of the transactions

Returns

object- A block object, or null when no block was found
- baseFeePerGas- A string of the base fee encoded in hexadecimal format. Please note that this response field will not be included in a block requested before the EIP-1559 upgrade
- difficulty-The integer of the difficulty for this block encoded as a hexadecimal
- extraData- The “extra data” field of this block
- gasLimit- The maximum gas allowed in this block encoded as a hexadecimal
- gasUsed- The total used gas by all transactions in this block encoded as a hexadecimal
- hash- The block hash of the requested block. null if pending
- l1BatchNumber- The L1 batch number of the block
- l1BatchTimestamp- The L1 batch timestamp of the block
- logsBloom- The bloom filter for the logs of the block. null if pending
- miner- The address of the beneficiary to whom the mining rewards were given
- mixHash- A string of a 256-bit hash encoded as a hexadecimal
- nonce- The hash of the generated proof-of-work. null if pending
- number- The block number of the requested block encoded as a hexadecimal. null if pending
- parentHash- The hash of the parent block
- receiptsRoot- The root of the receipts trie of the block
- sha3Uncles- The SHA3 of the uncles data in the block
- size- The size of this block in bytes as an Integer value encoded as hexadecimal
- stateRoot- The root of the final state trie of the block
- timestamp- The unix timestamp for when the block was collated
- totalDifficulty- The integer of the total difficulty of the chain until this block encoded as a hexadecimal
- transactions- An array of transaction objects - please see eth_getTransactionByHash for exact shape
- transactionsRoot- The root of the transaction trie of the block
- uncles- An array of uncle hashes

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBlockByNumber","params":["0x5F4E6",false],"id":1,"jsonrpc":"2.0"}'

eth_getBlockTransactionCountByHash

Returns the number of transactions for the block matching the given block hash.

Parameters

hash - string - The hash of the block

Returns

result- The number of transactions associated with a specific block, in hexadecimal value

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBlockTransactionCountByHash","params":["0x43c330b1bc3b8ec49ae75e67a81712c05791f4c16003fad98d9dca03556e3cf2"],"id":1,"jsonrpc":"2.0"}'

eth_getBlockTransactionCountByNumber

Returns the number of transactions for the block matching the given block number.

Parameters

blockNumber- string - The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain

Returns

result- The number of transactions in a specific block represented in hexadecimal format

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBlockTransactionCountByNumber","params":["0x6B04E"],"id":1,"jsonrpc":"2.0"}'

eth_getCode

Returns the compiled bytecode of a smart contract.

Parameters

address- string - The address of the smart contract from which the bytecode will be obtained
blockNumber- string - The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain

Returns

result- The bytecode from a given address returned as a string

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getCode","params":["0x4200000000000000000000000000000000000015","latest"],"id":1,"jsonrpc":"2.0"}'

eth_getFilterChanges

Polling method for a filter, which returns an array of events that have occurred since the last poll.

Parameters

filter ID - string - The filter id that is returned from eth_newFilter, eth_newBlockFilter or eth_newPendingTransactionFilter

Returns

array- An array of one of the following, depending on the filter type, or empty if there were no changes since the last poll:
- eth_newBlockFilter:
  - blockHash- The 32 byte hash of a block that meets your filter requirements
- eth_newPendingTransactionFilter:
  - transactionHash- The 32 byte hash of a transaction that meets your filter requirements
- eth_newFilter:
  - address- An address from which this log originated
  - topics- An array of zero to four 32 Bytes DATA of indexed log arguments. In Solidity, the first topic is the hash of the signature of the event (e.g. Deposit(address, bytes32, uint256)), except you declare the event with the anonymous specifier
  - data- It contains one or more 32 Bytes non-indexed arguments of the log
  - blockNumber- The block number where this log was in. null when its a pending log
  - transactionHash- The hash of the transactions this log was created from. null when its a pending log
  - transactionIndex- The integer of the transaction's index position that the log was created from. null when it's a pending log
  - blockHash- The hash of the block where this log was in. null when its a pending log
  - logIndex- The integer of the log index position in the block. null when it's a pending log
  - removed- It is true when the log was removed due to a chain reorganization, and false if it's a valid log

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getFilterChanges","params":["YOUR_FILTER_ID"],"id":1,"jsonrpc":"2.0"}'

eth_getFilterLogs

Returns an array of all logs matching filter with given id.

Parameters

id- string - The filter ID

Returns

result- An array of log objects, or an empty array if nothing has changed since last poll
- address- string - The address from which this log originated
- topics- array - An array of (0 to 4) 32 Bytes DATA of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier)
- data- string - It contains one or more 32 Bytes non-indexed arguments of the log
- blockNumber- string - The block number where this log was in. null when its pending. Null when it's a pending log
- transactionHash- string - The hash of the transaction from which this log was created from. null if the log is pending
- transactionIndex- string - The integer of the transaction's index position that the log was created from. Null when it's a pending log
- blockHash- string - The hash of the block where this log was in. Null when it's a pending log
- logIndex- string - The integer of the log index position in the block. Null when it's a pending log
- removed- boolean - It is true if log was removed, due to a chain reorganization and false if it's a valid log

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getFilterLogs","params":["0xfba02b32cc0fd31639b68144ebc59fd2"],"id":1,"jsonrpc":"2.0"}'

eth_getLogs

Returns an array of all logs matching a given filter object.

Parameters

object- The transaction call object which contains the following fields:
- fromBlock- string - (optional, default: "latest") The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
- toBlock- string - (optional, default: "latest") The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
- address- string - (optional) The contract address or a list of addresses from which logs should originate
- topics- string - (optional) An array of DATA topics and also, the topics are order-dependent.
- blockHash- string - (optional) With the addition of EIP-234, blockHash is a new filter option that restricts the logs returned to the block number referenced in the blockHash. Using the blockHash field is equivalent to setting the fromBlock and toBlock to the block number the blockHash references. If blockHash is present in the filter criteria, neither fromBlock nor toBlock is allowed

Returns

array- An array of log objects, or an empty array if nothing has changed since last poll:
address - An address from which this log originated
- topics-An array of zero to four 32 Bytes DATA of indexed log arguments. In Solidity, the first topic is the hash of the signature of the event (e.g. Deposit(address, bytes32, uint256)), except you declare the event with the anonymous specifier
- data- It contains one or more 32 Bytes non-indexed arguments of the log
- blockNumber- The block number where this log was in. null when it's a pending log
- transactionHash- The hash of the transactions this log was created from. null when its a pending log
- transactionIndex- The integer of the transaction's index position that the log was created from. null when it's a pending log
- blockHash- The hash of the block where this log was in. null when it's a pending log
- logIndex- The integer of the log index position in the block. null when it's a pending log
- removed- It is true when the log was removed due to a chain reorganization, and false if it's a valid log

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getLogs","params":[{"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"}],"id":1,"jsonrpc":"2.0"}'

eth_getProof

Returns the value from a storage position at a given address.

Parameters

address- string - The address of the account for which the balance is to be checked
storageKeys- array[strings] - An array of storage-keys that should be proofed and included
blockNumber- string - The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain

Returns

address- The address associated with the account
accountProof- An array of rlp-serialized MerkleTree-Nodes which starts with the stateRoot-Node and follows the path of the SHA3 address as key
balance- The current balance of the account in wei
codeHash- A 32 byte hash of the code of the account
nonce- The hash of the generated proof-of-work. Null if pending
storageHash- A 32 byte SHA3 of the storageRoot. All storage will deliver a MerkleProof starting with this rootHash
storageProof- An array of storage-entries as requested. Each entry is an object with the following fields:
- key- The requested storage key
- value- The storage value
- proof- An array of rlp-serialized MerkleTree-Nodes which starts with the stateRoot-Node and follows the path of the SHA3 address as key

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getProof","params":["0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],"latest"],"id":1,"jsonrpc":"2.0"}'

eth_getStorageAt

Returns the value from a storage position at a given address.

Parameters

address- string - The address to check for storage
position- string - The integer of the position in storage
blockNumber- string - The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain

Returns

result- It returns the value from a storage position at a given address

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getStorageAt","params":["0xE592427A0AEce92De3Edee1F18E0157C05861564", "0x0", "latest"],"id":1,"jsonrpc":"2.0"}'

eth_getTransactionByBlockHashAndIndex

Returns information about a transaction given a blockhash and transaction index position.

Parameters

blockHash - string - The block hash
index - string - An integer of the transaction index position encoded as a hexadecimal

Returns

object- The transaction response object, or null if no transaction is found:
- blockHash- The hash of the block where this log was in. null when it's a pending log
- blockNumber- The block number where this log was in. null when it's a pending log
- from- The address of the sender
- gas- The gas provided by the sender, encoded as hexadecimal
- gasPrice- The gas price provided by the sender in wei, encoded as hexadecimal
- hash- The hash of the transaction
- input- The data sent along with the transaction
- nonce- The number of transactions made by the sender before this one encoded as hexadecimal
- to- The address of the receiver. null when it's a contract creation transaction
- transactionIndex- The integer of the transaction's index position that the log was created from. null when it's a pending log
- value- The value transferred in wei encoded as hexadecimal
- type- The transaction type
- sourceHash- The hash of the source transaction that created this transaction
- mint- The minting event associated with the transaction
- v - The standardized V field of the signature
- r The R field of the signature
- s The S field of the signature
- isSystemTx It indicates whether the transaction is initiated by the system or not

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getTransactionByBlockHashAndIndex","params":["0x43c330b1bc3b8ec49ae75e67a81712c05791f4c16003fad98d9dca03556e3cf2","0x0"],"id":1,"jsonrpc":"2.0"}'

eth_getTransactionByBlockNumberAndIndex

Returns information about a transaction given a block number and transaction index position.

Parameters

blockNumber - string - The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
index- string - An integer of the transaction index position encoded as a hexadecimal

Returns

object- The transaction response object, or null if no transaction is found:
- blockHash- The hash of the block where this log was in. null when it's a pending log
- blockNumber- The block number where this log was in. null when it's a pending log
- from- The address of the sender
- gas- The gas provided by the sender, encoded as hexadecimal
- gasPrice- The gas price provided by the sender in wei, encoded as hexadecimal
- hash- The hash of the transaction
- input- The data sent along with the transaction
- nonce- The number of transactions made by the sender before this one encoded as hexadecimal
- to- The address of the receiver. null when it's a contract creation transaction
- transactionIndex- The integer of the transaction's index position that the log was created from. null when it's a pending log
- value- The value transferred in wei encoded as hexadecimal
- type- The transaction type
- sourceHash- The hash of the source transaction that created this transaction
- mint- The minting event associated with the transaction
- v - The standardized V field of the signature
- r The R field of the signature
- s The S field of the signature
- isSystemTx It indicates whether the transaction is initiated by the system or not

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getTransactionByBlockNumberAndIndex","params":["0x6b04e", "0x0"],"id":1,"jsonrpc":"2.0"}'

eth_getTransactionByHash

Returns the information about a transaction from a transaction hash.

Parameters

hash- string - The hash of a transaction

Returns

object- The transaction response object, or null if no transaction is found:
- blockHash- The hash of the block where this log was in. null when it's a pending log
- blockNumber- The block number where this log was in. null when it's a pending log
- from- The address of the sender
- gas- The gas provided by the sender, encoded as hexadecimal
- gasPrice- The gas price provided by the sender in wei, encoded as hexadecimal
- hash- The hash of the transaction
- input- The data sent along with the transaction
- nonce- The number of transactions made by the sender before this one encoded as hexadecimal
- to- The address of the receiver. null when it's a contract creation transaction
- transactionIndex- The integer of the transaction's index position that the log was created from. null when it's a pending log
- value- The value transferred in wei encoded as hexadecimal
- type- The transaction type
- sourceHash- The hash of the source transaction that created this transaction
- mint- The minting event associated with the transaction
- v - The standardized V field of the signature
- r The R field of the signature
- s The S field of the signature
- isSystemTx It indicates whether the transaction is initiated by the system or not

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getTransactionByHash","params":["0x2d3750f7944818e1a4e6b897b6f6ea4d975fcf46720990eb4eda0c00d926a8fd"],"id":1,"jsonrpc":"2.0"}'

eth_getTransactionCount

Returns the number of transactions sent from an address.

Parameters

address- string - The address from which the transaction count to be checked
blockNumber- string - The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain

Returns

result- The integer of the number of transactions sent from an address encoded as hexadecimal

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getTransactionCount","params":["0xDeaDDEaDDeAdDeAdDEAdDEaddeAddEAdDEAd0001", "latest"],"id":1,"jsonrpc":"2.0"}'

eth_getTransactionReceipt

Returns the receipt of a transaction by transaction hash.

Parameters

hash- string - The hash of a transaction

Returns

object- A transaction receipt object, or null when no receipt was found
- blockHash- The hash of the block where this transaction was in
- blockNumber- The block number where this transaction was added encoded as a hexadecimal
- contractAddress- The contract address created for contract creation, otherwise null
- cumulativeGasUsed- The total gas used when this transaction was executed in the block
- effectiveGasPrice- The total base charge plus tip paid for each unit of gas
- from- The address of the sender
- gasUsed- The amount of gas used by this specific transaction alone
- logs- An array of log objects that generated this transaction
  - address- The address from which this log was generated
  - topics- An array of zero to four 32 Bytes DATA of indexed log arguments. In Solidity, the first topic is the hash of the signature of the event (e.g. Deposit(address, bytes32, uint256)), except you declare the event with the anonymous specifier
  - data- The 32 byte non-indexed argument of the log
  - blockNumber- The block number where this log was in
  - transactionHash- The hash of the transaction from which this log was created from. null if the log is pending
  - transactionIndex- The transactions index position from which this log was created from. null if the log is pending
  - blockHash- The hash of the block where this log was in
  - logIndex- The integer of log index position in the block encoded as hexadecimal. null if the log is pending
  - removed- It is true if log was removed, due to a chain reorganization and false if it's a valid log
- logsBloom- The bloom filter which is used to retrive related logs
- status- It is either 1 (success) or 0 (failure) encoded as a hexadecimal
- to- The address of the receiver. Null when its a contract creation transaction
- transactionHash- The hash of the transaction
- transactionIndex- The transactions index position in the block encoded as a hexadecimal
- type- The type of value

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getTransactionReceipt","params":["0x2d3750f7944818e1a4e6b897b6f6ea4d975fcf46720990eb4eda0c00d926a8fd"],"id":1,"jsonrpc":"2.0"}'

eth_getUncleCountByBlockHash

Returns the number of uncles for the block matching the given block hash.

Parameters

hash- string - The hash of the block to get uncles for

Returns

uncles- The integer value of the number of uncles in the block encoded as hexadecimal

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getUncleCountByBlockHash","params":["0x8125d2cdb126d1eb9c40bd3a3a1c00633d5698c0af4dfa90ef2ad32ba81b6f52"],"id":1,"jsonrpc":"2.0"}'

eth_getUncleCountByBlockNumber

Returns the number of uncles for the block matching the given block number.

Parameters

blockNumber- string - The integer of a block number encoded in hexadecimal format starting with 0x

Returns

uncles- The integer value of the number of uncles in the block encoded as hexadecimal

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getUncleCountByBlockNumber","params":["0x6B04E"],"id":1,"jsonrpc":"2.0"}'

eth_hashrate

Returns the number of hashes per second that the node is mining with.

Parameters

N/A

Returns

hashrate- The number of hashes per second encoded in hexadecimal format

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":67}'

eth_maxPriorityFeePerGas

Get the priority fee needed to be included in a block.

Parameters

N/A

Returns

result- The hex value of the priority fee needed to be included in a block

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_maxPriorityFeePerGas","params":[],"id":1,"jsonrpc":"2.0"}'

eth_mining

Returns true if node is actively mining new blocks.

Parameters

N/A

Returns

result- It is true if the node is mining, otherwise false

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":67}'

eth_newBlockFilter

Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.

Parameters

N/A

Returns

result- It returns a filter id to be used when calling eth_getFilterChanges

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":67}'

eth_newFilter

Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.

Parameters

object- The transaction response object which contains the following filter information:

fromBlock- string - (optional) The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
toBlock- string - (optional) The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
address- string - (optional) The contract address or a list of addresses from which logs should originate
topics- string - (optional) An array of DATA topics and also, the topics are order-dependent.

Returns

result - It returns a filter id to be used when calling eth_getFilterChange

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"fromBlock": "0xe20360", "toBlock": "0xe20411", "address": "0x6b175474e89094c44da98b954eedeac495271d0f","topics": []}],"id":1}'

eth_sendRawTransaction

Creates new message call transaction or a contract creation for signed transactions.

Parameters

data- The signed transaction

Returns

result - The transaction hash, or the zero hash if the transaction is not yet available

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["signed transaction"],"id":1}'

eth_syncing

Returns an object with the sync status of the node if the node is out-of-sync and is syncing. Returns false when the node is already in sync.

Parameters

N/A

Returns

result- The result is false if JSON Object is not syncing otherwise it's true:
- startingblock- The block at which the import started encoded as hexadecimal
- currentblock- The current block, same as eth_blockNumber encoded as hexadecimal
- highestblock- The estimated highest block encoded as hexadecimal

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":67}'

eth_uninstallFilter

It uninstalls a filter with the given filter id.

Parameters

filter ID - string - The filter ID that needs to be uninstalled. It should always be called when watch is no longer needed. Additionally, Filters timeout when they aren't requested with eth_getFilterChanges for a period of time

Returns

result- It returns true if the filter was successfully uninstalled, otherwise false

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0x10ff0bfba9472c87932c56632eef8f5cc70910e8e71d"],"id":1}'

net_listening

Returns true if client is actively listening for network connections.

Parameters

N/A

Returns

result- It's true when the client is actively listening for network connections, otherwise false

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'

net_peerCount

Returns number of peers currently connected to the client.

Parameters

N/A

Returns

result- The integer of the number of connected peers encoded as hexadecimal

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":67}'

net_version

Returns the current network id.

Parameters

N/A

Returns

result- The string value of current network id. Typical values are as follows:
- 1 - ethereum mainnet
- 2 - morden testnet (deprecated)
- 3 - ropsten testnet
- 4 - rinkeby testnet
- 5 - goerli testnet
- 11155111 - sepolia testnet
- 10 - optimism mainnet
- 69 - optimism kovan testnet
- 42 - kovan testnet
- 137 - matic/polygon mainnet
- 80001 - matic/polygon mumbai testnet
- 250 - fantom mainnet
- 100 - xdai mainnet
- 56 - bsc mainne

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'

web3_clientVersion

Returns the current version of the chain client.

Parameters

N/A

Returns

result- The current client version in string format

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":1}'

web3_sha3

Returns Keccak-256 (not the standardized SHA3-256) hash of the given data.

Parameters

data- The data in hexadecimal form to convert into a SHA3 hash

Returns

data- The SHA3 hash of the given string

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":1}'

Debug API

debug_getBadBlocks

Returns a list of the last bad blocks that the client has seen on the network.

Parameters

N/A

Returns

hash- The hash of the transaction
block- A block object, or null when no block was found
- baseFeePerGas- The integer of the difficulty for this block encoded as hexadecimal
- difficulty- The integer of the difficulty for this block encoded as hexadecimal
- extraData- The extra data field of this block
- gasLimit- The maximum gas allowed in this block encoded as hexadecimal
- gasUsed- The total used gas by all transactions in this block encoded as hexadecimal
- hash- The block hash of the requested block. Null if pending
- logsBloom- The bloom filter for the logs of the block. Null if pending
- miner- The address of the beneficiary to whom the mining rewards were given
- mixHash- A string of a 256-bit hash encoded as hexadecimal
- nonce- The hash of the generated proof-of-work. Null if pending
- number- The block number of the requested block encoded as hexadecimal. Null if pending
- parentHash- The hash of the parent block
- receiptsRoot- The root of the receipts trie of the block
- sha3Uncles- The SHA3 of the uncles data in the block
- size- The size of this block in bytes as an Integer value encoded as hexadecimal
- stateRoot- The root of the final state trie of the block
- timestamp- The unix timestamp for when the block was collated
- transactions- An array of transaction objects with the following fields:
  - blockHash- The hash of the block where this log was in. Null when it's a pending log
  - blockNumber- The block number where this log was in. Null when it's a pending log
  - from- The address of the sender
  - gas- The gas provided by the sender, encoded as hexadecimal
  - gasPrice- The gas price provided by the sender in wei, encoded as hexadecimal
  - maxFeePerGas- The maximum fee per gas set in the transaction
  - maxPriorityFeePerGas- The maximum priority gas fee set in the transaction
  - hash- The hash of the transaction
  - input- The data sent along with the transaction
  - nonce- The number of transactions made by the sender before this one encoded as hexadecimal
  - to- The address of the receiver. Null when it's a contract creation transaction
  - transactionIndex- The integer of the transaction's index position that the log was created from. Null when it's a pending log
  - value- The value transferred in wei encoded as hexadecimal
  - type- The transaction type
  - accessList- A list of addresses and storage keys that the transaction plans to access
  - chainId- The chain id of the transaction, if any
  - v- The standardized V field of the signature
  - r- The R field of the signature
  - s- The S field of the signature
- transactionsRoot- The root of the transaction trie of the block
- uncles- An array of uncle hashes
rlp- The RLP encoded header

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
 -X POST \
 -H "Content-Type: application/json" \
 --data '{"method":"debug_getBadBlocks","params":[],"id":1,"jsonrpc":"2.0"}'

debug_storageRangeAt

Returns the contract storage for the specified range.

Parameters

blockHash- string - The hash of the block
txIndex- integer - The transaction index for the point in which we want the list of accounts
address- The contract address
startKey- The offset (hash of storage key)
limit- The number of storage entries to return

Returns

storage- An object with hash values, and for each of them the key and value it represents
- hash- The hash value
  - key- The key associated with the hash
  - value- The value associated with the hash
nextKey- The hash of next key if further storage in range. Otherwise, not included

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
 -X POST \
 -H "Content-Type: application/json" \
 --data '{"method":"debug_storageRangeAt","params":["0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",0,"0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5","0x0000000000000000000000000000000000000000000000000000000000000000",1],"id":1,"jsonrpc":"2.0"}'

debug_traceBlock

Returns a full stack trace of all invoked opcodes of all transactions that were included in a block.

Parameters

block- The RLP encoded block
object- The tracer object with the following fields:
- tracer- The type of tracer. It could be callTracer or prestateTracer
  - callTracer- The calltracer keeps track of all call frames, including depth 0 calls, that are made during a transaction
  - prestateTracer- The prestateTracer replays the transaction and tracks every part of state that occured during the transaction
- tracerConfigtracerConfig- The object to specify the configurations of the tracer
  - onlyTopCall- boolean - When set to true, this will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame

Returns

result- A result array with the following fields:
- type- The type of the call
- from- The address the transaction is sent from
- to- The address the transaction is directed to
- value- The integer of the value sent with this transaction
- gas- The integer of the gas provided for the transaction execution
- gasUsed- The integer of the gas used
- input- The data given at the time of input
- output- The data which is returned as an output
- calls- A list of sub-calls

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
 -X POST \
 -H "Content-Type: application/json" \
 --data '{"method":"debug_traceBlock","params":["RLP_ENCODED_BLOCK", {"tracer": "callTracer"}],"id":1,"jsonrpc":"2.0"}'

debug_traceBlockByHash

Returns the possible tracing result number by executing all transactions in the block specified by the block hash with a tracer (Trace Mode required).

Parameters

blockHash- The hash of the block to be traced
object- The tracer object with the following fields:
- tracer- The type of tracer. It could be callTracer or prestateTracer
  - callTracer- The calltracer keeps track of all call frames, including depth 0 calls, that are made during a transaction
  - prestateTracer- The prestateTracer replays the transaction and tracks every part of state that occured during the transaction
- tracerConfigtracerConfig- The object to specify the configurations of the tracer
  - onlyTopCall- boolean - When set to true, this will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame

Returns

result- A result array with the following fields:
- type- The type of the call
- from- The address the transaction is sent from
- to- The address the transaction is directed to
- value- The integer of the value sent with this transaction
- gas- The integer of the gas provided for the transaction execution
- gasUsed- The integer of the gas used
- input- The data given at the time of input
- output- The data which is returned as an output
- calls- A list of sub-calls

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
-X POST \
-H "Content-Type: application/json" \
--data '{"method":"debug_traceBlockByHash","params":["0x8125d2cdb126d1eb9c40bd3a3a1c00633d5698c0af4dfa90ef2ad32ba81b6f52", {"tracer": "callTracer"}],"id":1,"jsonrpc":"2.0"}'

debug_traceBlockByNumber

Returns the tracing result by executing all transactions in the block specified by number with a tracer (Trace Mode required).

Parameters

blockNumber- The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
object- The tracer object with the following fields:
- tracer- The type of tracer. It could be callTracer or prestateTracer
  - callTracer- The calltracer keeps track of all call frames, including depth 0 calls, that are made during a transaction
  - prestateTracer- The prestateTracer replays the transaction and tracks every part of state that occured during the transaction
- tracerConfigtracerConfig- The object to specify the configurations of the tracer
  - onlyTopCall- boolean - When set to true, this will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame

Returns

result- A result array with the following fields:
- type- The type of the call
- from- The address the transaction is sent from
- to- The address the transaction is directed to
- value- The integer of the value sent with this transaction
- gas- The integer of the gas provided for the transaction execution
- gasUsed- The integer of the gas used
- input- The data given at the time of input
- output- The data which is returned as an output
- calls- A list of sub-calls

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
-X POST \
-H "Content-Type: application/json" \
--data '{"method":"debug_traceBlockByNumber","params":["0x5F4E6", {"tracer": "callTracer"}],"id":1,"jsonrpc":"2.0"}'

debug_traceTransaction

Returns all traces of a given transaction (Trace Mode required).

Parameters

transactionHash- The transaction hash that needs to be traced, encoded in hexadecimal format
object- The tracer object with the following fields:
- tracer- The type of tracer. It could be callTracer or prestateTracer
  - callTracer- The calltracer keeps track of all call frames, including depth 0 calls, that are made during a transaction
  - prestateTracer- The prestateTracer replays the transaction and tracks every part of state that occured during the transaction
- tracerConfigtracerConfig- The object to specify the configurations of the tracer
  - onlyTopCall- boolean - When set to true, this will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame
timeout- A string of decimal integers that overrides the JavaScript-based tracing calls default timeout of 5 seconds.

Returns

result- A result array with the following fields:
- type- The type of the call
- from- The address the transaction is sent from
- to- The address the transaction is directed to
- value- The integer of the value sent with this transaction
- gas- The integer of the gas provided for the transaction execution
- gasUsed- The integer of the gas used
- input- The data given at the time of input
- output- The data which is returned as an output
- error- The type of error, if any
- revertReason- The type solidity revert reason, if any
- calls- A list of sub-calls

Example

curl https://open-platform.nodereal.io/{{apiKey}}/base/ \
-X POST \
-H "Content-Type: application/json" \
--data '{"method":"debug_traceTransaction","params":["0x2d3750f7944818e1a4e6b897b6f6ea4d975fcf46720990eb4eda0c00d926a8fd", {"tracer": "callTracer"}], "id":1,"jsonrpc":"2.0"}'