POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (delegations)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "delegations",
  "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"
}'
{
  "userAddress": "<string>",
  "totalDelegated": "<string>",
  "activeDelegations": [
    {
      "validatorAddress": "<string>",
      "validatorName": "<string>",
      "delegatedAmount": "<string>",
      "delegationTime": 123,
      "rewards": {
        "accumulatedRewards": "<string>",
        "pendingRewards": "<string>",
        "lastRewardClaim": 123
      },
      "commissionRate": "<string>",
      "isActive": true
    }
  ],
  "pendingUndelegations": [
    {
      "validatorAddress": "<string>",
      "undelegationAmount": "<string>",
      "initiationTime": 123,
      "completionTime": 123,
      "timeRemaining": 123
    }
  ],
  "totalRewards": "<string>",
  "claimableRewards": "<string>",
  "delegationStats": {
    "averageCommissionRate": "<string>",
    "totalValidators": 123,
    "oldestDelegation": 123
  }
}
The info endpoint with type: "delegations" retrieves a user’s active delegations on the Hyperliquid network. This endpoint provides a simple list of current delegations showing the validator address, delegated amount, and lock expiration timestamp for each delegation.
Get your own node endpoint todayStart 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

Request body

  • type (string, required) — The request type. Must be "delegations" to retrieve user’s delegation information.
  • user (string, required) — Address in 42-character hexadecimal format (e.g., 0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036).

Response

The response is an array of delegation objects, each representing an active delegation to a validator:

Delegation object structure

Each delegation object in the array contains:
  • validator (string) — The validator’s address in 42-character hexadecimal format.
  • amount (string) — The amount of tokens delegated to this validator.
  • lockedUntilTimestamp (number) — Timestamp (in milliseconds) until which the delegation is locked.

Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "delegations", "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info

Example response

[
    {
        "validator": "0x5ac99df645f3414876c816caa18b2d234024b487",
        "amount": "12060.16529862",
        "lockedUntilTimestamp": 1735466781353
    },
    {
        "validator": "0x1234567890abcdef1234567890abcdef12345678",
        "amount": "5000.0",
        "lockedUntilTimestamp": 1735556781353
    }
]

Use case

The info endpoint with type: "delegations" is essential for applications that need to:
  • Display active delegations: Show users their current validator delegations and amounts
  • Track delegation amounts: Monitor how much is delegated to each validator
  • Check lock periods: Display when delegations will become available for undelegation
  • Portfolio overview: Provide a simple view of delegation distribution across validators
  • Validator management: List which validators a user has delegated to
  • Delegation planning: Help users understand their current delegation commitments
  • Lock time monitoring: Track when delegations expire and become withdrawable
This endpoint provides basic delegation information and is typically used alongside other staking endpoints like delegatorSummary for comprehensive staking portfolio management on the Hyperliquid network.

Body

application/json

Response

200 - application/json

User's delegation information and staking details

Comprehensive delegation and staking information for the user