Account statements

One row per day (UTC) for any address:

balances at 24:00 UTC: USDC and stablecoins, open perp positions on every dex (main dex and HIP-3, keyed xyz:...), spot tokens, staked HYPE, native lending, vault equity, and the total account value;
activity during the day: realized PnL, fees, funding, deposits, withdrawals, transfers, vault flows, staking flows, traded volume and number of fills.

The current day is included as a provisional row, refreshed every few minutes, with balances as of the time given in its as_of flag. The final row for a day is written the following night. Statements start on 1 June 2025.

Where to get them

	Plans	Limits
Statements page in the Hypedexer app	Every plan, Free included	Free plan: up to 10 days of statements per day. Pick one of your API keys; the export spends its credits.
API, `GET /users/{address}/statements`	Paid plans	Up to 400 days per request. Free-plan keys get `403` with `"error": "statements_paid_plans"`.

Both return the same rows, as a table or as a JSON or CSV download. Statements are the way to read the value of an account across every dex: /users/{user}/account and /equity-history cover the main perp dex only, and return perp_account_empty: true for an account that trades only on HIP-3 dexes.

Request

curl "https://api.hypedexer.com/users/0x0000000000000000000000000000000000000000/statements?start_date=2026-09-01&end_date=2026-09-30&format=json" \
  -H "X-API-Key: YOUR_API_KEY"

Parameter	Required	Description
`start_date`	yes	First day (UTC), `YYYY-MM-DD`
`end_date`	yes	Last day (UTC), `YYYY-MM-DD`, inclusive. Up to 400 days per request.
`format`	no	`json` (default) or `csv`. CSV comes as a file download, one row per day; nested fields (`positions`, `spot_balances`, `vaults`) are JSON strings.

The JSON response is the usual envelope: {"success": true, "data": [rows...], "total_count": n, ...}. Days below $1 with no activity and no open position are omitted.

Fields

All amounts are in USD at each day’s closing prices, except staked_hype and staking_net_hype (in HYPE).

Field	Description
`date`	Day (UTC)
`total_value_usd`	Account value at 24:00 UTC: USDC and stablecoins + unrealized PnL + spot tokens + staked HYPE + native lending + vault equity
`usdc_balance_usd`	USDC and stablecoins (perp margin and spot), excluding unrealized PnL
`unrealized_pnl_usd`	Unrealized PnL of open perp positions at the closing price
`positions_notional_usd`, `n_positions`	Gross notional and number of open perp positions
`positions`	Open positions: `{"BTC": {"szi": size, "entryPx": entry price, "px": closing price}}` (negative size = short)
`spot_value_usd`, `spot_balances`	Value and amounts of non-stablecoin spot tokens
`staked_hype`, `staked_value_usd`	Staked HYPE, including HYPE waiting in the unstaking queue
`lend_net_usd`	Native lending: supplied minus borrowed
`vault_equity_usd`, `vaults`	Equity in vaults, total and per vault
`realized_pnl_usd`	PnL realized by fills during the day
`fees_usd`	Fees paid during the day: trading fees net of maker rebates (negative if rebates exceed fees), plus priority gas paid in HYPE, valued in USD
`funding_usd`	Funding received (positive) or paid (negative)
`deposits_usd`, `withdrawals_usd`	Deposits to and withdrawals from Hyperliquid
`transfers_in_usd`, `transfers_out_usd`	Transfers with other Hyperliquid accounts, including sub-accounts
`vault_net_usd`	Vault deposits (negative) and withdrawals (positive)
`staking_net_hype`	HYPE moved from spot to staking (positive) or back (negative)
`volume_usd`, `fills`	Traded notional and number of fills
`flags`	Comma-separated notes on the row, see below

Flags

Rows computed daily (from 11 October 2026) usually carry no flag besides as_of on the current day. Older rows are rebuilt backwards from later account states, and their flags say where a number is estimated.

Flag	Meaning
`as_of:<time>`	Provisional row for a day still in progress, with balances as of this UTC time
`missing_price:<markets>`	No closing price for these markets on this day; they are valued at zero
`fill_gap:<n>`	The position history shows `n` fills that could not be matched; their cash effect is estimated from neighbouring fill prices
`fees_estimated`	Some fills of the day have no recorded fee; their fee is estimated from the account’s fee rate
`pnl_split_estimated`	The split between cash, unrealized PnL and realized PnL is estimated by average cost; the total value is not affected
`staking_rewards_not_included`	Staking rewards earned after this day are not deducted when rebuilding it: past staked HYPE can be slightly overstated
`staking_history_partial`	The split between staked and spot HYPE is uncertain before the oldest available staking event; the total is not affected
`staking_balance_incomplete`	The staked HYPE balance could not be fully rebuilt for this day and is shown as at least zero
`priority_gas_estimated`	The priority gas of the day is estimated from the account’s cumulative total
`lending_interest_not_included`	Interest accrued on native lending after this day is not deducted when rebuilding it

Credits

Statements are billed like other REST calls, on the number of rows returned (one per day, JSON or CSV); see Rate Limits & Pricing. Every response carries its cost in the X-Credit-Cost header. In the app, each export shows what it cost.

Introduction

Guides

REST API

WebSocket

Where to get them

Request

Fields

Flags

Credits

​Where to get them

​Request

​Fields

​Flags

​Credits

Where to get them

Request

Fields

Flags

Credits