Skip to main content

Network RPC Endpoints

Public RPC Endpoints

Confura, a public RPC service offered by the Conflux Foundation, is available for free use. However, to maintain the service's usability, there are rate limits in place for the free tier. For access to a higher tier of RPC service, you can make a purchase through the Web3 Paywall, or you can apply directly to the Conflux Foundation by emailing bd@confluxnetwork.org.

Hong Kong

NetworkChain IDRPC Endpoint URLExplorer
Mainnet1030 (0x406)HTTP: https://evm.confluxrpc.com
Websocket: wss://evm.confluxrpc.com/ws
https://evm.confluxscan.net
Testnet71 (0x47)HTTP: https://evmtestnet.confluxrpc.com
Websocket: wss://evmtestnet.confluxrpc.com/ws
https://evmtestnet.confluxscan.net

US East

NetworkChain IDRPC Endpoint URLExplorer
Mainnet1030 (0x406)HTTP: https://evm.confluxrpc.org
Websocket: wss://evm.confluxrpc.org/ws
https://evm.confluxscan.io
Testnet71 (0x47)https://evmtestnet.confluxrpc.org
Websocket: wss://evmtestnet.confluxrpc.org/ws
https://evmtestnet.confluxscan.io

Rate Limits

Reference for various fee tiers and their rate limits.

Fee TierPriceRate LimitsBuy Links
Free$050 calls/second, up to 100,000 calls/day-
Standard$150/mo100 calls/second, up to 1,000,000 calls/daymainnet
testnet
Enterpriseplease inquire bd@confluxnetwork.orgcustomize on demand-

Notes

  • Maximum result-set size is 10,000 for getLogs call;
  • Old archived event logs may be inaccessible due to data prune;
  • Append your api key(get from Web3 Paywall or Conflux Foundation) to the endpoint for privileged access (eg., https://evm.confluxrpc.com/<mainnet-api-key> or for testnet, https://evmtestnet.confluxrpc.org/<testnet-api-key>);
  • Rate limits are also imposed per RPC method, please check the following specification for more details.
Rate Limit Specification
RPC MethodFree tierStandard TierComment
allQPS < 50;
daily total < 100k
QPS < 100;
daily total < 1million
overall RPC requests
eth_getLogsQPS < 5QPS < 20-
eth_callQPS < 5QPS < 50-
eth_getBlockBy*QPS < 5QPS < 20includes:
eth_getBlockByHash,
eth_getBlockByNumber
eth_getTransaction*QPS < 5QPS < 20includes:
eth_getTransactionByHash,
eth_getTransactionReceipt
debug RPCnot supportedQPS < 20includes:
parity_getBlockReceipts etc.
trace RPCnot supportedQPS < 20includes:
trace_block, trace_filter, trace_transaction
filter APInot supportedsupportedincludes:
eth_newFilter, eth_getFilterChanges etc.
Confura Common Errors

The Confura service have some proprietary errors, these errors are not part of the Conflux-rust client RPC implementation.

common error response format:

{
"id": 123,
"jsonrpc": "2.0",
"error": {
"code": -32000,
"message": "daily request limit exceeded: Too many requests (exceeds 100000)"
}
}

Rate Limit related errors:

messagenote
daily request limit exceeded: Too many requests (exceeds 100000)
access forbidden by allowlistsThe requested method is only available in the VIP service.
allowed qps exceeded: Too many requests, exceeds 50 at a time

Encountering such errors, please purchase a higher-tier service through the web3 paywall.

getLogs related errors:

messagenote
event logs are too stale (already pruned)
Filter must provide one of the following: (1) an epoch range through fromEpoch and toEpoch, (2) a block number range through fromBlock and toBlock, (3) a set of block hashes through blockHashes
invalid block range (from block larger than to block)
Filter must provide one of the following: (1) a block number range through fromBlock and toBlock, (2) a set of block hashes through blockHash
filter.block_hashes can contain up to 32 hashes; xxx were provided.
filter.address can contain up to 32 addresses; xxx were provided.
filter.topics must be no more than 4-dimensional array; xxx were provided.
filter.topics can contain up to 32 topics per dimension; xxx were provided.
query set is too large, please narrow down your filter condition
result set to be queried is too large with more than 10000 logs, please narrow down your filter condition
filter not found

service errors:

messagenote
no full node available
subscription proxy error
query timeout with duration exceeds 3s
server is too busy, please try again later
RPC middleware crashed

This type of error indicates an issue with the Confura service. Please try again later or contact the service provider.

Commercial RPC Service

There are couple of commercial RPC service providers, you can check them here

FAQs

How to get a Confura advanced API key?

Confura is a public RPC service provided by Conflux Foundation, it is free to use. For using the free tier, you don't need an API key. To get a higher tier RPC service, you can buy it at Web3 Paywall or apply from Conflux foundation by sending email to bd@confluxnetwork.org.