Unified REST APIAccount

Get Balance

Get account balance information.

Multi-account support: Use accountId to query a specific account's balance. If not specified, defaults to the primary account.

GET
/getBalance

Authorization

ApiKeyAuth
X-API-KEY<token>

In: header

Query Parameters

assets?string

Filter to specific assets (comma-separated)

accountId?string

Account identifier for multi-account support. If not specified, uses the default account.

marketType?enum<string>

Optional market type filter. Use "spot" for spot markets or "perp" for perpetual/futures markets.

Available options: spotperp

Response Body

application/json

curl -X GET "https://api.hypereth.io/v2/hyperliquid/getBalance?assets=USDT%2CUSDC&accountId=acc_A"
{
  "balances": [
    {
      "asset": "USDT",
      "marketType": "future",
      "walletBalance": "10000.0",
      "availableBalance": "9800.0",
      "crossUnrealizedPnl": "200.0",
      "marginType": "cross",
      "dexProcessedTimestamp": 1710000000800
    }
  ],
  "dataTime": 1710000000000,
  "dexReceivedTimestamp": 1710000000900,
  "hyperethTimestamp": 1710000001000
}

Get All Balances (Cross-DEX) GET

Get balances aggregated across all supported DEXes (Hyperliquid, Aster, Lighter). **Note**: This endpoint uses the `/v2/all` base URL instead of a platform-specific URL. **Endpoint**: `GET https://api.hypereth.io/v2/all/balances`

Get Accounts GET

Get all accounts associated with the API key. **Platform Support**: Available on all supported platforms. This endpoint returns a list of all accounts registered under the current API key, including the default account and any additional accounts configured via `strategy_signers`.