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

wss://babel-api.mainnet.iotex.io/ws

WSS

IoTeX Foundation

https://babel-api.mainnet.iotex.one

HTTP

IoTeX Foundation

https://babel-api.fastblocks.io

HTTP

Fastblocks

https://iotexrpc.com

HTTP

Ankr

https://rpc.ankr.com/iotex

HTTP

Ankr

https://4689.rpc.thirdweb.com

HTTP

Thirdweb

Archive Node

Endpoint
Type
Provider
More

https://archive-mainnet.iotex.io

HTTP

IoTeX Foundation

IoTeX Testnet

EVM Chain ID: 4690

Endpoint
Type
Provider
More

https://babel-api.testnet.iotex.io

HTTP

IoTeX Foundation

wss://babel-api.testnet.iotex.io/ws

WSS

IoTeX Foundation

https://babel-api.testnet.iotex.one

HTTP

IoTeX Foundation

https://babel-api.testnet.iotex.one/wss

WSS

IoTeX Foundation

Archive Node

Endpoint
Type
Provider
More

https://archive-testnet.iotex.io

HTTP

IoTeX Foundation

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
}'

Last updated

Logo

This documentation portal is currently undergoing updates to align with the IoTeX 2.0 Whitepaper release. Information provided here may be incomplete, or out-of-date. Please use this portal for preliminary reference only, and check out the official IoTeX 2.0 Whitepaper for updated information.

.

2024 | IoTeX