POST
/
info
Query a user's staking history
curl --request POST \
  --url https://api.hyperliquid.xyz/info \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "delegatorHistory",
  "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"
}'
[
  {
    "time": 1735380381353,
    "hash": "0x55492465cb523f90815a041a226ba90147008d4b221a24ae8dc35a0dbede4ea4",
    "delta": {
      "delegate": {
        "validator": "0x5ac99df645f3414876c816caa18b2d234024b487",
        "amount": "10000.0",
        "isUndelegate": false
      }
    }
  },
  {
    "time": 1735380281353,
    "hash": "0x44492465cb523f90815a041a226ba90147008d4b221a24ae8dc35a0dbede4ea3",
    "delta": {
      "delegate": {
        "validator": "0x5ac99df645f3414876c816caa18b2d234024b487",
        "amount": "5000.0",
        "isUndelegate": true
      }
    }
  }
]
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet.
The info endpoint with type: "delegatorHistory" retrieves comprehensive staking history for a specific user on the Hyperliquid exchange. This endpoint provides detailed historical data about delegation and undelegation events, including timestamps, transaction hashes, and complete event details, enabling thorough analysis of staking behavior and validator relationships.
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 "delegatorHistory" to retrieve staking history.
  • user (string, required) — Address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.

Response

The response is an array of staking history events, ordered chronologically. Each event represents a delegation or undelegation action performed by the user.

Response structure

Each staking event contains: Event metadata:
  • time — Timestamp of the staking event in milliseconds since Unix epoch
  • hash — Transaction hash of the staking event for blockchain verification
Event details:
  • delta — Object containing the details of the staking change
  • delegate — Specific delegation event information

Delegation event structure

The delegate object within delta contains: Validator information:
  • validator — Address of the validator being delegated to or undelegated from
  • Identifies the specific validator node in the network
Staking amount:
  • amount — Amount being delegated or undelegated as a string for precision
  • Represents the quantity of tokens involved in the staking action
Event type:
  • isUndelegate — Boolean indicating the type of staking event
  • false indicates a delegation event (staking tokens)
  • true indicates an undelegation event (unstaking tokens)

Data interpretation

Delegation events (isUndelegate: false):
  • User is staking tokens with a validator
  • Increases the user’s staked position with that validator
  • Contributes to the validator’s total delegated stake
  • Begins earning staking rewards
Undelegation events (isUndelegate: true):
  • User is unstaking tokens from a validator
  • Decreases the user’s staked position with that validator
  • May be subject to unbonding periods
  • Stops earning rewards on the undelegated amount
Historical tracking:
  • Events are ordered chronologically
  • Transaction hashes provide blockchain verification
  • Complete audit trail of all staking activities

Staking analysis insights

Staking behavior patterns

Delegation strategies:
  • Analyze which validators the user prefers to delegate to
  • Track delegation amounts and timing patterns
  • Identify diversification strategies across multiple validators
Staking duration analysis:
  • Calculate time between delegation and undelegation events
  • Analyze staking commitment periods
  • Identify patterns in staking behavior over time
Amount analysis:
  • Track the size of delegation and undelegation events
  • Analyze whether user prefers large or small staking amounts
  • Monitor changes in staking strategy over time

Validator relationships

Validator preferences:
  • Identify which validators the user delegates to most frequently
  • Analyze loyalty to specific validators
  • Track changes in validator preferences over time
Risk distribution:
  • Assess how the user distributes stake across validators
  • Analyze concentration risk in validator selection
  • Monitor diversification strategies

Staking timeline analysis

Activity frequency:
  • Analyze how often the user performs staking operations
  • Identify periods of high or low staking activity
  • Correlate staking activity with market conditions
Timing patterns:
  • Identify patterns in delegation and undelegation timing
  • Analyze whether user times staking actions strategically
  • Monitor response to network events or validator changes

Portfolio management

Staking allocation:
  • Track total staked amounts over time
  • Analyze allocation changes between validators
  • Monitor overall staking strategy evolution
Liquidity management:
  • Analyze patterns of delegation vs undelegation
  • Track how user manages staked vs liquid token balance
  • Identify liquidity needs and staking optimization

Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "delegatorHistory", "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"}' \
  https://api.hyperliquid.xyz/info

Use cases

The info endpoint with type: "delegatorHistory" is essential for applications that need to:
  • Track staking history: Monitor all delegation and undelegation events over time
  • Analyze staking patterns: Understand user behavior and validator preferences
  • Calculate rewards: Determine staking rewards based on historical delegation timing
  • Audit staking activity: Provide complete audit trails with transaction hashes
  • Portfolio analytics: Analyze staking strategy and performance over time
  • Validator research: Study relationships between delegators and validators
  • Tax reporting: Generate historical staking data for tax calculation purposes
  • Risk management: Assess staking concentration and diversification patterns
  • Liquidity planning: Plan future delegations based on historical patterns
  • Compliance tracking: Maintain detailed records of staking activities
This endpoint provides comprehensive staking history, enabling detailed analysis and management of delegation activities on the Hyperliquid network.

Body

application/json

Response

200 - application/json

Successful response with staking history data

Array of staking history events