Home

Ethereum JSON-RPC

v1.0.0
Base URL
https://moonbeam.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

ApiKeyAuthapiKey

API Key: api-key in header

MAINNET / EVM

eth_accounts

Ethereum method - eth_accounts

POST
https://moonbeam.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

eth_blockNumber

Ethereum method - eth_blockNumber

POST
https://moonbeam.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

eth_call

Ethereum method - eth_call

POST
https://moonbeam.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

eth_chainId

Ethereum method - eth_chainId

POST
https://moonbeam.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

eth_coinbase

eth_coinbase

POST
https://moonbeam.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_estimateGas

Estimate Gas for Transaction

POST
https://moonbeam.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

eth_feeHistory

eth_feeHistory

POST
https://moonbeam.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:

  1. blockCount — number of blocks in the requested range.
  2. newestBlock — highest block number in the requested range (can be "latest").
  3. 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_gasPrice

Get Suggested Gas Price

POST
https://moonbeam.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

eth_getBalance

Get ETH Balance of an Address

POST
https://moonbeam.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:

  1. Address (20-byte hex string with '0x' prefix)
  2. 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

eth_getBlockByHash

Get Block by Hash

POST
https://moonbeam.nownodes.io/

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

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

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

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

eth_getBlockByNumber

Get Block by Number

POST
https://moonbeam.nownodes.io/

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

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

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

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

eth_getBlockReceipts

Get All Transaction Receipts for a Block

POST
https://moonbeam.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

eth_getBlockTransactionCountByHash

Get Transaction Count by Block Hash

POST
https://moonbeam.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

eth_getBlockTransactionCountByNumber

Get Transaction Count by Block Number

POST
https://moonbeam.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

eth_getCode

Get Contract Bytecode at Address

POST
https://moonbeam.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:

  1. The address to get the code for (hex string, 0x-prefixed).
  2. 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

eth_getFilterChanges

Get Filter Changes

POST
https://moonbeam.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:

  1. 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

eth_getFilterLogs

Get Filter Logs

POST
https://moonbeam.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:

  1. The filter ID (hex string).
idintegerrequired

Request identifier.

Response

200OK

Array of log objects matching the filter

Authorization

api-keyAuthapiKey in header

eth_getLogs

Get Logs

POST
https://moonbeam.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

eth_getStorageAt

Get Storage At

POST
https://moonbeam.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:

  1. address: string - Contract address to query storage from.
  2. position: string - Storage slot position (hex string).
  3. 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

eth_getTransactionByBlockHashAndIndex

Get Transaction by Block Hash and Index

POST
https://moonbeam.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:

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

Response

200OK

A transaction object or null if no transaction was found.

Authorization

api-keyAuthapiKey in header

eth_getTransactionByBlockNumberAndIndex

Get Transaction by Block Number and Index

POST
https://moonbeam.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:

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

Response

200OK

A transaction object, or null if not found.

Authorization

api-keyAuthapiKey in header

eth_getTransactionByHash

Get transaction by hash

POST
https://moonbeam.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

eth_getTransactionCount

Get transaction count (nonce) for address

POST
https://moonbeam.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

eth_getTransactionReceipt

Get transaction receipt by hash

POST
https://moonbeam.nownodes.io/

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required
idintegerrequired

Response

200OK

Transaction receipt if mined, otherwise null

Authorization

api-keyAuthapiKey in header

eth_getUncleByBlockHashAndIndex

Get uncle block by block hash and index

POST
https://moonbeam.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

eth_getUncleByBlockNumberAndIndex

Get uncle block by block number and index

POST
https://moonbeam.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

eth_getUncleCountByBlockHash

Get the number of uncle blocks by block hash

POST
https://moonbeam.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

eth_getUncleCountByBlockNumber

Get the number of uncle blocks by block number

POST
https://moonbeam.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

eth_hashrate

eth_hashrate

POST
https://moonbeam.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_maxPriorityFeePerGas

Get recommended maxPriorityFeePerGas value

POST
https://moonbeam.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

eth_mining

eth_mining

