> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypedexer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account statements

> Daily balances and activity for any HyperCore address, one row per day, as JSON or CSV: in the app on every plan, through the API on paid plans

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](https://app.hypedexer.com/app/statements) 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`](https://docs.hypedexer.com/api-reference/users/account-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`](https://docs.hypedexer.com/api-reference/social-trading/account-state-and-leverage) 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

```bash theme={null}
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](https://docs.hypedexer.com/guides/rate-limits-and-quotas.md). Every response carries its cost in the `X-Credit-Cost` header. In the app, each export shows what it cost.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.