Skip to main content
POST
delegatorHistory | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "delegatorHistory" is used to reconstruct the sequence of HYPE staking events behind the totals shown in delegatorSummary.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "delegatorHistory", "user": "..."}.
  • For totals (delegated, undelegated, pending withdrawal sums), use delegatorSummary.
  • For accrued staking and commission rewards, use delegatorRewards.
  • For real-time push of staking events, subscribe to walletTxs and read HypercoreDelegationEvent entries.
Returns a user’s HYPE staking event history: every delegate, undelegate, staking-account deposit, and unstake withdrawal, ordered by time. Use this to reconstruct the sequence behind the totals shown in delegatorSummary. User-keyed. Each entry carries a delta whose discriminator describes the event variant.

Endpoint

Request

type
string
required
Always "delegatorHistory".
user
string
required
The wallet address (lowercase 0x-prefixed hex).

Example

Response

An array of staking event objects.

Field descriptions

delta.delegate.amount is returned as a decimal string, preserving upstream precision. Do not parse it as a float.
time
int
Unix timestamp in milliseconds when the event was applied.
hash
string
L1 transaction hash that produced the event.
delta
object
Event-specific payload. The example above shows a delegate variant; other variants observed in the wild include cDeposit (staking-account deposit) and withdrawal (unstake withdrawal). The shape changes per variant.

delegatorRewards

fetch a user’s current HYPE staking position.

delegatorSummary

get a one-shot snapshot of a user’s HYPE staking position for dashboards and portfolio overviews.

fundingHistory

fetch a coin’s historical funding rates and premiums over a time window for funding analytics and basis…
Last reviewed: 2026-06-13