delegations | Hyperliquid info

The info endpoint with type: “delegations” retrieves a user’s active delegations on the Hyperliquid network. Hyperliquid info via Chainstack.

POST /4f8d8f4040bdacd1577bff8058438274/info

info (delegations)

cURL

curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "delegations",
  "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"
}
'

200

[
  {
    "validator": "0xb8f45222a3246a2b0104696a1df26842007c5bc5",
    "amount": "100233.20588006",
    "lockedUntilTimestamp": 1751468638782
  }
]

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 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 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

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

Use your own endpoint in your code. The code examples use a placeholder Chainstack endpoint (YOUR_CHAINSTACK_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the Chainstack console. The curl above uses a shared public endpoint for quick checks only; do not use it in production.

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

type · enum<string> · default: delegations · required

Request type to retrieve user's delegation information

Available options: delegations

user · string · default: 0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036 · required

Address in 42-character hexadecimal format

Response

200 - application/json

Active delegations for the user

validator · string · required

Validator address

amount · string · required

Delegated amount

lockedUntilTimestamp · integer · required

Lock expiration timestamp (ms)