Hyperliquid Academy Independent · Unofficial

How do I add HyperEVM to MetaMask?

Verified against Hyperliquid docs: HyperEVM (for developers) and Hyperliquid docs: HyperEVM · by Hyperliquid Academy

The parameters

Read from Hyperliquid’s developer documentation on the date at the top of this page. Check them there rather than trusting any guide, including this one — a wrong chain ID is the kind of mistake that is tedious at best and expensive at worst.

FieldMainnetTestnet
Chain ID999998
JSON-RPC endpointhttps://rpc.hyperliquid.xyz/evmhttps://rpc.hyperliquid-testnet.xyz/evm
Currency symbolHYPEHYPE
Decimals1818

The docs do not publish a canonical block explorer URL, so this page does not name one. Several community explorers exist; pick one from the ecosystem pages rather than from a search result, because explorer lookalikes are a known phishing route.

Step-by-step

  1. Open the custom network form

    In MetaMask: Settings → Networks → Add network → Add a network manually. The browser extension and the mobile app both have it, though the wording moves around between versions.

    Some wallets offer a one-click “add network” button on third-party sites. Those usually work, and they are also exactly what a phishing site imitates. Typing four fields takes a minute and removes the question.

    You should see an empty network form, not a search box

  2. Enter the four values

    Chain ID 999, RPC https://rpc.hyperliquid.xyz/evm, currency symbol HYPE, and a network name of your choosing — the name is yours alone and has no effect on anything.

    MetaMask checks the chain ID against the RPC and refuses to save if they disagree, which is a useful safety net: if it complains, you have mistyped one of the two rather than found a bug.

    You should see the network saved, with HYPE showing as the currency

  3. Get HYPE onto the EVM side

    This is the step people miss, and it is why a correctly added network looks broken.

    Gas on HyperEVM is paid in HYPE. USDC in your Perps or Spot balance cannot pay it, because those live on HyperCore, the other half of the chain. Until HYPE arrives on the EVM side, every transaction fails for insufficient funds while your HyperCore balance sits there looking healthy.

    You should see a non-zero HYPE balance, and transactions that actually send

Verify the chain ID at the source, every time

There is a whole genre of phishing that works by publishing a plausible network configuration. The RPC collects what your wallet tells it, and a network that looks right can route you somewhere that is not.

The only parameters worth trusting are the ones in Hyperliquid’s own documentation, linked in Sources below. That applies to this page as much as to any other — we read them on the date stamped above, and they can change.

Why HyperCore and HyperEVM have separate balances

The two halves run on one chain and share a validator set, but they are different execution environments with different state. An order book needs determinism and speed; general-purpose smart contracts need an EVM. Hyperliquid runs both rather than compromising on either.

For you that means one practical rule: a balance is on one side or the other, never both. Transferring between them is a deliberate action, not something a wallet does on your behalf. The full comparison covers what lives where.

What you would actually use it for

Nothing in ordinary trading. Perpetuals and spot are HyperCore, they need no network added, and they charge no gas.

HyperEVM matters if you want the DeFi ecosystem built alongside the exchange — lending markets, liquid staking, structured products. What is actually available there, and the honest version of what it pays.

Common mistakes

Adding the network and expecting to see your trading balance. Different side of the chain. Nothing has gone wrong.

Trying to pay gas with USDC. Gas is HYPE. There is no setting that changes this.

Taking network parameters from a forum post. Sometimes fine, occasionally a trap, and never necessary when the docs publish them.

Using testnet values on mainnet. 998 and 999 differ by one digit and the endpoints differ by one word. Read both twice.

Frequently asked questions

What is the HyperEVM chain ID?

999 on mainnet and 998 on testnet, as published in Hyperliquid's developer documentation. If a guide gives you a different number, check it against the docs before adding the network — a wrong chain ID is how people send funds somewhere they cannot reach.

Which RPC endpoint should I use?

https://rpc.hyperliquid.xyz/evm for mainnet and https://rpc.hyperliquid-testnet.xyz/evm for testnet. Both come straight from the developer docs. Third-party RPC providers exist and are a reasonable choice for an application, but there is no reason to prefer one for a wallet.

What is the gas token?

HYPE, with 18 decimals. That is the thing people get wrong: USDC sitting in your perps or spot balance on HyperCore cannot pay gas, so a freshly added network looks broken until HYPE arrives on the EVM side.

Do I need HyperEVM at all?

Only if you want to use applications built on it — lending, liquid staking, anything in the DeFi ecosystem. Trading perpetuals and spot on Hyperliquid itself happens on HyperCore and needs no network added and no gas.

Why is my balance not showing after adding the network?

Almost always because nothing has moved across yet. HyperCore and HyperEVM are two halves of the same chain with separate balances, so adding the network to a wallet does not by itself bring anything into view.

Sources

We link the primary source for every number on this page. If a figure here disagrees with the Hyperliquid documentation, the documentation is right and we want to know.

Keep going