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/....
Which networks can I reach with the API?
Section titled “Which networks can I reach with the API?”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 Type | Blockchain | Network | X-Network Header Value |
|---|---|---|---|
| Mainnet | Ethereum | mainnet | mainnet |
| Testnet | Ethereum | sepolia | testnet |
| Mainnet | Tron | mainnet | mainnet |
| Testnet | Tron | nile | testnet |
| Mainnet | Binance Smart Chain | mainnet | mainnet |
| Testnet | Binance Smart Chain | testnet | testnet |
| Mainnet | Bitcoin | mainnet | mainnet |
| Testnet | Bitcoin | testnet3 | testnet |
| Mainnet | Polygon | mainnet | mainnet |
| Testnet | Polygon | amoy | testnet |
| Mainnet | Arbitrum | mainnet | mainnet |
| Testnet | Arbitrum | arbitrum sepolia | testnet |
| Mainnet | Solana | mainnet | mainnet |
| Testnet | Solana | devnet | testnet |
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.
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.
What differs between the chains?
Section titled “What differs between the chains?”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.
| Blockchain | Native coin in the API | Token standards | Webhooks | Notes |
|---|---|---|---|---|
| Ethereum | ETH | ERC20, ERC721 | yes | gasprice and NFT owner and URI lookups |
| Binance Smart Chain | BNB | BEP20, BEP721 | yes | same endpoint set as Ethereum, under /bsc |
| Polygon | MATIC | ERC20, ERC721 | yes | same endpoint set as Ethereum, under /polygon |
| Arbitrum | ETH | ERC20, ERC721 | yes | same endpoint set as Ethereum, under /arbitrum |
| Tron | TRX | TRC10, TRC20, TRC721 | yes | staking, resource delegation, build and broadcast for self-signed transactions |
| Bitcoin | BTC | none | yes | wallets contain addresses, a transaction names the wallet and a speed of fast, medium or slow |
| Solana | SOL | SPL | no | the 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.
How do addresses look on each chain?
Section titled “How do addresses look on each chain?”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.
| Blockchain | Address format |
|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | 0x followed by 40 hexadecimal characters |
| Tron | T followed by 33 alphanumeric characters |
| Bitcoin | starts with bc1, tb1, 1 or 3, then 25 to 39 characters |
| Solana | 32 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.
- Ethereum: networks overview with testnets and faucets.
- TRON: network documentation for mainnet and the Nile testnet.
- BNB Smart Chain: developer documentation and the JSON-RPC endpoint list.
- Polygon: RPC endpoint reference for Amoy.
- Arbitrum: chain information for Arbitrum One and Arbitrum Sepolia.
- Bitcoin: testing guide for testnet and regtest.
- Solana: clusters documentation for devnet.
Where can I read more?
Section titled “Where can I read more?”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.