JSON-RPC methods supported on Avalanche Mainnet and Avalanche Testnet through Tatum RPC Gateway, with base URLs and an example request.
Call Avalanche 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.
Avalanche has 3 JSON-RPC interfaces, each with its own base URLs and methods: C-Chain, P-Chain and X-Chain.
C-Chain
Base URLs
| Network | Base URL |
|---|---|
| Avalanche Mainnet | https://avalanche-mainnet.gateway.tatum.io |
| Avalanche Testnet | https://avalanche-testnet.gateway.tatum.io |
Example request
curl 'https://avalanche-mainnet.gateway.tatum.io' \
--header 'content-type: application/json' \
--header 'x-api-key: {YOUR_API_KEY}' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'Methods
53 methods. Parameters and responses are described in the Avalanche C-Chain API reference.
| Method | Description |
|---|---|
debug_getBadBlocks | Returns the last bad blocks the node has seen on the network. |
debug_storageRangeAt | Returns the storage of a contract at a given block and transaction index. |
debug_traceBlock | Replays all transactions of an RLP-encoded block and returns their traces. |
debug_traceBlockByHash | Replays all transactions of a block, selected by hash, and returns their traces. |
debug_traceBlockByNumber | Replays all transactions of a block, selected by number, and returns their traces. |
debug_traceCall | Runs a call on top of a given block without creating a transaction and returns its trace. |
debug_traceTransaction | Replays a transaction and returns its execution trace. |
eth_blockNumber | Returns the number of the most recent block. |
eth_call | Executes a message call immediately without creating a transaction on the chain. |
eth_callMany | Executes a list of message calls in sequence on top of a given block, without creating transactions. |
eth_chainId | Returns the chain ID used for signing replay-protected transactions. |
eth_estimateGas | Estimates the gas needed to execute a transaction without adding it to the chain. |
eth_feeHistory | Returns base fees, gas usage ratios and priority fee percentiles for a range of blocks. |
eth_gasPrice | Returns the current gas price in wei. |
eth_getBalance | Returns the balance of an address in wei. |
eth_getBlockByHash | Returns information about a block by hash. |
eth_getBlockByNumber | Returns information about a block by number. |
eth_getBlockReceipts | Returns the receipts of all transactions in a block. |
eth_getBlockTransactionCountByHash | Returns the number of transactions in a block, selected by hash. |
eth_getBlockTransactionCountByNumber | Returns the number of transactions in a block, selected by number. |
eth_getCode | Returns the bytecode at an address. |
eth_getLogs | Returns the logs that match a filter object. |
eth_getProof | Returns the Merkle proof of an account and, optionally, of some of its storage slots. |
eth_getStorageAt | Returns the value of a storage slot at an address. |
eth_getTransactionByBlockHashAndIndex | Returns a transaction by block hash and transaction index. |
eth_getTransactionByBlockNumberAndIndex | Returns a transaction by block number and transaction index. |
eth_getTransactionByHash | Returns a transaction by hash. |
eth_getTransactionCount | Returns the number of transactions sent from an address (its nonce). |
eth_getTransactionReceipt | Returns the receipt of a transaction by transaction hash. |
eth_getUncleByBlockHashAndIndex | Returns an uncle of a block, selected by block hash and uncle index. |
eth_getUncleByBlockNumberAndIndex | Returns an uncle of a block, selected by block number and uncle index. |
eth_getUncleCountByBlockHash | Returns the number of uncles in a block, selected by hash. |
eth_getUncleCountByBlockNumber | Returns the number of uncles in a block, selected by number. |
eth_maxPriorityFeePerGas | Returns a suggested priority fee (tip) per gas in wei. |
eth_sendRawTransaction | Submits a signed, RLP-encoded transaction to the network. |
eth_signTypedData | Signs EIP-712 typed structured data. |
eth_signTypedData_v3 | Signs EIP-712 typed structured data (version 3 of the format). |
eth_simulateV1 | Simulates a sequence of blocks and calls on top of a given block and returns the results. |
eth_syncing | Returns the sync status of the node, or false when it is not syncing. |
net_listening | Returns true when the client is listening for network connections. |
net_peerCount | Returns the number of peers connected to the client. |
net_version | Returns the current network ID. |
trace_block | Returns the traces of all transactions in a block. |
trace_call | Runs a call and returns the requested traces (trace, vmTrace, stateDiff) without creating a transaction. |
trace_callMany | Runs a list of calls in sequence, each on top of the state of the previous one, and returns their traces. |
trace_rawTransaction | Traces a signed raw transaction without broadcasting it. |
trace_replayBlockTransactions | Replays all transactions of a block and returns the requested traces. |
trace_replayTransaction | Replays a transaction and returns the requested traces. |
trace_transaction | Returns all traces of a transaction. |
txpool_content | Returns the pending and queued transactions in the transaction pool. |
txpool_inspect | Returns a text summary of the pending and queued transactions in the transaction pool. |
txpool_status | Returns the number of pending and queued transactions in the transaction pool. |
web3_clientVersion | Returns the client version. |
The gateway lists its supported methods at runtime:
P-Chain
Base URLs
| Network | Base URL |
|---|---|
| Avalanche Mainnet | https://avalanche-mainnet.gateway.tatum.io/ext/bc/P |
| Avalanche Testnet | https://avalanche-testnet.gateway.tatum.io/ext/bc/P |
Example request
curl 'https://avalanche-mainnet.gateway.tatum.io/ext/bc/P' \
--header 'content-type: application/json' \
--header 'x-api-key: {YOUR_API_KEY}' \
--data '{"jsonrpc":"2.0","method":"platform.getHeight","params":{},"id":1}'Methods
21 methods. Parameters and responses are described in the Avalanche P-Chain API reference; each method name links to its page there.
| Method | Description |
|---|---|
platform.getBlock | Returns a block by its ID. |
platform.getBlockByHeight | Returns a block by its height. |
platform.getBlockchainStatus | Returns the status of a blockchain. |
platform.getCurrentSupply | Returns an upper bound on the number of tokens that can stake a Subnet. |
platform.getCurrentValidators | Lists the current validators of a Subnet. |
platform.getFeeConfig | Returns the dynamic fee configuration of the P-Chain. |
platform.getFeeState | Returns the current fee state of the P-Chain. |
platform.getHeight | Returns the height of the last accepted block. |
platform.getL1Validator | Returns a current L1 validator by its validation ID. |
platform.getMinStake | Returns the minimum validator and delegator stake for a Subnet. |
platform.getProposedHeight | Returns the node's current proposer VM height. |
platform.getStakingAssetID | Returns the asset ID of a Subnet's staking asset. |
platform.getSubnet | Returns the owners and details of a Subnet or L1. |
platform.getTimestamp | Returns the current P-Chain timestamp. |
platform.getTotalStake | Returns the total amount of tokens staked on a Subnet. |
platform.getTx | Returns a transaction by its ID. |
platform.getTxStatus | Returns the status of a transaction by its ID. |
platform.getUTXOs | Returns the UTXOs that reference a given set of addresses. |
platform.issueTx | Submits a signed transaction to the P-Chain. |
platform.validatedBy | Returns the Subnet that validates a given blockchain. |
platform.validates | Lists the IDs of the blockchains a Subnet validates. |
The gateway lists its supported methods at runtime:
X-Chain
Base URLs
| Network | Base URL |
|---|---|
| Avalanche Mainnet | https://avalanche-mainnet.gateway.tatum.io/ext/bc/X |
| Avalanche Testnet | https://avalanche-testnet.gateway.tatum.io/ext/bc/X |
Example request
curl 'https://avalanche-mainnet.gateway.tatum.io/ext/bc/X' \
--header 'content-type: application/json' \
--header 'x-api-key: {YOUR_API_KEY}' \
--data '{"jsonrpc":"2.0","method":"avm.getHeight","params":{},"id":1}'Methods
8 methods. Parameters and responses are described in the Avalanche X-Chain API reference; each method name links to its page there.
| Method | Description |
|---|---|
avm.getAssetDescription | Returns the name, symbol and denomination of an asset. |
avm.getBlock | Returns a block by its ID. |
avm.getBlockByHeight | Returns a block by its height. |
avm.getHeight | Returns the height of the last accepted block. |
avm.getTx | Returns a transaction by its ID. |
avm.getTxFee | Returns the transaction and asset creation fees of the network. |
avm.getUTXOs | Returns the UTXOs that reference given addresses, including atomic UTXOs from another chain. |
avm.issueTx | Submits a signed transaction to the X-Chain. |
The gateway lists its supported methods at runtime:
Method unavailable?If you need a method we don't support yet, contact support.