Skip to main content
POST
/
info
delegatorRewards
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,
  "source": "<string>",
  "totalAmount": "<string>"
}

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 single user’s accrued HYPE staking rewards: one entry per accrual, with the timestamp, the source (delegation reward versus validator commission), and the amount. User-keyed. Use this for tax reports, reward attribution dashboards, and validator P&L; use delegatorHistory for the underlying delegate / undelegate events and delegatorSummary for current totals.

​
Endpoint

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

​
Request

​
type
string
required
Always "delegatorRewards".
​
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": "delegatorRewards",
    "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
  }'

​
Response

An array of reward entries. 
[
  {
    "time": 1735689600000,
    "source": "delegation",
    "totalAmount": "1.5234"
  },
  {
    "time": 1735776000000,
    "source": "commission",
    "totalAmount": "0.8791"
  }
]

​
Field descriptions

totalAmount is returned as a decimal string, preserving upstream precision. Do not parse it as a float.
​
time
int
Unix timestamp in milliseconds when the reward accrued.
​
source
string
Reward source. "delegation" for rewards earned by delegating to a validator; "commission" for commission earned as a validator on others’ delegations.
​
totalAmount
string
Reward amount in HYPE.

​
Notes

  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "delegatorRewards", "user": "..."}.
  • For the underlying delegate / undelegate / withdrawal events, use delegatorHistory.
  • For current totals (delegated, undelegated, pending withdrawal sums), use delegatorSummary.
  • For real-time push of rewards-claim events, subscribe to walletTxs and read LedgerRewardsClaim entries.