Skip to main content
POST
/
info
userFunding
curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "user": "<string>",
  "startTime": 123,
  "endTime": 123
}
'
{
  "time": 123,
  "hash": "<string>",
  "delta": {
    "type": "<string>",
    "coin": "<string>",
    "usdc": "<string>",
    "szi": "<string>",
    "fundingRate": "<string>",
    "nSamples": {}
  }
}

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 funding payment history within a [startTime, endTime) window. Each entry is one funding application: a coin, the rate that was applied, the position size at the time, and the resulting USDC delta (negative = paid, positive = received). User-keyed. Use this for funding-only P&L attribution; use userNonFundingLedgerUpdates for everything else.

​
Endpoint

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

​
Request

​
type
string
required
Always "userFunding".
​
user
string
required
The wallet address (lowercase 0x-prefixed hex).
​
startTime
int
Unix timestamp in milliseconds. Inclusive lower bound for the window.
​
endTime
int
Unix timestamp in milliseconds. Inclusive upper bound. Defaults to current server time when omitted.

​
Example

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

​
Response

An array of funding event objects, one per applied funding interval and coin. 
[
  {
    "time": 1735689600000,
    "hash": "0x6b9c0a4a3d54b0d4d6b1a0c4d8c9e7f2b6e5d3c2a1f0e9d8c7b6a5f4e3d2c1b0a",
    "delta": {
      "type": "funding",
      "coin": "BTC",
      "usdc": "-50.25",
      "szi": "1.5",
      "fundingRate": "0.0001",
      "nSamples": null
    }
  }
]

​
Field descriptions

All numeric delta fields are returned as decimal strings. Do not parse them as floats - keep them as strings or use a fixed-precision decimal type.
​
time
int
Unix timestamp in milliseconds when the funding payment was applied.
​
hash
string
L1 transaction hash that included the funding application.
​
delta
object
Funding-event payload.

​
Notes

  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "userFunding", "user": "..."}.
  • For real-time push, subscribe to walletTxs and read HypercoreFundingEvent entries.
  • Use userNonFundingLedgerUpdates for deposits, withdrawals, transfers, vault flows, liquidations, and other balance-moving events.