Skip to content

Supported Networks and Testnets

Chaingateway supports seven blockchains: Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum and Solana. Each one has a mainnet and a testnet. You choose the network per request with the X-Network header, which takes the value mainnet or testnet, and the path segment selects the chain, for example /api/v2/tron/....

Network selection: the path segment chooses the chain, the X-Network header chooses mainnet or testnet Request to /api/v2/{chain}/... chain: ethereum, tron, bsc, bitcoin, polygon,arbitrum or solana X-Network header testnet, or mainnet (the default if the headeris missing) Network answers e.g. Ethereum Sepolia or Ethereum mainnet
Two inputs select the network: the path and the header.

All requests go to https://app.chaingateway.io/api/v2/{chain}/.... The table lists the network behind each combination of chain and X-Network value.

Network TypeBlockchainNetworkX-Network Header Value
MainnetEthereummainnetmainnet
TestnetEthereumsepoliatestnet
MainnetTronmainnetmainnet
TestnetTronniletestnet
MainnetBinance Smart Chainmainnetmainnet
TestnetBinance Smart Chaintestnettestnet
MainnetBitcoinmainnetmainnet
TestnetBitcointestnet3testnet
MainnetPolygonmainnetmainnet
TestnetPolygonamoytestnet
MainnetArbitrummainnetmainnet
TestnetArbitrumarbitrum sepoliatestnet
MainnetSolanamainnetmainnet
TestnetSolanadevnettestnet

How do I switch between mainnet and testnet?

Section titled “How do I switch between mainnet and testnet?”

Add the header X-Network: testnet to run a request on the test network. Remove the header, or send mainnet, to use the main network. The OpenAPI file defines the header as optional with the default mainnet, so a request without it runs on the main network. The next call reads the latest block of Ethereum Sepolia.

Terminal window
curl --request GET \
--url https://app.chaingateway.io/api/v2/ethereum/blocks/number \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'X-Network: testnet'

Lists of webhook notifications are scoped to one blockchain and one network, so send the same X-Network value when you read them as when you created the webhook. Keep one API token for both networks and set the header in the client configuration, so a test environment cannot reach mainnet by accident.

The endpoint families are similar, but each chain has its own transaction model, so some parameters differ. The table summarizes what the OpenAPI file defines for each chain.

BlockchainNative coin in the APIToken standardsWebhooksNotes
EthereumETHERC20, ERC721yesgasprice and NFT owner and URI lookups
Binance Smart ChainBNBBEP20, BEP721yessame endpoint set as Ethereum, under /bsc
PolygonMATICERC20, ERC721yessame endpoint set as Ethereum, under /polygon
ArbitrumETHERC20, ERC721yessame endpoint set as Ethereum, under /arbitrum
TronTRXTRC10, TRC20, TRC721yesstaking, resource delegation, build and broadcast for self-signed transactions
BitcoinBTCnoneyeswallets contain addresses, a transaction names the wallet and a speed of fast, medium or slow
SolanaSOLSPLnothe private key goes into every transaction request

Solana has no webhook endpoints. To detect a deposit on Solana, poll the balance or list transactions. On the EVM chains and on Tron you can create a webhook instead.

The API validates the format of every address before it processes a request, and it answers with status 422 and the field name in errors when a format is wrong. The formats below are the patterns that the OpenAPI file defines.

BlockchainAddress format
Ethereum, BNB Smart Chain, Polygon, Arbitrum0x followed by 40 hexadecimal characters
TronT followed by 33 alphanumeric characters
Bitcoinstarts with bc1, tb1, 1 or 3, then 25 to 39 characters
Solana32 to 44 base58 characters

How can I check that a network is reachable?

Section titled “How can I check that a network is reachable?”

Call GET /api/v2/{chain}/blocks/number for the chain and network you want to test. The endpoint exists for all seven chains and returns the latest block number. A response with ok: true shows that your token, the path and the X-Network header are correct. A 401 response with Unauthenticated. points to the token, and a 404 points to a wrong path. Run the call once for mainnet and once with X-Network: testnet after you change the configuration.

Where do I get testnet coins and explorers?

Section titled “Where do I get testnet coins and explorers?”

Testnet coins come from faucets operated by the chain communities, not by Chaingateway. Each chain’s developer documentation lists current faucets, explorers and network parameters. Check those pages before you test, because testnets are reset or replaced from time to time.

The Quickstart shows a complete first request. The API reference lists every endpoint per chain, and Wallet Management explains how addresses and keys are handled on each network.