Skip to main content
HyperliquidPolymarket
Returns collateral and spot-token balances, including canonical Polygon pUSD. Perpetual positions and prediction-market outcome shares use separate reads.

​
Endpoint

​
Request Body

​
Response

The response is a complete { balances, time } snapshot. time is the evaluation timestamp in milliseconds; ignore older snapshots when reconciling REST and WebSocket data. An empty balances array clears prior balances. A failed read is unavailable data, not an empty snapshot.

​
Balance Row Fields

​
USDC Balance and Debt

For USDC, total is the effective gross balance projected from pool shares and pending USDC. It already reflects USDC moved into isolated scopes; do not subtract isolated balances again. A gross balance is not the account’s withdrawable amount. Use Account Summary for withdrawable. Polygon pUSD uses the same response shape, with AssetId 800101c011a7e12a19f7b1f670d46f03b03f3342e82dfb. Its balance is no longer split into local, pending, and confirmed buckets. See Collateral Balance. Debt-only rows remain present with zero total. pUSD totalDebt includes the canonical payoff and fractional-interest rounding; clients must not reconstruct it from debt components.

​
pUSD buying power

An account with eligible collateral deposited into Notional receives a projected pUSD row even before owning or borrowing pUSD. Its total, hold, and liability remain real accounting values; reading the row creates no cash, debt, or account equity. External Hyperliquid wallet balances do not provide collateral until deposited into Notional. The optional tradingCapacity field reports the complete additional order reservation the account can fund, including automatic borrowing:
An account with this capacity can have total: "0", hold: "0", and liability.totalDebt: "0". availableToTrade is buying power, not withdrawable cash. additionalBorrow is the debt needed to use the full budget; existing debt is reported separately. The budget includes the order’s price and fee reservation, so it is not a maximum order notional. borrowing is enabled, disabled, or halted. A known zero budget is an available response with availableToTrade: "0.000000". Missing funding evidence instead returns { status: "unavailable", reason, asOf, validUntil }, without numeric capacity. Discard expired capacity; admission rechecks current policy, custody, liquidity, collateral, and risk limits. For Hyperliquid-style signed totals and negative credit holds, use Spot Clearinghouse State.