POST
https://moonbeam.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_newBlockFilter

Create a new block filter

POST
https://moonbeam.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

eth_newFilter

Create a new log filter

POST
https://moonbeam.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

eth_newPendingTransactionFilter

Create a filter for pending transactions

POST
https://moonbeam.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

eth_sendRawTransaction

Send a raw signed transaction

POST
https://moonbeam.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

eth_sendTransaction

Send a transaction using node-managed account

POST
https://moonbeam.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

eth_sign

Sign arbitrary data using eth_sign

POST
https://moonbeam.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

eth_signTransaction

eth_signTransaction

POST
https://moonbeam.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_syncing

Check if node is syncing

POST
https://moonbeam.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

eth_uninstallFilter

Uninstall an existing filter

POST
https://moonbeam.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

net_listening

net_listening

POST
https://moonbeam.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_peerCount

net_peerCount

POST
https://moonbeam.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_version

net_version

POST
https://moonbeam.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

web3_clientVersion

web3_clientVersion

POST
https://moonbeam.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_sha3

web3_sha3

POST
https://moonbeam.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

MAINNET / NODE

author_pendingExtrinsics

Get pending extrinsics from transaction pool

POST
https://moonbeam.nownodes.io/

Returns all pending extrinsics, potentially grouped by sender.

The author_pendingExtrinsics method retrieves all transactions that are currently in the transaction pool (mempool) waiting to be included in a block.

This method is useful for:

  • Monitoring transaction pool status
  • Debugging transaction propagation issues
  • Building transaction explorers
  • Analyzing network congestion

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_pendingExtrinsicsrequired

The method to be invoked

idstringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Successful response with pending extrinsics

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

author_submitAndWatchExtrinsic

Submit and watch extrinsic

POST
https://moonbeam.nownodes.io/

Submit a fully-formed extrinsic and watch for its lifecycle events.

The author_submitAndWatchExtrinsic method submits a signed extrinsic to the transaction pool and returns a subscription ID that can be used to track the extrinsic's progress through various stages until it is finalized or fails.

This method provides real-time updates about the extrinsic's status including:

  • When it enters the transaction pool
  • When it is included in a block
  • Finalization status
  • Any errors that occur

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_submitAndWatchExtrinsicrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Extrinsic submitted successfully, subscription created

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

author_submitExtrinsic

Submit a fully-formed extrinsic

POST
https://moonbeam.nownodes.io/

Submit a fully-formed extrinsic for inclusion in a block.

The author_submitExtrinsic method submits a signed extrinsic to the transaction pool. Unlike author_submitAndWatchExtrinsic, this method does not provide real-time updates about the extrinsic's status - it simply returns the extrinsic hash upon successful submission.

This method is suitable for applications that don't require immediate status updates and prefer a fire-and-forget approach to transaction submission.

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_submitExtrinsicrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Extrinsic submitted successfully

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error or pool rejection

Authorization

ApiKeyAuthapiKey in header

chain_getBlockHash

Get block hash by block number

POST
https://moonbeam.nownodes.io/

Get the hash of a specific block by its block number.

The chain_getBlockHash method returns the hash of the block header for the specified block number. If no block number is provided, it returns the hash of the latest finalized block.

This method is essential for:

  • Navigating the blockchain by block height
  • Verifying block existence and integrity
  • Building block explorers
  • Cross-referencing blocks across different queries

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getBlockHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<integer | string>required

Array containing optional block number

Show child attributes
One of

Block number (height) to query

integer

Block number as hex string

string

Response

200OK

Block hash retrieved successfully

400Bad Request

Invalid block number or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

chain_getBlock

Get block by hash

POST
https://moonbeam.nownodes.io/

Get a block by its hash.

The chain_getBlock method returns the full block data including the block header and all contained extrinsics (transactions). If no block hash is provided, it returns the latest finalized block.

This method provides complete information about a block including:

  • Block header with metadata
  • All extrinsics (transactions) in the block
  • Block production details
  • Parent-child relationships

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getBlockrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing optional block hash

Response

200OK

Block data retrieved successfully

