Skip to main content
POST
/
info
userVaultEquities
curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "user": "<string>"
}
'
{
  "vaultAddress": "<string>",
  "equity": "<string>",
  "lockedUntilTimestamp": 123
}

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 the wallet’s per-vault equity: one entry per vault the user has deposited into, with the locked amount and the timestamp at which that equity becomes unlockable. User-keyed. The result is [] for wallets that haven’t deposited into any vault.

​
Endpoint

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

​
Request

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

​
Response

An array of vault equity entries. 
[
  {
    "vaultAddress": "0x1962905b0a2d0ce8907a92ed5f7a17fef3e1b53e",
    "equity": "5000.50",
    "lockedUntilTimestamp": 1741132800000
  }
]

​
Field descriptions

equity is returned as a decimal string, preserving upstream precision. Do not parse it as a float - keep it as a string or use a fixed-precision decimal type.
​
vaultAddress
string
Vault contract address (0x-prefixed hex).
​
equity
string
User’s equity in this vault, in USD.
​
lockedUntilTimestamp
int
Unix timestamp in milliseconds at which this equity becomes unlockable.

​
Notes

  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "userVaultEquities", "user": "..."}.
  • For real-time push of vault deposit, withdrawal, and distribution events, subscribe to walletTxs and read LedgerVaultDeposit, LedgerVaultWithdraw, and LedgerVaultDistribution entries.