RPC Endpoints

Below, you find a list of official and third-party IoTeX endpoints for both full node and archive nodes. These endpoints can be used to configure any Ethereum wallet or developer tool to interact with the IoTeX blockchain.

→ Interested in running an IoTeX RPC Node?

Checkout the dedicated section to learn how to run an IoTeX full node if you want to spin up an IoTeX RPC endpoint.

→ Setup an IoTeX RPC Node

Official Ethereum JSON-API

Please refer to the official Ethereum Documentation for the RPC JSON API:

→ Ethereum JSON RPC API

IoTeX Mainnet

EVM Chain ID: 4689

Full Node

Endpoint	Type	Provider	More
https://babel-api.mainnet.iotex.io	HTTP	IoTeX Foundation	iotex.io
wss://babel-api.mainnet.iotex.io/ws	WSS	IoTeX Foundation	iotex.io
https://babel-api.mainnet.iotex.one	HTTP	IoTeX Foundation	iotex.io
https://babel-api.fastblocks.io	HTTP	Fastblocks	fastblock.io
https://iotexrpc.com	HTTP	Ankr	iotexrpc.com
https://rpc.ankr.com/iotex	HTTP	Ankr	ankr.com
https://4689.rpc.thirdweb.com	HTTP	Thirdweb	Thirdweb

Archive Node

Endpoint	Type	Provider	More
https://archive-mainnet.iotex.io	HTTP	IoTeX Foundation	iotex.io

IoTeX Testnet

EVM Chain ID: 4690

Endpoint	Type	Provider	More
https://babel-api.testnet.iotex.io	HTTP	IoTeX Foundation	iotex.io
wss://babel-api.testnet.iotex.io/ws	WSS	IoTeX Foundation	iotex.io
https://babel-api.testnet.iotex.one	HTTP	IoTeX Foundation	iotex.io
https://babel-api.testnet.iotex.one/wss	WSS	IoTeX Foundation	iotex.io

Archive Node

Endpoint	Type	Provider	More
https://archive-testnet.iotex.io	HTTP	IoTeX Foundation	iotex.io

Examples

Query an IoTeX full node to get the current IOTX balance for an address

The code below utilizes curl to query the public IoTeX RPC full-node endpoint to check the balance of 0xE584...C5D46 on the IoTeX Blockchain:

» curl -X POST -H "Content-Type:application/json" --data '{"id": 1, "jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0xE584ca6F469c11140Bb9c4617Cb8f373E38C5D46", ""]}' https://babel-api.mainnet.iotex.io
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x10f0cf064dd59200000"
}

Which returns the balance in WEI 0x10f0cf064dd59200000 (decimal 5000¹⁸ , equivalent to 5000 IOTX).

Query an IoTeX archive node to get the IOTX balance for an address in the past

Input block: 30,000,000 (0x1C9C380)

curl -X POST https://archive-mainnet.iotex.io \
     -H "Content-Type: application/json" \
     -d '{ 
           "jsonrpc": "2.0", 
           "method": "eth_getBalance", 
           "params": ["0xe46be34b4b78ed661783acf8bd241d0d074ce9ff", "0x1C9C380"], 
           "id": 1 
         }'

Query all Transfer events for ioUSDT on IoTeX in a certain blocks range:

curl -X POST https://archive-mainnet.iotex.io \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [{
    "fromBlock": "0x1ce29c0",
    "toBlock": "0x1ce29e0",
    "address": "0x6fbcdc1169b5130c59e72e51ed68a84841c98cd1",
    "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
  }],
  "id": 1
}'