Polkadot - JSON-RPC

JSON-RPC methods supported on Polkadot Mainnet and Polkadot Westend through Tatum RPC Gateway, with base URLs and an example request.

Call Polkadot JSON-RPC methods through Tatum RPC Gateway. Send an HTTP POST request with a JSON-RPC 2.0 body to the network's base URL, with your API key in the x-api-key header. See Authentication.

Base URLs

NetworkBase URL
Polkadot Mainnethttps://polkadot-mainnet.gateway.tatum.io
Polkadot Westendhttps://polkadot-westend.gateway.tatum.io

Example request

curl 'https://polkadot-mainnet.gateway.tatum.io' \
  --header 'content-type: application/json' \
  --header 'x-api-key: {YOUR_API_KEY}' \
  --data '{"jsonrpc":"2.0","method":"chain_getHeader","params":[],"id":1}'

Methods

45 methods. Parameters and responses are described in the Polkadot.js JSON-RPC reference.

MethodDescription
author_pendingExtrinsicsReturns all extrinsics pending in the transaction pool.
author_removeExtrinsicRemoves extrinsics from the transaction pool and temporarily bans them. Unsafe; only on nodes that allow unsafe RPC methods.
author_submitAndWatchExtrinsicSubmits an extrinsic and subscribes to its status until unsubscribed. Needs a WebSocket connection.
author_submitExtrinsicSubmits a signed extrinsic for inclusion in a block and returns its hash.
beefy_getFinalizedHeadReturns the hash of the latest block finalized by BEEFY.
chain_getBlockReturns the header and body of a block by hash, or of the latest block.
chain_getBlockHashReturns the hash of a block by number, or of the latest block.
chain_getFinalizedHeadReturns the hash of the last finalized block.
chain_getHeadAlias of chain_getBlockHash.
chain_getHeaderReturns the header of a block by hash, or of the latest block.
childstate_getKeysReturns the keys with a given prefix from a child storage.
childstate_getKeysPagedReturns the keys with a given prefix from a child storage, with pagination.
childstate_getStorageReturns a child storage entry at a given block.
childstate_getStorageEntriesReturns child storage entries for multiple keys at a given block.
childstate_getStorageHashReturns the hash of a child storage entry at a given block.
childstate_getStorageSizeReturns the size of a child storage entry at a given block.
grandpa_proveFinalityReturns a finality proof (justification) for a given block number.
grandpa_roundStateReturns the state of the current best GRANDPA round and background rounds.
mmr_generateProofGenerates a Merkle Mountain Range (MMR) proof for given block numbers.
mmr_rootReturns the Merkle Mountain Range (MMR) root hash for the current best block.
mmr_verifyProofVerifies a Merkle Mountain Range (MMR) proof against the on-chain root.
mmr_verifyProofStatelessVerifies a Merkle Mountain Range (MMR) proof against a given MMR root.
payment_queryFeeDetailsReturns the detailed fee breakdown of an encoded extrinsic. Deprecated in favor of the TransactionPaymentApi runtime API.
payment_queryInfoReturns the weight, class and partial fee of an encoded extrinsic. Deprecated in favor of the TransactionPaymentApi runtime API.
rpc_methodsLists the RPC methods exposed by the node.
state_callCalls a runtime API function at a given block and returns the SCALE-encoded result.
state_getChildReadProofReturns a storage proof for child storage keys at a given block.
state_getKeysDeprecated. Use state_getKeysPaged instead.
state_getKeysPagedReturns the storage keys with a given prefix, with pagination.
state_getMetadataReturns the SCALE-encoded runtime metadata.
state_getReadProofReturns a storage proof for given keys at a given block.
state_getRuntimeVersionReturns the runtime version at a given block.
state_getStorageReturns the value of a storage key at a given block.
state_getStorageHashReturns the hash of a storage entry at a given block.
state_getStorageSizeReturns the size of a storage entry at a given block.
state_queryStorageAtReturns the values of given storage keys at a given block.
sync_state_genSyncSpecReturns the JSON-serialized chain spec of the node, with its sync state.
system_chainReturns the chain name.
system_chainTypeReturns the chain type, such as Live or Development.
system_healthReturns the node's health: peer count, sync status and whether it should have peers.
system_nameReturns the node implementation name.
system_nodeRolesReturns the roles the node is running as.
system_propertiesReturns the chain properties from the chain spec, such as token symbol and decimals.
system_syncStateReturns the node's sync state: starting, current and highest known block.
system_versionReturns the node implementation version.

The gateway lists its supported methods at runtime:

Method unavailable?

If you need a method we don't support yet, contact support.