Docs: Docs HomeSupported NetworksUnified APICovalent NetworkIncrementAPI Reference

IoTeX Blockchain
Data Indexing API (suspended)

IoTeX Quick Facts

IoTeX is a blockchain-based platform, designed to become the decentralized backbone for Internet of Things applications. With an ever-growing ecosystem of projects and products from DeFi to Tools to Gaming, IoTeX currently leads the world’s premier industry consortiums and standards bodies such as IEEE, IIC, and more. With numerous contributions to the Blockchain and IoT space, the IoTeX blockchain already powers real devices, including Ucam, an award-winning blockchain-powered cameras presented at the Consumer Electronics Show (CES) and the Pebble geo device. Pebble is a secure device designed by IoTeX and perfect for supply chain optimization in any industry. As a next step, IoTeX is launching “MachineFi” , to power next-gen IoT applications.

Unified API Developer Docs

Tutorials, guides and references on the Unified API.

Unified API Reference

Complete reference documentation for the Unified API.

Developer SDK

Official open-source client libraries for your favorite platforms.

FAQ

These FAQs are a self-serve support resource for the Covalent API.

Base URL

The API Host for all requests is https://api.covalenthq.com/v1. Some additional points to keep in mind:

  • All requests are done over HTTPS (calls over plain HTTP will fail.)
  • The default return format for all endpoints is JSON unless the query parameter format=csv is specified.
  • All requests require authentication.

Authentication

To access the Covalent API, you will need an API key. Various authentication mechanisms are available:

Authentication via Query parameter

curl -X GET https://api.covalenthq.com/v1/ENDPOINT/?key=API_KEY

Append key=API_KEY as a query parameter to all requests.

Authentication via Basic Auth

 curl -X GET https://api.covalenthq.com/v1/ENDPOINT/ \
                -u API_KEY:
                -H 'Content-Type: application/json'
                # The colon prevents curl from asking for a password.

Provide your API key as the basic auth username. You do not need to provide a password.

Chain name
iotex-mainnet
Chain ID
4689
Network status SUSPENDED
Block explorer
Blocktime5 seconds
Historical balances❌
NFT assets and metadata❌
Query via SQL on Increment❌

Mainnet

Chain name
iotex-mainnet
Chain ID
4689
Network status SUSPENDED
Block explorer
Blocktime5 seconds
Historical balances❌
NFT assets and metadata❌
Query via SQL on Increment❌

IoTeX Testnet

Chain name
iotex-testnet
Chain ID
4690
Network status SUSPENDED
Block explorer
Blocktime5 seconds
Historical balances❌
NFT assets and metadata❌
Query via SQL on Increment❌

Don't Have an API Key?

Sign up to start building on IoTeX.

Unlock millions of requests and free archive data on all chains.

Network Status

Monthly Active Wallets
Unique wallets who transact on a monthly basis.		---
Transactions
Unique transactions on a monthly basis.		---
Active Tokens
Unique tokens active on a monthly basis.		---
Powered by Increment.

Monthly

Monthly Active Wallets
Unique wallets who transact on a monthly basis.		---
Transactions
Unique transactions on a monthly basis.		---
Active Tokens
Unique tokens active on a monthly basis.		---
Powered by Increment.

Weekly

Weekly Active Wallets
Unique wallets who transact on a weekly basis.		---
Transactions
Unique transactions on a weekly basis.		---
Active Tokens
Unique tokens active on a weekly basis.		---
Powered by Increment.

Daily

Daily Active Wallets
Unique wallets who transact on a daily basis.		---
Transactions
Unique transactions on a daily basis.		---
Active Tokens
Unique tokens active on a daily basis.		---
Powered by Increment.

Yearly

Yearly Active Wallets
Unique wallets who transact on a yearly basis.		---
Transactions
Unique transactions on a yearly basis.		---
Active Tokens
Unique tokens active on a yearly basis.		---
Powered by Increment.

Supported Endpoints

Endpoint

Code Samples

Get token balances for address

GET/v1/{chainName}/address/{walletAddress}/balances_v2/

Commonly used to fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.

Costs:

1.00 Credits

Processing:

Realtime
Show Guides
Installation
npm install @covalenthq/client-sdk
Request
import { CovalentClient } from "@covalenthq/client-sdk";

const ApiServices = async () => {
    const client = new CovalentClient("YOUR_API_KEY");
    const resp = await client.BalanceService.getTokenBalancesForWalletAddress();
    console.log(resp.data);
}
report

This network is suspended.

It's no longer supported by Covalent.