> For the complete documentation index, see [llms.txt](https://docs.luganodes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luganodes.com/apis/staking-apis-v2/hyperliquid/balance.md).

# Balance

#### 5. Get Hyperliquid staking information for delegator

**GET** `/hyperliquid/staking/balance`

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

**Query Parameters**

* `delegatorAddress` (string, required): Delegator Hyperliquid address

**Response**

```json
{
  "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**

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

***