Skip to content

Latest commit

 

History

History
91 lines (63 loc) · 4.77 KB

rpc-endpoints.md

File metadata and controls

91 lines (63 loc) · 4.77 KB

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.

{% hint style="info" %} → 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 {% endhint %}

{% hint style="info" %} Official Ethereum JSON-API

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

→ Ethereum JSON RPC API {% endhint %}

IoTeX Mainnet

EVM Chain ID: 4689

Full Node

EndpointTypeProviderMore
https://babel-api.mainnet.iotex.ioHTTPIoTeX Foundationiotex.io
wss://babel-api.mainnet.iotex.io/wsWSSIoTeX Foundationiotex.io
https://babel-api.mainnet.iotex.oneHTTPIoTeX Foundationiotex.io
https://babel-api.fastblocks.ioHTTPFastblocksfastblock.io
https://iotexrpc.comHTTPAnkriotexrpc.com
https://rpc.ankr.com/iotexHTTPAnkrankr.com
https://4689.rpc.thirdweb.comHTTPThirdwebThirdweb

Archive Node

EndpointTypeProviderMore
https://archive-mainnet.iotex.ioHTTPIoTeX Foundationiotex.io

IoTeX Testnet

EVM Chain ID: 4690

EndpointTypeProviderMore
https://babel-api.testnet.iotex.ioHTTPIoTeX Foundationiotex.io
wss://babel-api.testnet.iotex.io/wsWSSIoTeX Foundationiotex.io
https://babel-api.testnet.iotex.oneHTTPIoTeX Foundationiotex.io
https://babel-api.testnet.iotex.one/wssWSSIoTeX Foundationiotex.io

Archive Node

EndpointTypeProviderMore
https://archive-testnet.iotex.ioHTTPIoTeX Foundationiotex.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
}'