BNB Smart Chain
The BNB Smart Chain Gateway provides EVM JSON-RPC. Its gas token is BNB.
Supported networks
| Network | Chain ID | JSON-RPC Host |
|---|---|---|
| Mainnet | 56 | bnb-jsonrpc |
| Testnet | 97 | bnb-testnet-jsonrpc |
Copy the complete Access Point from the dashboard instead of constructing a domain from the Host.
Endpoint-free calls
On an Accelerator hit, you can call eth_blockNumber, eth_getBlockByNumber([hexHeight, false]), and debug_traceBlockByNumber([hexHeight, {"tracer":"callTracer"}]) without an Endpoint. See Accelerator for exact parameters and miss behavior.
Configure complete method access
- Create a Gateway for the target BNB Smart Chain network.
- Use Provider sync or manually add an EVM Endpoint on the same network.
- Add the Endpoint to the default JSON-RPC route and complete its health check.
- Call
eth_chainIdto verify the network.
curl '<bsc_access_point>' \
-H 'Authorization: Bearer <app_api_key>' \
-H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'Mainnet should return 0x38; Testnet should return 0x61.
eth_chainId is not an Accelerator method, so this verification requires a usable Endpoint.
Current limits
- Single EVM JSON-RPC calls over HTTP are supported; batch, WebSocket, and public gRPC are not.
- BNB Smart Chain-specific REST endpoints are not exposed.
debug,trace, archive, and vendor extension methods depend on the upstream Endpoint.- Mainnet and Testnet use independent routes and never fail over across networks.
See JSON-RPC and Errors and troubleshooting for shared behavior.
Last updated on