Network RPC Endpoints

Public available Conflux Core Space network RPC endpoints

tip

Public RPC endpoints for Conflux eSpace is provided here.

1. Confura

Confura is an Ethereum Infura equivalent public JSON-RPC service on Conflux network, which is developed and maintained by Conflux foundation and is available for free use.

Public Endpoint

Confura provides several available RPC endpoints for the mainnet and testnet. We have sorted them by selected priority and provided brief descriptions. If you are unsure which one to choose, please select an RPC endpoint near the top of the list.

Mainnet

Chain ID for Conflux Core Space Mainnet is 1029(0x405). The corresponding blockchain explorer URL is https://confluxscan.io.

RPC Endpoint	Type	Notes
https://main.confluxrpc.com	HTTP
https://cfxmain-china.confluxrpc.com	HTTP	RPC Service for China Users
https://cfxmain-global.confluxrpc.com	HTTP	RPC Service for Global Users
https://main.confluxrpc.org	HTTP	Backup RPC Service
wss://main.confluxrpc.com/ws	Websocket
wss://main.confluxrpc.org/ws	Websocket	Backup RPC Service

Testnet

Chain ID for Conflux Core Space Testnet is 1(0x1). The corresponding blockchain explorer URL is https://testnet.confluxscan.io.

RPC Endpoint	Type	Notes
https://test.confluxrpc.com	HTTP
https://cfxtest.confluxrpc.com	HTTP
https://test.confluxrpc.org	HTTP	Backup RPC Service
wss://test.confluxrpc.com/ws	Websocket
wss://test.confluxrpc.org/ws	Websocket

Rate Limits

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.

Here are references for various fee tiers and their rate limits.

Fee Tier	Price	Rate Limits	Buy Links
Free	$0	50 calls/second, up to 100,000 calls/day	-
Standard	$150/mo	100 calls/second, up to 1,000,000 calls/day	mainnet testnet
Enterprise	please inquire bd@confluxnetwork.org	customize 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 to the endpoint for privileged access (eg., https://main.confluxrpc.com/<api-key>);
• Rate limits are also imposed per RPC method, please check the following specification for more details.

Rate Limit Specification

RPC Method	Free tier	Standard Tier	Comment
all	QPS < 50; daily total < 100k	QPS < 100; daily total < 1million	overall RPC requests
cfx_getLogs	QPS < 5	QPS < 20	-
cfx_call	QPS < 5	QPS < 50	-
cfx_getBlockBy*	QPS < 5	QPS < 20	includes: cfx_getBlockByHash, cfx_getBlockByEpochNumber
cfx_getTransaction*	QPS < 5	QPS < 20	includes: cfx_getTransactionByHash, cfx_getTransactionReceipt
debug RPC	not supported	QPS < 20	includes: cfx_getEpochReceipts etc.
trace RPC	not supported	QPS < 20	includes: trace_block, trace_filter, trace_transaction
filter API	not supported	supported	includes: cfx_newFilter, cfx_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:

message	note
daily request limit exceeded: Too many requests (exceeds 100000)
access forbidden by allowlists	The 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:

message	note
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 epoch larger than to epoch)
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:

message	note
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.

2. Unifra

Unifra is a Web3 developer platform focused on simplifying blockchain development. It has built a suite of developer tools, enhanced APIs, and a superior node infrastructure to seamlessly build and run blockchain applications. Unifra provide API services for multiple chains including Ethereum, BNB Smart Chain, Polygon and Conflux.

Unifra provides:

• Open access to free public end-points
• Real-time webhook alerts via Notify
• Best-in-class support and reliability / stability
• Unifra's NFT API
• Dashboard with Request Explorer

To use Unifra's service, developer need to register an account first and find the RPC endpoint in Unifra console. For detail infomation check Unifra's documentation

Public Endpoint

Network	Chain ID	Explorer	Endpoint
Mainnet	1029	https://confluxscan.net	https://conflux-core-public.unifra.io