Meterest
v1.2.2https://meter.nownodes.iohttps://meter-evm.nownodes.ioRESTful API to access Meter.io
Authentication
api-keyAuthapiKeyAPI Key: api-key in header
API Reference
Accounts
Access to account objects
Retrieve account detail
includes balance, energy and hasCode, by account address. An account with hasCode be true is a contract.
Historical account detail can be queried by specifying revision query string.
Parameters
addressstring<bytes20>requiredpathaddress of account
revisionstringquerycan be block number or ID. best block is assumed if omitted.
Response
OK
Authorization
api-keyAuthapiKey in headerExecute account code
to simulate contract method call, without sending transaction to block chain.
It's useful to estimate gas usage and execution result of a clause.
Body
arguments and environment
valuestringamount of token to be transferred
datastringinput data for contract call
gasinteger<uint64>max allowed gas for execution
gasPricestringabsolute gas price
callerstringcaller address (msg.sender)
Parameters
addressstring<bytes20>requiredpathaddress of account
revisionstringquerycan be block number or ID. best block is assumed if omitted.
Response
OK
Authorization
api-keyAuthapiKey in headerExecute a batch of codes
to simulate execution of a transaction.
Body
arguments and environment
clausesArray<Clause>gasinteger<uint64>max allowed gas for execution
gasPricestringabsolute gas price
callerstringcaller address (msg.sender)
Parameters
revisionstringquerycan be block number or ID. best block is assumed if omitted.
Response
OK
Authorization
api-keyAuthapiKey in headerExecute bytecodes
to simulate contract deployment without sending transaction to block chain.
It's useful to estimate gas usage and contract deployment result of a clause.
TIPS:
datain request body is the bytecodes of a contractdatain response body is the runtime bytecodes assigned to account which the contract to be deployed
Body
arguments and environment
valuestringamount of token to be transferred
datastringinput data for contract call
gasinteger<uint64>max allowed gas for execution
gasPricestringabsolute gas price
callerstringcaller address (msg.sender)
Parameters
revisionstringquerycan be block number or ID. best block is assumed if omitted.
Response
OK
Authorization
api-keyAuthapiKey in headerRetrieve account code
if any. Here the code is runtime bytecodes.
Parameters
addressstring<bytes20>requiredpathaddress of account
revisionstringquerycan be block number or ID. best block is assumed if omitted.
Response
OK
Authorization
api-keyAuthapiKey in headerRetrieve account storage value
for given key.
Parameters
addressstring<bytes20>requiredpathaddress of account
keystringrequiredpaththe key(position) to access account storage
revisionstringquerycan be block number or ID. best block is assumed if omitted.
Response
OK
Authorization
api-keyAuthapiKey in headerTransactions
Access to transactions
Retrieve transaction
by ID.
Parameters
idstringrequiredpathID of transaction
rawbooleanquerywhether retrieve a raw transaction.
headstringqueryID of head block. best block is assumed if omitted
Response
OK
Authorization
api-keyAuthapiKey in headerRetrieve transaction receipt
by ID.
Parameters
idstringrequiredpathID of transaction
headstringqueryID of head block. best block is assumed if omitted
Response
OK
Authorization
api-keyAuthapiKey in headerCommit transaction
in raw or structured format. If no signature in structured format,
signingHash is returned in response body.
Body
rawstringhex form of encoded transaction
chainTaginteger<uint8>last byte of genesis block ID
blockRefstring8 bytes prefix of some block ID
expirationinteger<uint32>expiration relative to blockRef, in unit block
clausesArray<Clause>gasPriceCoefinteger<uint8>coefficient used to calculate the final gas price
gasinteger<uint64>max amount of gas can be consumed to execute this transaction
dependsOnstring<bytes32>ID of the transaction on which the current transaction depends on. can be null.
noncestringsignaturestringsignature hex string
chainTaginteger<uint8>last byte of genesis block ID
blockRefstring8 bytes prefix of some block ID
expirationinteger<uint32>expiration relative to blockRef, in unit block
clausesArray<Clause>gasPriceCoefinteger<uint8>coefficient used to calculate the final gas price
gasinteger<uint64>max amount of gas can be consumed to execute this transaction
dependsOnstring<bytes32>ID of the transaction on which the current transaction depends on. can be null.
noncestringResponse
OK
Authorization
api-keyAuthapiKey in headerBlocks
Access to blocks
Retrieve block
by ID or number, or 'best' for latest block.
Parameters
revisionstringrequiredpathblock ID or number, or 'best' stands for latest block
Response
OK
Authorization
api-keyAuthapiKey in headerLogs
Access to event & transfer logs
Filter event logs
Event logs are produced by OP_LOG in EVM.
Body
rangeFilterRangedefines the range to filter in. e.g.
{
"range": {
"unit": "block",
"from": 10,
"to": 1000
}
}refers to the range from block 10 to block 1000.
null stands for the full range.
optionsFilterOptionspass these parameters if you need filtered results paged. e.g.
{
"options": {
"offset": 0,
"limit": 10
}
}the above refers that page offset is 0, and the page size is 10.
pass options null if you don't need to demand paging.
criteriaSetArray<EventCriteria>orderstringascdescorder of filters, defaults to asc
Response
OK
Authorization
api-keyAuthapiKey in headerFilter transfer logs
Transfer logs are recorded on MTRG transferring.
Body
rangeFilterRangedefines the range to filter in. e.g.
{
"range": {
"unit": "block",
"from": 10,
"to": 1000
}
}refers to the range from block 10 to block 1000.
null stands for the full range.
optionsFilterOptionspass these parameters if you need filtered results paged. e.g.
{
"options": {
"offset": 0,
"limit": 10
}
}the above refers that page offset is 0, and the page size is 10.
pass options null if you don't need to demand paging.
criteriaSetArray<TransferCriteria>orderstringascdescorder of filters, defaults to asc
Response
OK
Authorization
api-keyAuthapiKey in headerFilter event logs
Event logs are produced by OP_LOG in EVM.
Body
event filter criteria
rangeFilterRangedefines the range to filter in. e.g.
{
"range": {
"unit": "block",
"from": 10,
"to": 1000
}
}refers to the range from block 10 to block 1000.
null stands for the full range.
optionsFilterOptionspass these parameters if you need filtered results paged. e.g.
{
"options": {
"offset": 0,
"limit": 10
}
}the above refers that page offset is 0, and the page size is 10.
pass options null if you don't need to demand paging.
topicSetsArray<TopicSetLegacy>Parameters
orderstringascdescqueryorder of filters, defaults to asc
addressstringqueryaddress of account which is the events emitter
Response
OK
Authorization
api-keyAuthapiKey in headerFilter transfer logs
Transfer logs are recorded on MTR transferring.
Body
transfer log filter criteria
rangeFilterRangedefines the range to filter in. e.g.
{
"range": {
"unit": "block",
"from": 10,
"to": 1000
}
}refers to the range from block 10 to block 1000.
null stands for the full range.
optionsFilterOptionspass these parameters if you need filtered results paged. e.g.
{
"options": {
"offset": 0,
"limit": 10
}
}the above refers that page offset is 0, and the page size is 10.
pass options null if you don't need to demand paging.
addressSetsArray<AddressSetLegacy>Parameters
orderstringascdescqueryorder of filters, defaults to asc
Response
OK
Authorization
api-keyAuthapiKey in headerFilter event logs
Body
event filter criteria
rangeFilterRangedefines the range to filter in. e.g.
{
"range": {
"unit": "block",
"from": 10,
"to": 1000
}
}refers to the range from block 10 to block 1000.
null stands for the full range.
optionsFilterOptionspass these parameters if you need filtered results paged. e.g.
{
"options": {
"offset": 0,
"limit": 10
}
}the above refers that page offset is 0, and the page size is 10.
pass options null if you don't need to demand paging.
topicSetsArray<TopicSetLegacy>Parameters
orderstringascdescqueryorder of filters, defaults to asc
addressstringqueryaddress of account which is the events emitter
Response
OK
Authorization
api-keyAuthapiKey in headerFilter transfer logs
Body
transfer log filter criteria
rangeFilterRangedefines the range to filter in. e.g.
{
"range": {
"unit": "block",
"from": 10,
"to": 1000
}
}refers to the range from block 10 to block 1000.
null stands for the full range.
optionsFilterOptionspass these parameters if you need filtered results paged. e.g.
{
"options": {
"offset": 0,
"limit": 10
}
}the above refers that page offset is 0, and the page size is 10.
pass options null if you don't need to demand paging.
addressSetsArray<AddressSetLegacy>Parameters
orderstringascdescqueryorder of filters, defaults to asc
Response
OK
Authorization
api-keyAuthapiKey in headerNode
Access to node status info
Retrieve connected peers
Response
OK
Authorization
api-keyAuthapiKey in headerRetrieve current committee members
Authorization
api-keyAuthapiKey in headerSubscriptions
Subscribe interested subjects
(Websocket) Subscribe new blocks
Parameters
posstringquerya saved block ID for resuming the subscription. best block ID is assumed if omitted.
Response
OK
Authorization
api-keyAuthapiKey in header(Websocket) Subscribe new events
which satisfy criteria in query.
Parameters
posstringquerya saved block ID for resuming the subscription. best block ID is assumed if omitted.
addrstringqueryaddress of event emitter
t0stringquerytopic0 of event
t1stringquerytopic1 of event
t2stringquerytopic2 of event
t3stringquerytopic3 of event
t4stringquerytopic4 of event
Response
OK
Authorization
api-keyAuthapiKey in header(Websocket) Subscribe new transfers
which satisfy criteria in query.
Parameters
posstringquerya saved block ID for resuming the subscription. best block ID is assumed if omitted.
txOriginstringquerysigner address of tx which contains the transfer
senderstringqueryaddress of token sender
recipientstringqueryaddress of token recipient
Response
OK
Authorization
api-keyAuthapiKey in header(Websocket) Subscribe block chain's beats
which contain summary of new blocks, and bloom filters that composited with affected addresses.
Parameters
posstringquerya saved block ID for resuming the subscription. best block ID is assumed if omitted.
Response
OK
Authorization
api-keyAuthapiKey in headerDebug
Debug utilities
Create a tracer
for a clause
Body
namestring4bytebigramcallevmdisnoopopcountprestatetrigramunigramname of tracer. Empty name stands for default struct logger tracer.
targetstringthe unified path of target to be traced.
Currently, only clause is supported. Format:
blockID/(txIndex|txId)/clauseIndex
Response
OK
Authorization
api-keyAuthapiKey in headerRetrieve storage range
of the account with given address
Body
addressstringaddress of account
keyStartstringmaxResultnumbertargetstringResponse
OK
Authorization
api-keyAuthapiKey in headerStaking
Access to staking data
Retrieve staking buckets
Authorization
api-keyAuthapiKey in headerRetrieve staking candidates
Authorization
api-keyAuthapiKey in headerRetrieve staking stakeholder
Authorization
api-keyAuthapiKey in headerRetrieve staking delegates for consensus
Authorization
api-keyAuthapiKey in headerEVM
eth_accounts
Ethereum method - eth_accounts
Returns an array of addresses controlled by the client.
Body
jsonrpcstringrequiredJSON-RPC version identifier
methodstringrequiredName of the JSON-RPC method
paramsarrayrequiredNo parameters are required for this method. This must be an empty array.
idintegerrequiredUnique identifier for the JSON-RPC request
Response
A list of Ethereum addresses
Authorization
api-keyAuthapiKey in headereth_blockNumber
Ethereum method - eth_blockNumber
Returns the number of the latest block on the chain in hexadecimal format.
Body
jsonrpcstringrequiredThe JSON-RPC protocol version
methodstringrequiredName of the method being called
paramsarrayrequiredThis method does not take parameters; always send an empty array.
idintegerrequiredA unique ID for the request
Response
The latest block number
Authorization
api-keyAuthapiKey in headereth_call
Ethereum method - eth_call
Executes a call to a contract or address and returns the result without broadcasting a transaction.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object | string>requiredThe first object specifies the call transaction object. The second (optional) parameter specifies the block context.
idintegerrequiredResponse
Result of the call
Authorization
api-keyAuthapiKey in headereth_chainId
Ethereum method - eth_chainId
Returns the hexadecimal string of the current chain ID.
Body
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredName of the method to call
paramsarrayrequiredThis method does not require parameters. Use an empty array.
idintegerrequiredUnique identifier for the request
Response
Chain ID response
Authorization
api-keyAuthapiKey in headereth_coinbase
eth_coinbase
Returns the Ethereum coinbase address (i.e., the address that receives mining rewards).
Body
jsonrpcstringrequiredmethodstringeth_coinbaserequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC Response with the coinbase address
Authorization
api-keyAuthapiKey in headereth_estimateGas
Estimate Gas for Transaction
Simulates a transaction and returns an estimate of how much gas would be used.
Body
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredThe method name
paramsArray<object | string>requiredThe transaction call object and an optional block tag.
idintegerrequiredRequest identifier
Response
Estimated gas amount
Authorization
api-keyAuthapiKey in headereth_feeHistory
eth_feeHistory
Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string | integer | Array<number>>requiredParameters:
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).
idintegerrequiredResponse
JSON-RPC Response with fee history data
Authorization
api-keyAuthapiKey in headereth_gasPrice
Get Suggested Gas Price
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
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsarrayrequiredThis method takes an empty array.
idintegerrequiredRequest identifier
Response
Suggested gas price in wei
Authorization
api-keyAuthapiKey in headereth_getBalance
Get ETH Balance of an Address
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
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray with 2 parameters:
- Address (20-byte hex string with '0x' prefix)
- Block tag (e.g., 'latest', 'earliest', 'pending', or block number in hex)
idintegerrequiredRequest ID
Response
Balance (in wei) as hex string
Authorization
api-keyAuthapiKey in headereth_getBlockByHash
Get Block by Hash
Returns the block information for the specified block hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray of parameters:
- Block hash (string)
- Boolean flag — if true, return full transactions; if false, only hashes.
idintegerrequiredRequest ID
Response
Block information
Authorization
api-keyAuthapiKey in headereth_getBlockByNumber
Get Block by Number
Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray 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.
idintegerrequiredRequest ID
Response
Block information
Authorization
api-keyAuthapiKey in headereth_getBlockReceipts
Get All Transaction Receipts for a Block
Returns an array of transaction receipts for every transaction in the block specified by block number or block hash.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredOne parameter:
- Block identifier, which can be either:
- block number as hex string (e.g. "0x10d4f")
- or block hash as hex string (0x-prefixed)
idintegerrequiredRequest identifier
Response
Array of transaction receipts in the block
Authorization
api-keyAuthapiKey in headereth_getBlockTransactionCountByHash
Get Transaction Count by Block Hash
Returns the number of transactions contained in the block with the given hash.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray containing a single parameter:
- Block hash as a hex string (32 bytes with 0x prefix)
idintegerrequiredRequest ID
Response
Number of transactions in the block
Authorization
api-keyAuthapiKey in headereth_getBlockTransactionCountByNumber
Get Transaction Count by Block Number
Returns the number of transactions contained in the block with the given block number.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray 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"
idintegerrequiredRequest ID
Response
Number of transactions in the block
Authorization
api-keyAuthapiKey in headereth_getCode
Get Contract Bytecode at Address
Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters 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").
idintegerrequiredRequest identifier.
Response
Contract bytecode in hex format
Authorization
api-keyAuthapiKey in headereth_getFilterChanges
Get Filter Changes
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
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array with a single element:
- The filter ID (hex string).
idintegerrequiredRequest identifier.
Response
Array of log objects or transaction hashes depending on filter type
Authorization
api-keyAuthapiKey in headereth_getFilterLogs
Get Filter Logs
Returns all logs matching a filter with the specified filter ID. The filter must have been previously created with eth_newFilter.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array with one element:
- The filter ID (hex string).
idintegerrequiredRequest identifier.
Response
Array of log objects matching the filter
Authorization
api-keyAuthapiKey in headereth_getLogs
Get Logs
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
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<object>requiredParameters array with one element: the filter object.
idintegerrequiredRequest identifier.
Response
Array of log objects matching the filter
Authorization
api-keyAuthapiKey in headereth_getStorageAt
Get Storage At
Returns the value stored at position in the storage of the contract at address at the given blockNumber.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters 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").
idintegerrequiredRequest identifier.
Response
Storage slot value at the specified position
Authorization
api-keyAuthapiKey in headereth_getTransactionByBlockHashAndIndex
Get Transaction by Block Hash and Index
Retrieves the transaction from a block using the block's hash and the transaction's index position within the block.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredParameters:
- blockHash (string): The 32-byte hash of the block.
- transactionIndex (string): The transaction index (hex).
idintegerrequiredResponse
A transaction object or null if no transaction was found.
Authorization
api-keyAuthapiKey in headereth_getTransactionByBlockNumberAndIndex
Get Transaction by Block Number and Index
Returns the information about a transaction using the block number and the transaction index within the block.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredParameters:
- Block number in hex format (e.g., "0x5daf3b")
- Transaction index in the block (e.g., "0x0")
idintegerrequiredResponse
A transaction object, or null if not found.
Authorization
api-keyAuthapiKey in headereth_getTransactionByHash
Get transaction by hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredArray containing a single transaction hash
idintegerrequiredResponse
Transaction object or null
Authorization
api-keyAuthapiKey in headereth_getTransactionCount
Get transaction count (nonce) for address
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>required- address: The address to check for transaction count.
- block: The block parameter (e.g., "latest", "earliest", "pending").
idintegerrequiredResponse
Hex encoded nonce (transaction count)
Authorization
api-keyAuthapiKey in headereth_getTransactionReceipt
Get transaction receipt by hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredidintegerrequiredResponse
Transaction receipt if mined, otherwise null
Authorization
api-keyAuthapiKey in headereth_getUncleByBlockHashAndIndex
Get uncle block by block hash and index
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredblockHash: 32-byte block hashindex: the uncle index as hex (e.g., "0x0" for the first uncle)
idintegerrequiredResponse
Uncle block object or null
Authorization
api-keyAuthapiKey in headereth_getUncleByBlockNumberAndIndex
Get uncle block by block number and index
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredblockNumber: 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).
idintegerrequiredResponse
Uncle block object or null
Authorization
api-keyAuthapiKey in headereth_getUncleCountByBlockHash
Get the number of uncle blocks by block hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredAn array containing the block hash.
idintegerrequiredResponse
Number of uncles in the block
Authorization
api-keyAuthapiKey in headereth_getUncleCountByBlockNumber
Get the number of uncle blocks by block number
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredAn array containing the block number as a hex string.
idintegerrequiredResponse
Number of uncle blocks in the block
Authorization
api-keyAuthapiKey in headereth_hashrate
eth_hashrate
Returns the current mining hashrate reported by the client.
Body
jsonrpcstringrequiredmethodstringeth_hashraterequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the current mining hashrate
Authorization
api-keyAuthapiKey in headereth_maxPriorityFeePerGas
Get recommended maxPriorityFeePerGas value
Body
jsonrpcstringrequiredmethodstringrequiredparamsarrayrequiredNo parameters are required.
idintegerrequiredResponse
Returns the suggested maxPriorityFeePerGas value
Authorization
api-keyAuthapiKey in headereth_mining
eth_mining
Checks whether the Ethereum client is actively mining.
Body
jsonrpcstringrequiredmethodstringeth_miningrequiredparamsarrayrequiredThis method does not accept parameters.
idintegerrequiredResponse
JSON-RPC Response indicating mining status
Authorization
api-keyAuthapiKey in headereth_newBlockFilter
Create a new block filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<any>requiredThis method does not require any parameters.
idintegerrequiredResponse
Filter ID created successfully
Authorization
api-keyAuthapiKey in headereth_newFilter
Create a new log filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object>requiredArray with one object describing the filter options.
idintegerrequiredResponse
Filter ID created successfully
Authorization
api-keyAuthapiKey in headereth_newPendingTransactionFilter
Create a filter for pending transactions
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<any>requiredNo parameters required for this method
idintegerrequiredRequest identifier
Response
Filter ID created successfully
Authorization
api-keyAuthapiKey in headereth_sendRawTransaction
Send a raw signed transaction
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredMethod name
paramsArray<string>requiredArray containing a single signed transaction data (hex string)
idintegerrequiredRequest ID
Response
Transaction successfully sent
Authorization
api-keyAuthapiKey in headereth_sendRawTransactionSync
Send raw transaction (synchronous)
Submit a signed raw transaction to the network and wait for transaction receipt synchronously. This method will block until the transaction is mined or timeout occurs.
Body
jsonrpcstringmethodstringparamsArray<string>Array containing one parameter - the signed transaction data in hex format (0x-prefixed)
idintegerResponse
Successful response with transaction receipt. Returns the transaction receipt if the transaction was successfully mined.
Invalid request or transaction data
Transaction execution failed
Authorization
api-keyAuthapiKey in headereth_sendTransaction
Send a transaction using node-managed account
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object>requiredTransaction object
idintegerrequiredResponse
Transaction successfully sent
Authorization
api-keyAuthapiKey in headereth_sign
Sign arbitrary data using eth_sign
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>required[address, data]
- address: The account that will sign the data
- data: The data to be signed (must be a hex string)
idintegerrequiredResponse
Returns the signature of the message
Authorization
api-keyAuthapiKey in headereth_signTransaction
eth_signTransaction
Signs a transaction locally with the private key of the specified account.
Body
jsonrpcstringrequiredmethodstringeth_signTransactionrequiredparamsArray<object>requiredArray with a single object representing the transaction to sign.
idintegerrequiredResponse
JSON-RPC response with the signed transaction data
Authorization
api-keyAuthapiKey in headereth_syncing
Check if node is syncing
Body
jsonrpcstringrequiredmethodstringrequiredparamsarrayrequiredMust be an empty array.
idintegerrequiredResponse
Returns sync status object or false
Authorization
api-keyAuthapiKey in headereth_uninstallFilter
Uninstall an existing filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredidintegerrequiredResponse
Success or failure of the uninstall operation
Authorization
api-keyAuthapiKey in headernet_listening
net_listening
Checks if the client is listening for network connections.
Body
jsonrpcstringrequiredmethodstringnet_listeningrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with listening status
Authorization
api-keyAuthapiKey in headernet_peerCount
net_peerCount
Returns the number of peers currently connected to the client.
Body
jsonrpcstringrequiredmethodstringnet_peerCountrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the number of connected peers
Authorization
api-keyAuthapiKey in headernet_version
net_version
Returns the current network ID of the Ethereum client.
Body
jsonrpcstringrequiredmethodstringnet_versionrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the current network ID
Authorization
api-keyAuthapiKey in headerweb3_clientVersion
web3_clientVersion
Returns the current Ethereum client version.
Body
jsonrpcstringrequiredmethodstringweb3_clientVersionrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the client version string
Authorization
api-keyAuthapiKey in headerweb3_sha3
web3_sha3
Computes the Keccak-256 (SHA-3) hash of the given hex-encoded data.
Body
jsonrpcstringrequiredmethodstringweb3_sha3requiredparamsArray<string>requiredArray containing a single hex-encoded data string to hash.
idintegerrequiredResponse
JSON-RPC response with the Keccak-256 hash of the input data
Authorization
api-keyAuthapiKey in header