Skip to navigation
Predict REST APIAccount

Get account stats

Retrieve period-scoped PnL, volume, fees, and trading counts, plus current open positions and marked position value.

Path parameters

addressstringRequired

EVM wallet address encoded as a 0x-prefixed hexadecimal string.

Query parameters

periodenumOptionalDefaults to all_time

Chart period. Defaults to all_time when omitted.

Allowed values:

Response

OK
accountobjectOptional
periodenumOptional
Allowed value for period.
Allowed values:
pnl_usdcstringOptional

Base-10 decimal value encoded as a string to preserve precision.

volume_usdcstringOptional

Base-10 decimal value encoded as a string to preserve precision.

fees_paid_usdcstringOptional
trade_countintegerOptional
traded_outcomesintegerOptional
open_positionsintegerOptional
positions_value_usdcstringOptional

Marked value of open Predict positions. Not Hyperliquid collateral or withdrawable USDC. Spot balances come from Hyperliquid spotClearinghouseState; Predict does not duplicate them.

as_ofdatetimeOptional

Errors

400
Bad Request Error
404
Not Found Error
405
Method Not Allowed Error
500
Internal Server Error
503
Service Unavailable Error