Balance

5. Get Hyperliquid staking information for delegator

GET /api/v1/staking/balance

Returns the current balance and staking status of a delegator address.

Query Parameters

• delegatorAddress (string, required): Delegator Hyperliquid address

Response

{
  "result": {
    "delegatorAddress": "0xB8125fe3317584d9687B55786836a2D44e48E585",
    "spotBalance": 7.554708,
    "stakingBalance": 0.0,
    "delegatedBalance": 1.5,
    "pendingWithdrawal": 0.0,
    "delegations": [
      {
        "validator": "0x48f1da3e3ec2814fbb3dcf57125001089b067402",
        "amount": 1.5,
        "lockedUntil": 1640995200000,
        "status": "Active"
      }
    ],
    "createdAt": "2025-01-21T12:00:00Z"
  }
}

Response Fields Explained

Balance Fields:

• spotBalance: HYPE tokens in spot account (available for trading/transfer to staking)

• stakingBalance: HYPE tokens in staking account (available for delegation)

• delegatedBalance: Total HYPE tokens currently delegated to validators

• pendingWithdrawal: HYPE tokens in 7-day unbonding period (withdrawing from staking to spot)

Delegation Details:

• validator: Address of the Luganodes validator receiving delegation

• amount: HYPE tokens delegated to Luganodes validator

• lockedUntil: Unix timestamp when delegation can be undelegated (1-day lockup)

• status: Current status (Active, Undelegating, Locked)

cURL Example

curl --location '{{url}}/api/v1/staking/balance?delegatorAddress=0xB8125fe3317584d9687B55786836a2D44e48E585' \
--header 'api-key: your-api-key'

---