> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# HyperEVM Onchain Data API

> Get token balances and transactions for HyperEVM. 22 endpoints supported.

## Overview

> [!TIP]
>
> HyperEVM brings Solidity smart contracts to the Hyperliquid ecosystem. Deploy familiar EVM dApps on a blockchain built for institutional-grade trading performance.

GoldRush offers the most comprehensive HyperEVM Data API suite for developers, analysts, and enterprises. Whether you're
building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform,
our HyperEVM Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

### Supported APIs

> [card] [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api)
>
> Access structured historical blockchain data across 100+ chains using REST APIs.
> Get token balances, transaction histories, decoded event logs, NFT assets, token holders and more.\
> \\
>
> **Use cases: Wallets, portfolio trackers, crypto accounting & tax tools, and DeFi dashboards.**

> [card] [JSON-RPC](https://goldrush.dev/docs/goldrush-json-rpc/overview.md)
>
> Low-latency EVM JSON-RPC with global failover and archive depth.
> Point your existing tooling at the GoldRush endpoint — no code changes required.\
> \\
>
> **Use cases: dApps, wallets, indexers, bots, and trading infrastructure.**

## Mainnet

| Property | Value |
| - | - |
| **Chain Name** | `hyperevm-mainnet` |
| **Chain ID** | `999` |
| **Network Type** | Frontier Chain |
| **Support Level** | frontier |
| **Block Explorer** | [HyperEVM Explorer](https://hyperevmscan.io/) |
| **Official Website** | [HyperEVM Website](https://hyperfoundation.org/) |
| **Native Gas Token** | HYPE |

HyperEVM is the fully EVM-compatible execution layer of the Hyperliquid
network. It produces blocks roughly every **1 second**, uses
**HYPE** as its native gas token, and runs on chain ID
`999` - so standard Ethereum tooling (ethers, viem, web3.py,
Foundry) works without changes.

Connect over GoldRush JSON-RPC at
`https://rpc.goldrushdata.com/v1/hyperevm-mainnet` - see the
[HyperEVM JSON-RPC reference](https://goldrush.dev/docs/api-reference/json-rpc/chains/hyperevm.md)
for supported methods and code samples. For token balances, transfers,
and historical prices use the
[Foundational API](https://goldrush.dev/docs/goldrush-foundational-api).

## API Usage

To use this blockchain network in GoldRush API calls, use:

#### Chain Name

* `hyperevm-mainnet` (mainnet)

#### Example API Calls

```bash Chain Name (Mainnet) theme={null}
curl -X GET "https://api.covalenthq.com/v1/hyperevm-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"
```

#### SDK Usage

```typescript TypeScript SDK (Mainnet) theme={null}
import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "hyperevm-mainnet",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});
```

## Foundational API Support

This chain supports **22**  GoldRush Foundational APIs:

#### Wallet API

* **[ERC-20 Token Balance API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address.md)**
* **[Native Token Balance API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance.md)**
* **[Historical Portfolio Value API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time.md)**
* **[ERC-20 Token Transfers API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address.md)**

#### Pricing API

* **[Historical Token Price API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices.md)**

#### Security API

* **[Token Approvals API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address.md)**

#### Transactions API

* **[Transaction API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction.md)** `with-classification`
* **[Wallet Transaction Summary API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address.md)**
* **[Earliest Wallet Transactions API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3.md)** `with-classification`
* **[Wallet Transaction History API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3.md)** `with-classification`
* **[Paginated Wallet Transactions API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3.md)** `with-classification`
* **[Time Bucket Transactions API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3.md)**
* **[Block Transactions API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block.md)**
* **[Block Transactions API by Page on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page.md)**

#### Block Explorer API

* **[Block API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block.md)**
* **[Block Heights API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights.md)**
* **[Chain Status API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses.md)**
* **[Contract Event Logs API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address.md)**
* **[Event Logs API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs.md)**
* **[Event Logs by Topic Hash API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash.md)**
* **[Gas Price API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices.md)**
* **[Supported Chains API on HyperEVM](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains.md)**

## Transaction Classification (`with-classification`)

HyperEVM supports **transaction classification**. Pass `with-classification=true` to the Transactions API to get a type (such as `swap` or `send_token`), a category, a plain-English description, and the assets sent and received for each transaction.

> [!NOTE]
>
> Transaction classification costs `0.05` credits/item.

#### Example API Call

```bash Recent transactions with classification theme={null}
curl -X GET "https://api.covalenthq.com/v1/hyperevm-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions_v3/?with-classification=true&key=<GOLDRUSH_API_KEY>"
```

## JSON-RPC

HyperEVM is available on the GoldRush JSON-RPC service. Point your existing EVM tooling (ethers.js, viem, web3.js, or raw HTTP) at the GoldRush endpoint — the standard `eth_*`, `net_*`, `web3_*`, `debug_*`, and `trace_*` methods are supported.

#### Endpoint

```
https://rpc.goldrushdata.com/v1/hyperevm-mainnet
```

#### Example JSON-RPC Calls

```bash eth_blockNumber theme={null}
curl https://rpc.goldrushdata.com/v1/hyperevm-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
```

```bash eth_getBalance theme={null}
curl https://rpc.goldrushdata.com/v1/hyperevm-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","latest"]}'
```

#### Sample Methods

* **[eth\_blockNumber on HyperEVM](https://goldrush.dev/docs/api-reference/json-rpc/hyperevm/eth-blocknumber.md)**
* **[eth\_getBalance on HyperEVM](https://goldrush.dev/docs/api-reference/json-rpc/hyperevm/eth-getbalance.md)**
* **[eth\_call on HyperEVM](https://goldrush.dev/docs/api-reference/json-rpc/hyperevm/eth-call.md)**
* **[eth\_getLogs on HyperEVM](https://goldrush.dev/docs/api-reference/json-rpc/hyperevm/eth-getlogs.md)**
* **[eth\_getTransactionReceipt on HyperEVM](https://goldrush.dev/docs/api-reference/json-rpc/hyperevm/eth-gettransactionreceipt.md)**

See the [full method list and per-method examples for HyperEVM](https://goldrush.dev/docs/api-reference/json-rpc/chains/hyperevm.md).

## Additional Resources

* [GoldRush API Documentation](https://goldrush.dev/docs/)
* [Supported Chains List](https://goldrush.dev/chains/)
* [API Reference](https://goldrush.dev/docs/api-reference/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.