IoTeXscan API
Overview
At IoTeX, we provide a powerful block explorer, IoTeXScan, which allows users and developers to easily query data on the IoTeX blockchain. To make it even easier for developers familiar with Ethereum tools, we’ve implemented the same Etherscan API on IoTeXScan.
This guide provides a quick overview of how to get started with our IoTeXScan API and the available endpoints.
Getting Started
You can use IoTeXScan’s API just as you would use the Etherscan API. The API allows developers to retrieve blockchain data programmatically, such as transaction details, block information, account balances, and much more.
Here are the key steps to start using the API:
Base URL: https://dev.iotexscan.io/api
API Key: To interact with the IoTeXScan API, no API key is required. However, queries are rate-limited to 1 request per second.
Example endpoint:
https://dev.iotexscan.io/api?module=account&action=balance&address=0x139929a597b91ea89f41026b65b281611890f13bComplete API
Eth Address or Io Address
0x883cb2e2d9c5d4d9af5b0d37fc39fa2284405682Successful response
GET /api?module=contract&action=getabi?address=0x883cb2e2d9c5d4d9af5b0d37fc39fa2284405682 HTTP/1.1
Host:
Accept: */*
Successful response
textEth Address or Io Address
0x883cb2e2d9c5d4d9af5b0d37fc39fa2284405682Successful response
GET /api?module=contract&action=getcontractcreation?contractaddresses=0x883cb2e2d9c5d4d9af5b0d37fc39fa2284405682 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x883cb2e2d9c5d4d9af5b0d37fc39fa2284405682Successful response
GET /api?module=contract&action=getsourcecode?address=0x883cb2e2d9c5d4d9af5b0d37fc39fa2284405682 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Successful response
GET /api?module=contract&action=checkverifystatus?guid=text HTTP/1.1
Host:
Accept: */*
Successful response
No content
Hash
0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6Successful response
GET /api?module=proxy&action=eth_getTransactionByHash?txhash=0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6 HTTP/1.1
Host:
Accept: */*
Successful response
No content
block height in hex string
0x0Pattern: ^0x[0-9a-fA-F]+$0x0Pattern: ^0x[0-9a-fA-F]+$Successful response
GET /api?module=proxy&action=eth_getTransactionByBlockNumberAndIndex?tag=0x0&index=0x0 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Block tag, default 'latest
latestPossible values: Successful response
GET /api?module=proxy&action=eth_getTransactionCount?address=text HTTP/1.1
Host:
Accept: */*
Successful response
No content
0x0Pattern: ^0x[0-9a-fA-F]+$Successful response
GET /api?module=proxy&action=eth_sendRawTransaction?hex=0x0 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Hash
0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6Successful response
GET /api?module=proxy&action=eth_getTransactionReceipt?txhash=0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x0Pattern: ^0x[0-9a-fA-F]+$Block tag, default 'latest
latestPossible values: Successful response
GET /api?module=proxy&action=eth_call?to=text&data=0x0 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Block tag, default 'latest
latestPossible values: Successful response
GET /api?module=proxy&action=eth_getCode?address=text HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x0Pattern: ^0x[0-9a-fA-F]+$Block tag, default 'latest
latestPossible values: Successful response
GET /api?module=proxy&action=eth_getStorageAt?address=text&position=0x0 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Successful response
GET /api?module=proxy&action=eth_gasPrice HTTP/1.1
Host:
Accept: */*
Successful response
No content
0x0Pattern: ^0x[0-9a-fA-F]+$Eth Address or Io Address
0x0Pattern: ^0x[0-9a-fA-F]+$0x0Pattern: ^0x[0-9a-fA-F]+$0x0Pattern: ^0x[0-9a-fA-F]+$Successful response
GET /api?module=proxy&action=eth_estimateGas?data=0x0&to=text&value=0x0&gasPrice=0x0&gas=0x0 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0xa00744882684c3e4747faefd68d283ea44099d03Example: 0xa00744882684c3e4747faefd68d283ea44099d03Block tag, default 'latest
latestPossible values: Successful response
GET /api?module=account&action=balance?address=0xa00744882684c3e4747faefd68d283ea44099d03 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Block tag, default 'latest
latestPossible values: Successful response
GET /api?module=account&action=balancemulti?address=text HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0xa00744882684c3e4747faefd68d283ea44099d03Example: 0xa00744882684c3e4747faefd68d283ea44099d03Page number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Sort order, default 'asc
ascPossible values: Start block number
End block number
Successful response
GET /api?module=account&action=txlist?address=0xa00744882684c3e4747faefd68d283ea44099d03 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Hash
0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6Page number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Sort order, default 'asc
ascPossible values: Start block number
End block number
Successful response
GET /api?module=account&action=txlistinternal HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x6c0bf4b53696b5434a0d21c7d13aa3cbf754913eEth Address or Io Address
0xe4650c74dfd5c20fee8dbb9beaf61820aa39ad8aPage number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Sort order, default 'asc
ascPossible values: Start block number
End block number
Successful response
GET /api?module=account&action=tokentx?address=0xe4650c74dfd5c20fee8dbb9beaf61820aa39ad8a HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0xec0cd5c1d61943a195bca7b381dc60f9f545a540Eth Address or Io Address
0xd16a5552e51941486deb36109586ae4afc1d6946Page number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Sort order, default 'asc
ascPossible values: Start block number
End block number
Successful response
GET /api?module=account&action=tokennfttx?address=0xd16a5552e51941486deb36109586ae4afc1d6946 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x36fb3f6d43460293419bd58655f675f2fce17fefEth Address or Io Address
0x9564dfb4f3c85f5604c6bd862de6f1b172caa982Page number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Sort order, default 'asc
ascPossible values: Start block number
End block number
Successful response
GET /api?module=account&action=token1155tx?address=0x9564dfb4f3c85f5604c6bd862de6f1b172caa982 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Eth Address or Io Address
Successful response
GET /api?module=account&action=tokenbalance?contractaddress=text&address=text HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Block number
10000Successful response
GET /api?module=account&action=tokensupplyhistory?contractaddress=text&blockno=10000 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Eth Address or Io Address
Block number
10000Successful response
GET /api?module=account&action=tokenbalancehistory?contractaddress=text&address=text&blockno=10000 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Page number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Successful response
GET /api?module=account&action=addresstokennftbalance?address=text HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Eth Address or Io Address
Page number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Successful response
GET /api?module=account&action=addresstokennftinventory?address=text&convertAddress=text HTTP/1.1
Host:
Accept: */*
Successful response
No content
Block number
10000Successful response
GET /api?module=block&action=getblockreward?blockno=10000 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Unix timestamp
1763131474Before timestamp or after timestamp, default 'before'
beforePossible values: Successful response
GET /api?module=block&action=getblocknobytime?timestamp=1763131474 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
Block number
10000Block number
10000Page number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Successful response
GET /api?module=log&action=getLogs?address=text&fromBlock=10000&toBlock=10000 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x6fbcdc1169b5130c59e72e51ed68a84841c98cd1Successful response
GET /api?module=stats&action=tokensupply?contractaddress=0x6fbcdc1169b5130c59e72e51ed68a84841c98cd1 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=stats&action=dailyblkcount?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=stats&action=dailyblockrewards?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Successful response
GET /api?module=stats&action=iotxprice HTTP/1.1
Host:
Accept: */*
Successful response
No content
Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=stats&action=dailytxnfee?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=stats&action=dailynewaddress?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=stats&action=dailytx?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=stats&action=iotxdailyprice?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x6fbcdc1169b5130c59e72e51ed68a84841c98cd1Page number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Successful response
GET /api?module=token&action=tokenholderlist?contractaddress=0x6fbcdc1169b5130c59e72e51ed68a84841c98cd1 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Successful response
GET /api?module=gastracker&action=gasestimate?gasprice=text HTTP/1.1
Host:
Accept: */*
Successful response
No content
Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=gastracker&action=dailyavggaslimit?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Successful response
GET /api?module=gastracker&action=gasoracle HTTP/1.1
Host:
Accept: */*
Successful response
{
"LastBlock": "text",
"SafeGasPrice": "text",
"ProposeGasPrice": "text",
"FastGasPrice": "text",
"suggestBaseFee": "text",
"gasUsedRatio": "text"
}Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=gastracker&action=dailyavggasprice?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Start date
2025-11-07Example: 2025-11-07End date
2025-11-14Example: 2025-11-14Sort order, default 'asc
ascPossible values: Successful response
GET /api?module=gastracker&action=dailygasused?startdate=2025-11-07&enddate=2025-11-14 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Contract address to verify
0x883cb2e2d9c5d4d9af5b0d37fc39fa2284405682Contract source code or Standard JSON Input
{"language":"Solidity","sources":{},"settings":{}}Compiler version (e.g., v0.8.19+commit.7dd6d404)
v0.8.19+commit.7dd6d404Source code format type
solidity-single-filePossible values: Contract name (inferred from JSON if not provided)
MyContractWhether optimization was enabled (0/1 or true/false)
1Number of optimization runs (default: 200)
200EVM version (e.g., istanbul, london, paris)
parisLicense type identifier (1-14)
3Successful response
POST /api?module=contract&action=verifysourcecode?contractaddress=0x883cb2e2d9c5d4d9af5b0d37fc39fa2284405682&sourceCode={"language"%3A"Solidity"%2C"sources"%3A{}%2C"settings"%3A{}}&compilerversion=v0.8.19%2Bcommit.7dd6d404 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Hash
0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6Successful response
GET /api?module=transaction&action=getstatus?txhash=0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Hash
0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6Successful response
GET /api?module=transaction&action=gettxreceiptstatus?txhash=0xbe9126db27c58dd5df01340d7c3cd209481440920bddc2b7314b7123a065dda6 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Successful response
GET /api?module=proxy&action=eth_blockNumber HTTP/1.1
Host:
Accept: */*
Successful response
No content
block height in hex string
0x0Pattern: ^0x[0-9a-fA-F]+$If true, returns the full transaction objects, if false only the hashes of the transactions, default 'false
falseExample: falseSuccessful response
GET /api?module=proxy&action=eth_getBlockByNumber?tag=0x0 HTTP/1.1
Host:
Accept: */*
Successful response
No content
block height in hex string
0x0Pattern: ^0x[0-9a-fA-F]+$0x0Pattern: ^0x[0-9a-fA-F]+$Successful response
GET /api?module=proxy&action=eth_getUncleByBlockNumberAndIndex?tag=0x0&index=0x0 HTTP/1.1
Host:
Accept: */*
Successful response
No content
block height in hex string
0x0Pattern: ^0x[0-9a-fA-F]+$Successful response
GET /api?module=proxy&action=eth_getBlockTransactionCountByNumber?tag=0x0 HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x53bdd401a871bd0f84e94619edcc0c24489d4aabPage number, default 1
1Example: 1Number of items per page, default 10
10Example: 10Successful response
GET /api?module=token&action=addresstokenbalance?address=0x53bdd401a871bd0f84e94619edcc0c24489d4aab HTTP/1.1
Host:
Accept: */*
Successful response
No content
Eth Address or Io Address
0x9756e951dd76e933e34434db4ed38964951e588bSuccessful response
GET /api?module=token&action=tokeninfo?contractaddress=0x9756e951dd76e933e34434db4ed38964951e588b HTTP/1.1
Host:
Accept: */*
Successful response
No content
Last updated