400Bad Request

Invalid block hash or request

404Not Found

Block not found

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

chain_getFinalizedHead

Get latest finalized block hash

POST
https://moonbeam.nownodes.io/

Get the hash of the most recent finalized block.

The chain_getFinalizedHead method returns the block hash of the latest block that has been finalized by the GRANDPA finality gadget. Finalized blocks are irreversible and cannot be reorganized, providing the highest level of security for applications.

This method is crucial for:

  • Determining safe block height for transactions
  • Building applications that require finality guarantees
  • Monitoring chain progression and stability
  • Ensuring data consistency across services

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getFinalizedHeadrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Finalized block hash retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

chain_getHeader

Get Block Header

POST
https://moonbeam.nownodes.io/

Returns the header of the most recent (best) block in the Polkadot blockchain.

This method is part of the Polkadot JSON-RPC 2.0 specification for chain-related operations. The header contains critical information about the block including hashes, roots, and consensus data.

Body

application/json
jsonrpcstring2.0required

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

methodstringchain_getHeaderrequired

The JSON-RPC method to call. For this endpoint, must be "chain_getHeader".

paramsArray<any>required

Parameters for the method. For chain_getHeader, this should be an empty array as it retrieves the latest block header without additional parameters.

idinteger<int32>required

Request identifier that will be returned in the response. Used to match requests with responses when making multiple concurrent calls.

Response

200OK

Successful response containing the block header information.

The header represents the most recent block in the best chain and contains cryptographic commitments to the block's contents and state.

400Bad Request

Bad Request - Invalid JSON-RPC request Possible reasons:

  • Invalid JSON syntax
  • Missing required fields
  • Invalid method name
  • Invalid parameters
500Internal Server Error

Internal Server Error The node encountered an internal error while processing the request.

503Service Unavailable

Service Unavailable The node is currently unavailable, possibly due to maintenance or synchronization.

Authorization

ApiKeyAuthapiKey in header

payment_queryInfo

Query transaction fee information

POST
https://moonbeam.nownodes.io/

Retrieve the transaction fee information for an extrinsic.

The payment_queryInfo method estimates the transaction fees (including weight fees, length fees, and tips) for a given extrinsic without actually submitting it to the chain. This allows applications to display accurate fee estimates to users before they sign and submit transactions.

This method is essential for:

  • Wallet applications showing fee estimates
  • DApps calculating transaction costs
  • Users verifying transaction affordability
  • Batch transaction cost optimization

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringpayment_queryInforequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Fee information retrieved successfully

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

state_getMetadata

Get runtime metadata

POST
https://moonbeam.nownodes.io/

Returns the runtime metadata as a hex-encoded string.

The state_getMetadata method provides the complete runtime metadata for the chain. This metadata describes all the types, storage entries, extrinsics, and events available in the runtime. It's essential for building type-safe applications and understanding the chain's capabilities.

This method is crucial for:

  • Generating type definitions for applications
  • Understanding available storage items and extrinsics
  • Building dynamic DApp interfaces
  • Runtime version compatibility checking

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getMetadatarequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Optional parameters array. Can be empty or contain an optional block hash for historical metadata.

Response

200OK

Runtime metadata retrieved successfully

400Bad Request

Invalid request parameters

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

state_getReadProof

Get read proof for storage keys

POST
https://moonbeam.nownodes.io/

Returns proof of storage entries at a specific block.

The state_getReadProof method generates a Merkle proof for the specified storage keys at a given block. This proof can be used to verify the existence and values of storage entries without needing to trust the node providing the data.

This method is essential for:

  • Light client verification
  • Cross-chain bridge operations
  • Trustless data verification
  • State proof generation

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getReadProofrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string>required

Array containing storage keys and optional block hash.

Show child attributes
One of
Array<string>

Optional block hash to generate proof at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Read proof generated successfully

400Bad Request

Invalid storage keys or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

state_getRuntimeVersion

Get runtime version

POST
https://moonbeam.nownodes.io/

Returns the version information of the runtime.

