Skip to main content
POST
/
info
delegatorHistory
curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "user": "<string>"
}
'
{
  "time": 123,
  "hash": "<string>",
  "delta": {
    "delegate.validator": "<string>",
    "delegate.amount": "<string>",
    "delegate.isUndelegate": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json

​
Request

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

​
Example

curl -X POST https://hypercore.goldrushdata.com/info \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "delegatorHistory",
    "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
  }'

​
Response

An array of staking event objects. 
[
  {
    "time": 1735689600000,
    "hash": "0x6b9c0a4a3d54b0d4d6b1a0c4d8c9e7f2b6e5d3c2a1f0e9d8c7b6a5f4e3d2c1b0a",
    "delta": {
      "delegate": {
        "validator": "0x5ac99df645f3414876c816caa18b2d234024b487",
        "amount": "1000.5",
        "isUndelegate": false
      }
    }
  }
]

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

​
Notes

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