eth_getBalance | Hyperliquid EVM

Returns the balance of an account at a given block number.

POST /evm

eth_getBalance

cURL

curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0xFC1286EeddF81d6955eDAd5C8D99B8Aa32F3D2AA",
    "latest"
  ],
  "id": 1
}
'

200

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

This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see Hyperliquid methods for the full availability breakdown.

The eth_getBalance JSON-RPC method returns the balance of an account at a given block number. This method is fundamental for checking account balances and is essential for wallet applications, portfolio tracking, and balance verification.

Get your own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

The method takes two parameters:

1. Address - The account address to check the balance for
2. Block parameter - The block at which to check the balance

Parameter details

• address (string, required) — The 20-byte account address to check the balance for
• block (string, required) — Block identifier: "latest" (only the latest block is supported on Hyperliquid)

Response

The method returns the account balance in wei as a hexadecimal string.

Response structure

Account balance:

• result — The account balance in wei as a hexadecimal string

Data interpretation

Balance format:

• Returned as hexadecimal string with 0x prefix
• Value represents wei (smallest unit of HYPE)
• Convert to HYPE by dividing by 10^18
• Convert to gwei by dividing by 10^9

Unit conversions:

• 1 HYPE = 10^18 wei
• 1 gwei = 10^9 wei
• Example: 0xde0b6b3a7640000 = 1,000,000,000,000,000,000 wei = 1 HYPE

Hyperliquid-specific considerations

Block limitations

Latest block only:

• Only the "latest" block parameter is supported
• Historical balance queries are not available in the default implementation
• All balance checks return the current state
• For historical data, consider using archive node implementations

Balance monitoring

Real-time tracking:

• Check balances at regular intervals for portfolio tracking
• Monitor balance changes for transaction confirmation
• Set up alerts for significant balance changes
• Use current balance for all transaction validations

Example request

Shell

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xFC1286EeddF81d6955eDAd5C8D99B8Aa32F3D2AA","latest"],"id":1}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm

Use cases

The eth_getBalance method is essential for applications that need to:

• Wallet applications: Display current account balances to users
• Portfolio tracking: Monitor balances across multiple accounts
• Transaction validation: Verify sufficient balance before transactions
• DeFi protocols: Check user balances for protocol interactions
• Analytics platforms: Track account balance changes over time
• Audit systems: Generate balance reports for compliance
• Trading platforms: Verify account balances for trading operations
• Payment systems: Check sender balances before processing payments
• Gaming applications: Monitor in-game currency balances
• Staking platforms: Verify balances for staking operations
• Lending protocols: Check collateral balances and ratios
• Insurance platforms: Monitor account balances for coverage
• Cross-chain bridges: Verify balances before bridge operations
• Governance systems: Check voting power based on token balances
• NFT marketplaces: Verify buyer balances for purchases
• Subscription services: Monitor account balances for recurring payments
• Risk management: Track account balances for liquidation monitoring
• Compliance tools: Generate balance reports for regulatory requirements
• Educational platforms: Demonstrate balance concepts and calculations
• Research tools: Analyze account balance distributions and patterns
• Monitoring systems: Alert on significant balance changes
• Integration services: Provide balance data to external systems
• Development tools: Test applications with various balance scenarios
• User experience: Provide real-time balance feedback
• Security systems: Monitor for unusual balance changes or activities

This method provides fundamental account balance information, enabling comprehensive account management and financial tracking on the Hyperliquid EVM platform.

On Hyperliquid, eth_getBalance only supports the latest block. Historical balance queries are not supported in the default RPC implementation. All balance queries return the current account state.

Body

application/json

jsonrpc · enum<string> · default: 2.0 · required

JSON-RPC version

Available options: 2.0

method · enum<string> · default: eth_getBalance · required

The RPC method name

Available options: eth_getBalance

params · array · required

Parameters: [address, block]

id · integer · default: 1 · required

Request identifier

Response

200 - application/json

Successful response with the account balance

jsonrpc · string

JSON-RPC version

id · integer

Request identifier

result · string

The account balance in wei as a hexadecimal string