The state_getRuntimeVersion method provides detailed version information about the current runtime, including spec version, transaction version, and supported APIs. This information is crucial for compatibility checking and ensuring clients interact correctly with the chain.

This method is essential for:

  • Client compatibility verification
  • Runtime upgrade detection
  • Transaction version validation
  • Network protocol compatibility

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getRuntimeVersionrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Optional parameters array. Can be empty or contain an optional block hash for historical runtime version.

Response

200OK

Runtime version information retrieved successfully

400Bad Request

Invalid block hash or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

state_getStorageHash

Get storage entry hash

POST
https://moonbeam.nownodes.io/

Returns the hash of a storage entry.

The state_getStorageHash method retrieves the hash of a specific storage entry at an optional block. This is useful for verifying storage contents without retrieving the full value, or for checking if a storage entry has changed.

This method is useful for:

  • Efficient storage change detection
  • Light client verification
  • Cache validation
  • Storage synchronization

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStorageHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes
One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage hash retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

state_getStorageSize

Get storage entry size

POST
https://moonbeam.nownodes.io/

Returns the size of a storage entry in bytes.

The state_getStorageSize method retrieves the byte size of a specific storage entry at an optional block. This is useful for estimating storage costs, monitoring storage growth, and optimizing data structures.

This method is useful for:

  • Storage cost estimation
  • Data structure optimization
  • Storage growth monitoring
  • Resource planning

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStorageSizerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes
One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage size retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

state_getStorage

Get storage entry value

POST
https://moonbeam.nownodes.io/

Returns the value of a storage entry.

The state_getStorage method retrieves the actual value of a specific storage entry at an optional block. This is the primary method for reading chain state data including account balances, staking information, and other on-chain data.

This method is essential for:

  • Reading account balances and information
  • Querying staking and governance data
  • Accessing smart contract state
  • Building blockchain explorers

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStoragerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes
One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage value retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

state_queryStorageAt

Query storage at specific block

POST
https://moonbeam.nownodes.io/

Returns storage entries for multiple keys at a specific block.

The state_queryStorageAt method retrieves the values of multiple storage keys at an optional block hash. This is useful for batch queries and fetching related storage entries efficiently in a single request.

This method is essential for:

  • Batch storage queries
  • Fetching related data efficiently
  • Building complex data views
  • Optimizing application performance

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_queryStorageAtrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string>required

Array containing storage keys and optional block hash.

Show child attributes
One of
Array<string>

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage values retrieved successfully

400Bad Request

Invalid storage keys or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

state_queryStorage

Query storage changes over a range of blocks

POST
https://moonbeam.nownodes.io/

Returns storage entries for multiple keys over a range of blocks.

The state_queryStorage method retrieves the historical changes of storage keys between two blocks. This is essential for tracking state changes over time, building historical data views, and analyzing storage evolution.

This method is essential for:

  • Historical data analysis
  • State change tracking
  • Building time-series data
  • Audit and compliance reporting

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_queryStoragerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string | string>required

Array containing storage keys, start block hash, and optional end block hash.

Show child attributes
One of
Array<string>

Start block hash for the query range

string

Optional end block hash for the query range. If omitted, uses the latest finalized block.

string

Response

200OK

Storage changes retrieved successfully

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

system_chain

Get chain name

POST
https://moonbeam.nownodes.io/

Returns the chain name.

The system_chain method retrieves the human-readable name of the chain the node is connected to. This helps identify the network and ensure applications are interacting with the correct blockchain.

This method is useful for:

  • Network identification
  • Multi-chain applications
  • User interface display
  • Configuration validation

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringsystem_chainrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Chain name retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

system_properties

Get system properties

POST
https://moonbeam.nownodes.io/

Returns custom properties of the chain.

The system_properties method retrieves a collection of chain-specific properties that define the network's configuration and characteristics. These properties are essential for applications to properly interact with the chain.

This method is essential for:

  • Chain configuration discovery
  • Token decimal and SS58 format configuration
  • Network-specific feature detection
  • Wallet and application setup

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

methodstringsystem_propertiesrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

System properties retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header