RPC Gateway quickstart

Create an App

Open Apps in the dashboard, create an App, and select the networks you need. The system creates an API Key and the corresponding Gateways.

Store the API Key in a secret manager or protected runtime environment. You can view it again, rotate it, or revoke it under App Settings → Access keys.

Copy the Access Point

Open the App Overview, select the target Gateway, and copy its complete Access Point. For server-side applications, use the Host-only Access Point with the API Key in the Authorization header:

export RPC_URL='https://ether-jsonrpc.<gateway-domain>'
export APP_API_KEY='<app_api_key>'

SDKs that accept a complete RPC URL can use the Access Point that carries the API Key in its first path segment:

https://ether-jsonrpc.<gateway-domain>/<app_api_key>

Make an Endpoint-free RPC read

This Ethereum Mainnet example uses the eligible eth_blockNumber method:

curl "$RPC_URL" \
  -H "Authorization: Bearer $APP_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

Example success response:

{"jsonrpc":"2.0","id":1,"result":"0x13a4f20"}

Use the exact method and parameter forms listed in Endpoint-free RPC.

Create an App with upstream access

Open Apps in the dashboard, create an App, and select the networks you need. Associate a Provider during creation to publish its matching synchronized Endpoints to the App’s default Gateway Routes.

You can also open Endpoints, add a manual upstream or synchronize a Provider, run its health check, then select the matching Endpoint in the Gateway’s default Route.

The App, Gateway, Endpoint, and Route use the same chain, network, and protocol. Choose priority failover for ordered primary and backup Endpoints, or weighted load balancing for equivalent upstreams.

Copy the Endpoint-backed Access Point

Open the App Overview, select the target Gateway, and copy its complete Access Point. Set the Host-only Access Point and API Key for a server-side application:

export RPC_URL='https://ether-jsonrpc.<gateway-domain>'
export APP_API_KEY='<app_api_key>'

Verify the network

Use the verification method from the target chain guide. This Ethereum Mainnet example calls eth_chainId through the configured Endpoint:

curl "$RPC_URL" \
  -H "Authorization: Bearer $APP_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":2,"method":"eth_chainId","params":[]}'

Ethereum Mainnet returns:

{"jsonrpc":"2.0","id":2,"result":"0x1"}