# Network and RPC

*Endpoints, limits, and integration guidance*

Use this page to configure wallets and apps for Radius. It includes network values, RPC behavior, rate limits, and fee configuration patterns.

## Network configuration

### Radius Network

| Setting             | Value                                                                                                  |
| ------------------- | ------------------------------------------------------------------------------------------------------ |
| **Network name**    | Radius Network                                                                                         |
| **RPC endpoint**    | https\://rpc.radiustech.xyz                                                                            |
| **Chain ID**        | 723487                                                                                                 |
| **CAIP-2**          | eip155:723487                                                                                          |
| **Currency symbol** | RUSD                                                                                                   |
| **Explorer**        | https\://network.radiustech.xyz                                                                        |
| **Faucet (API)**    | [https://network.radiustech.xyz/api/v1/docs#faucet](https://network.radiustech.xyz/api/v1/docs#faucet) |

### Radius Testnet

| Setting                | Value                                                                                                  |
| ---------------------- | ------------------------------------------------------------------------------------------------------ |
| **Network name**       | Radius Testnet                                                                                         |
| **RPC endpoint**       | https\://rpc.testnet.radiustech.xyz                                                                    |
| **Chain ID**           | 72344                                                                                                  |
| **CAIP-2**             | eip155:72344                                                                                           |
| **Currency symbol**    | RUSD                                                                                                   |
| **Explorer**           | https\://testnet.radiustech.xyz                                                                        |
| **Faucet (Dashboard)** | [https://testnet.radiustech.xyz/wallet](https://testnet.radiustech.xyz/wallet)                         |
| **Faucet (API)**       | [https://testnet.radiustech.xyz/api/v1/docs#faucet](https://testnet.radiustech.xyz/api/v1/docs#faucet) |

## Add Radius to a wallet

### MetaMask

1. Open MetaMask and select **Add network**.
2. Enter the values from the table above.
3. Save and switch to the Radius network you configured.

### Programmatic setup (viem)

Use the Radius chain definition from [Tooling configuration — chain definition](/build/tooling.md#chain-definition). No fee overrides are needed — viem's built-in estimation works with Radius.

### Terminal and agent setup (radius-cli)

Use `radius-cli` for local wallet and agent execution. Set the network explicitly because the CLI defaults to mainnet:

```bash
RADIUS_HOME=.radius RADIUS_NETWORK=testnet RADIUS_RPC_URL={TESTNET_RPC_URL} \
  radius-cli wallet balance --json
```

For command examples, see [radius-cli](/reference/radius-cli.md).

## RPC endpoints and transport

* **HTTP RPC:** Use the endpoint values in the network tables.
* **WebSocket RPC:** Requires an RPC key with elevated privileges.

For WebSocket access requests, use the [Radius contact form](https://www.radiustech.xyz/contact).

## API keys and rate limiting

Radius tracks request volume per API key.

* Requests without an API key have lower limits.
* Default API key limit is **10 MGas/s**.
* For higher limits, use the [Radius contact form](https://www.radiustech.xyz/contact).

In this context, “MGas” includes both RPC calls and gas consumed by submitted transactions.

### Avoid throttling

1. Reuse API keys consistently per environment.
2. Add client-side retry with exponential backoff for `429`-style responses.
3. Cache frequent read requests where possible.
4. Batch reads with Multicall3 when practical.
5. Queue and smooth bursty traffic instead of sending spikes.

### RPC key URL format

Append your API key to the RPC URL path:

`https://rpc.radiustech.xyz/YOUR_API_KEY`

## JSON-RPC behavior to account for

Radius is EVM compatible, but some methods differ from Ethereum behavior:

* `eth_blockNumber` returns the current timestamp in milliseconds
* `eth_getBalance` returns native balance plus convertible SBC balance
* `eth_gasPrice` returns the fixed network gas price
* `eth_feeHistory` returns a pseudo-supported response

See [JSON-RPC API](/reference/json-rpc/methods.md) for method details and [Ethereum compatibility](/reference/ethereum-compatibility.md) for rationale.

## Get testnet funds

Use the [Radius testnet faucet](https://testnet.radiustech.xyz/wallet) (Dashboard) to claim SBC tokens with a point-and-click interface.

For programmatic and agent access, use [Create and Fund a Wallet](/build/wallet.md). The agentic faucet flow is available on testnet only — use the Dashboard or bridge stablecoins for mainnet.

## x402 facilitator endpoints

Use the Radius facilitator for [x402](/build/x402.md) payment settlement. Each network has a dedicated facilitator URL.

| Network                  | Facilitator URL                             | CAIP-2 identifier |
| ------------------------ | ------------------------------------------- | ----------------- |
| Radius Network (mainnet) | https\://facilitator.radiustech.xyz         | eip155:723487     |
| Radius Testnet           | https\://facilitator.testnet.radiustech.xyz | eip155:72344      |

For integration patterns, see [x402 payments](/build/x402.md). For the facilitator API reference, see [x402 facilitator API](/reference/facilitator-api.md).

## Related pages

* [JSON-RPC API](/reference/json-rpc/methods.md)
* [Fees](/reference/fees.md)
* [Contract addresses](/reference/contract-addresses.md)
* [Ethereum compatibility](/reference/ethereum-compatibility.md)