webData3
Get a lightweight account summary for a user: agent wallet, account mode, cumulative ledger and per-DEX vault equity.
POST Request
type
string
Must be "webData3"
user
string
User Ethereum address (0x-prefixed, 42 characters)
The response always covers every perp DEX. There is no dex filter.
curl -X POST https://api.hydromancer.xyz/info \
-H "Authorization: Bearer $HYDROMANCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "webData3",
"user": "0x0000000000000000000000000000000000000000"
}'import requests
import os
response = requests.post(
'https://api.hydromancer.xyz/info',
json={
'type': 'webData3',
'user': '0x0000000000000000000000000000000000000000'
},
headers={
'Authorization': f'Bearer {os.environ.get("HYDROMANCER_API_KEY")}',
'Content-Type': 'application/json'
}
)
print(response.json())Response Fields
userState
object
Account-level summary
userState.agentAddress
string?
Approved agent (API) wallet address (null if none)
userState.agentValidUntil
int?
Agent validity timestamp in ms (null if none)
userState.cumLedger
string
Cumulative ledger value
userState.serverTime
int
Server timestamp (ms)
userState.isVault
boolean
Whether the user is a vault
userState.user
string
User address
userState.dexAbstractionEnabled
boolean
Whether per-DEX abstraction is enabled. Omitted for some accounts
userState.abstraction
string
Account abstraction mode, e.g. unifiedAccount or portfolioMargin. Omitted for some accounts
perpDexStates
array
One entry per perp DEX. Index 0 is the native Hyperliquid DEX, followed by HIP-3 DEXes in perpDexs order
perpDexStates[].totalVaultEquity
string
User's total vault equity on that DEX
perpDexStates[].perpsAtOpenInterestCap
array
Perp symbols on that DEX currently at their open interest cap. Omitted when there are none
Response
Migrating from webData2
webData2 returned positions, orders and market data in one response. webData3 returns only the account summary, so fetch the rest from these endpoints:
agentAddress, agentValidUntil, cumLedger, isVault, serverTime, user
webData3 → userState
totalVaultEquity
webData3 → perpDexStates[].totalVaultEquity (now per DEX)
perpsAtOpenInterestCap
webData3 → perpDexStates[].perpsAtOpenInterestCap (now per DEX), or perpsAtOpenInterestCap
clearinghouseState
clearinghouseState, or portfolioState for perp + spot together
openOrders
openOrders or frontendOpenOrders
meta, assetCtxs
metaAndAssetCtxs
leadingVaults
leadingVaults
twapStates
userTwapSummaries
Last updated