Skip to content
Visit Covalent docs on GitHub
Set theme to dark (⇧+D)
Covalent docs

Ethereum network banner

X Network

Introduction

The X Network brings ...

Quick facts

PropertyValue
X Mainnet chainId137
X Testnet chainId80001
X Blockchain Explorerhttps://explorer-mainnet.maticvigil.com/
Block time~1 second

Quickstart overview video

Supported endpoints

  • api.covalenthq.com/v1/{chainId}/address/{address}/balances_v2/

    • Get token balances for address. Return a list of all ERC20 and NFT token balances including ERC721 and ERC1155 along with their current spot prices.
  • api.covalenthq.com/v1/{chainId}/address/{address}/transactions_v2/

    • Retrieve all transactions for address including their decoded log events. This endpoint does a deep-crawl of the blockchain to retrieve all kinds of transactions that references the address.
  • api.covalenthq.com/v1/{chainId}/address/{address}/transfers_v2/

    • Get ERC20 token transfers for address alongwith historical token prices.
  • api.covalenthq.com/v1/{chainId}/tokens/{contract_address}/token_holders/

    • Return a paginated list of token holders contract_address as of any historical block height.
  • api.covalenthq.com/v1/{chainId}/events/address/{contract_address}/

    • Return a paginated list of decoded log events emitted by a particular smart contract.
  • api.covalenthq.com/v1/{chainId}/events/topics/{topic}/

    • Return a paginated list of decoded log events with one or more topic hashes separated by a comma.
Go to Covalent's API Reference

Appendix

X Gas token

X token is the native token of the X network. This is similar to Ether in Ethereum. To interact with the X network, X tokens are required to pay as gas fees. Covalent's responses automatically returns gas_* fields in the MATIC units.

Token mapping

Covalent maintains an on-chain real-time mapping of token addresses between Ethereum mainnet and the X chain. These addresses are used to reverse-lookup prices on X and also to return the right token logo urls.

Some example of mapped tokens:

TokenEthereum mainnetX mainnet
USDT0xdac17f958d2ee523a2206206994597c13d831ec70xc2132d05d31c914a87c6611c10748aeb04b58e8f
Uniswap UNI0x1f9840a85d5af5bf1d1762f925bdaddc4201f9840xb33eaad8d922b1083446dc23f610c2567fb5180f

Token prices

For tokens that have a mapping back to Ethereum mainnet, Covalent is able to return the mapped prices.