Zilliqa - JSON-RPC

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

Call Zilliqa 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
Zilliqa Mainnethttps://zilliqa-mainnet.gateway.tatum.io
Zilliqa Testnethttps://zilliqa-testnet.gateway.tatum.io

Example request

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

Methods

77 methods. Parameters and responses are described in the Zilliqa API reference; linked method names go to their page there.

MethodDescription
CreateTransactionCreates a transaction from signed parameters and sends it to the network.
DSBlockListingReturns a paginated list of Directory Service blocks. Deprecated in Zilliqa 2; returns a placeholder value.
eth_blockNumberReturns the number of the most recent block.
eth_callExecutes a message call immediately without creating a transaction on the chain.
eth_callManyExecutes a list of message calls in sequence on top of a given block, without creating transactions.
eth_chainIdReturns the chain ID used for signing replay-protected transactions.
eth_estimateGasEstimates the gas needed to execute a transaction without adding it to the chain.
eth_feeHistoryReturns base fees, gas usage ratios and priority fee percentiles for a range of blocks.
eth_gasPriceReturns the current gas price in wei.
eth_getBalanceReturns the balance of an address in wei.
eth_getBlockByHashReturns information about a block by hash.
eth_getBlockByNumberReturns information about a block by number.
eth_getBlockTransactionCountByHashReturns the number of transactions in a block, selected by hash.
eth_getBlockTransactionCountByNumberReturns the number of transactions in a block, selected by number.
eth_getCodeReturns the bytecode at an address.
eth_getLogsReturns the logs that match a filter object.
eth_getProofReturns the Merkle proof of an account and, optionally, of some of its storage slots.
eth_getStorageAtReturns the value of a storage slot at an address.
eth_getTransactionByBlockHashAndIndexReturns a transaction by block hash and transaction index.
eth_getTransactionByBlockNumberAndIndexReturns a transaction by block number and transaction index.
eth_getTransactionByHashReturns a transaction by hash.
eth_getTransactionCountReturns the number of transactions sent from an address (its nonce).
eth_getTransactionReceiptReturns the receipt of a transaction by transaction hash.
eth_getUncleByBlockHashAndIndexReturns an uncle of a block, selected by block hash and uncle index.
eth_getUncleByBlockNumberAndIndexReturns an uncle of a block, selected by block number and uncle index.
eth_getUncleCountByBlockHashReturns the number of uncles in a block, selected by hash.
eth_getUncleCountByBlockNumberReturns the number of uncles in a block, selected by number.
eth_maxPriorityFeePerGasReturns a suggested priority fee (tip) per gas in wei.
eth_sendRawTransactionSubmits a signed, RLP-encoded transaction to the network.
eth_signTypedDataSigns EIP-712 typed structured data.
eth_signTypedData_v3Signs EIP-712 typed structured data (version 3 of the format).
eth_syncingReturns the sync status of the node, or false when it is not syncing.
GetBalanceReturns the balance and nonce of an account.
GetBlockchainInfoReturns current network statistics.
GetContractAddressFromTransactionIDReturns the address of the contract deployed by a transaction.
GetCurrentDSCommReturns the public keys of the Directory Service committee. Deprecated in Zilliqa 2; returns a placeholder value.
GetCurrentDSEpochReturns the current number of Directory Service blocks. Deprecated in Zilliqa 2; returns a placeholder value.
GetCurrentMiniEpochReturns the current TX block number.
GetDsBlockReturns a Directory Service block by block number. Deprecated in Zilliqa 2; returns a placeholder value.
GetDSBlockRateReturns the Directory Service block rate per second. Deprecated in Zilliqa 2; returns a placeholder value.
GetLatestDsBlockReturns the latest Directory Service block. Deprecated in Zilliqa 2; returns a placeholder value.
GetLatestTxBlockReturns the latest TX block.
GetMinerInfoReturns the DS committee and shard members for a DS block. Returns placeholder data in Zilliqa 2.
GetMinimumGasPriceReturns the minimum gas price in Qa.
GetNetworkIdReturns the chain ID of the network.
GetNodeTypeReturns the node type. Always returns Seed in Zilliqa 2.
GetNumDSBlocksReturns the number of validated Directory Service blocks. Deprecated in Zilliqa 2; returns a placeholder value.
GetNumPeersReturns the number of peers of the node.
GetNumTransactionsReturns the number of validated transactions in the network.
GetNumTxBlocksReturns the number of TX blocks in the network.
GetNumTxnsDSEpochReturns the number of transactions in the current DS epoch. Deprecated in Zilliqa 2; returns a placeholder value.
GetNumTxnsTxEpochReturns the number of transactions in the current TX epoch.
GetPrevDifficultyReturns the minimum shard difficulty of the previous block. Always returns 0 in Zilliqa 2.
GetPrevDSDifficultyReturns the minimum DS difficulty of the previous block. Always returns 0 in Zilliqa 2.
GetRecentTransactionsReturns up to 100 most recent validated transactions.
GetShardingStructureReturns the sharding structure. Not supported in Zilliqa 2.
GetSmartContractCodeReturns the Scilla or EVM code of a smart contract.
GetSmartContractInitReturns the initialization (immutable) parameters of a smart contract.
GetSmartContractsLists the smart contracts deployed by an account.
GetSmartContractStateReturns the mutable state variables of a Scilla smart contract.
GetSmartContractSubStateReturns a selected part of the state of a Scilla smart contract.
GetSoftConfirmedTransactionReturns a transaction by hash, including soft-confirmed transactions.
GetStateProofReturns the state proof of a smart contract. Returns empty values in Zilliqa 2.
GetTotalCoinSupplyReturns the total ZIL supply.
GetTransactionReturns a transaction by hash.
GetTransactionRateReturns the current transaction rate per second.
GetTransactionsForTxBlockReturns the hashes of the transactions in a TX block.
GetTransactionsForTxBlockExReturns the hashes of the transactions in a TX block, in pages of 2,500.
GetTransactionStatusReturns the status of a transaction.
GetTxBlockReturns a TX block by block number.
GetTxBlockRateReturns the current TX block rate per second.
GetTxnBodiesForTxBlockReturns the full transactions in a TX block.
GetVersionReturns the software version of the node.
net_peerCountReturns the number of peers connected to the client.
net_versionReturns the current network ID.
TxBlockListingReturns a paginated list of TX blocks and their hashes.
web3_clientVersionReturns the client version.

The gateway lists its supported methods at runtime:

Method unavailable?

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