How to Add Custom RPC to Your OKX Wallet

·

Adding a custom RPC (Remote Procedure Call) to your OKX Wallet allows you to connect manually to blockchain networks that aren’t pre-configured in the wallet. This feature is especially valuable for developers, testers, and blockchain enthusiasts exploring emerging or niche EVM-compatible chains, private networks, or testnets not yet integrated by default.

Whether you're building decentralized applications, testing smart contracts, or interacting with a less common blockchain, custom RPC configuration gives you the flexibility to expand your wallet’s capabilities beyond mainstream networks like Ethereum or BNB Chain.

This guide walks you through how to add a custom RPC endpoint in both the OKX Web3 Wallet extension and the mobile app, while also covering best practices, common troubleshooting tips, and essential security considerations.

What Is an RPC and Why Use a Custom One?

RPC stands for Remote Procedure Call, a protocol that enables your wallet to communicate with a specific blockchain network. When you send a transaction or check your balance, your wallet uses an RPC URL to query data from that network’s nodes.

By default, OKX Wallet supports popular blockchains such as Ethereum, Polygon, Arbitrum, and others. However, many new or specialized chains—especially testnets or private EVM-based networks—aren’t included out of the box.

👉 Learn how to securely connect to any EVM-compatible blockchain in seconds.

That’s where custom RPC settings come in. They let you manually configure your wallet to interact with these unsupported networks by providing:

Once configured, you can seamlessly switch between networks directly within your OKX Wallet interface.

How to Add Custom RPC in the OKX Wallet Extension

Follow these steps to add a custom RPC network using the OKX Wallet browser extension:

  1. Open the OKX Wallet extension and log in to your account.
  2. Click on the network selector at the top of the interface (e.g., currently showing "Ethereum" or "BNB Chain").
  3. From the dropdown menu, select "Add network".

  4. Fill in the required network details:

    • Network name: Enter a recognizable name (e.g., “My Testnet” or “Custom Polygon Fork”).
    • New RPC URL: Input a valid HTTPS endpoint (e.g., https://my-custom-node.example.com).
    • Chain ID: Specify the unique numeric identifier for the network (e.g., 137 for Polygon Mainnet).
    • Currency symbol (optional): Set the native token symbol (e.g., MATIC, ETH).
    • Block explorer URL (optional): Add a transaction explorer link (e.g., https://my-explorer.example.com).
  5. Click "Save" or "Add" to confirm.

Your newly added network will now appear in the network list and can be selected whenever you need to interact with it.

How to Add Custom RPC in the OKX Mobile App

The process on mobile is similarly straightforward:

  1. Launch the OKX Web3 Wallet app.
  2. Tap the network dropdown at the top of the screen.
  3. Select "Custom" or "Add network", depending on your version.

  4. Enter the same configuration details as above:

    • Network name
    • RPC URL
    • Chain ID
    • Token symbol (optional)
    • Block explorer URL (optional)
  5. Tap "Confirm" or "Save".

You’ll now be able to use this network for transactions, dApp interactions, and token management within the app.

Key Considerations When Adding Custom RPCs

While adding a custom RPC is simple, incorrect settings or untrusted endpoints can lead to issues ranging from failed transactions to potential security risks.

🔐 Security Best Practices

🛠️ Editing or Removing Custom Networks

You can modify or delete custom networks at any time:

This flexibility ensures you can keep your environment clean and up-to-date.

Frequently Asked Questions (FAQ)

What is a Chain ID?

The Chain ID is a unique number used to distinguish one blockchain from another. It prevents cross-chain replay attacks and ensures transactions are broadcast on the correct network. For example:

Using the wrong Chain ID may cause transactions to fail or be rejected by nodes.

Can I use HTTP instead of HTTPS for RPC URLs?

No. OKX Wallet requires all custom RPC endpoints to use HTTPS for security reasons. HTTP connections are blocked to protect user data and prevent man-in-the-middle attacks.

Why can't I see my tokens after adding a custom network?

Tokens must be manually added if they’re not automatically detected. After switching to your custom network:

  1. Tap “Add Token” in your wallet.
  2. Enter the token contract address.
  3. Confirm symbol and decimals.
  4. Save.

Ensure the contract address matches the one deployed on that specific chain.

👉 Connect safely to any blockchain with confidence—set up your custom RPC now.

Will adding a custom RPC affect my existing assets?

No. Your funds on other networks remain completely unaffected. The custom RPC only changes which blockchain your wallet interacts with—it doesn’t move or alter your assets.

How do I find reliable RPC endpoints?

Check the official website or GitHub repository of the blockchain you’re trying to connect to. Many projects provide public RPCs or partner with node service providers. Alternatively, you can run your own node for full control and privacy.

Can I add non-EVM blockchains via custom RPC?

No. Custom RPC settings in OKX Wallet only support EVM-compatible chains (e.g., Ethereum Virtual Machine-based networks). Non-EVM blockchains like Solana, Bitcoin, or Cosmos require entirely different protocols and wallet integrations.

Final Thoughts

Custom RPC configuration unlocks powerful possibilities for advanced users and developers working across diverse blockchain environments. Whether you're testing on a local fork, deploying on a new L2, or exploring an emerging ecosystem, OKX Wallet makes it easy to stay connected without relying solely on pre-approved networks.

Just remember: accuracy matters. Always verify Chain IDs, use secure HTTPS endpoints, and double-check network details before saving.

With just a few clicks, you can extend your wallet’s reach across the broader Web3 landscape—securely and efficiently.

👉 Get started with full control over your Web3 connections today.

By mastering custom RPC setup, you take a significant step toward becoming a more autonomous and capable participant in decentralized ecosystems. Stay curious, stay safe, and keep building.