Get balance history
Daily evolution of the account’s balances for dashboard charts: one series per asset (the closing available balance of each day, carried forward on days without movements) plus an aggregated USD series that values BTC/GOLD at each day’s historical reference price. Includes the period’s total inflows/outflows and the current snapshot (available + held), so a front can render a Mercury-style balance card with its percentage change. The series tracks the available balance (holds have no history); current carries today’s held per asset. Days valued with today’s spot price (before historical prices exist) are disclosed in spot_priced_dates — values are never invented.
The assets map also includes the banking account mirrors (BANK_USD, BANK_EUR) as their own series in their own currency (2 decimals). They are not part of the total_usd aggregate, which only covers the operational balances (USDT, USDC, BTC, GOLD).
Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Query Parameters
Start date (YYYY-MM-DD, UTC, inclusive).
End date (YYYY-MM-DD, UTC, inclusive). Max range 366 days.
Response
Daily balance series per asset plus USD aggregate.
"day"
"UTC"
One daily closing-balance series per asset. Includes the operational balances (USDT, USDC, BTC, GOLD) and the banking account mirrors (BANK_USD, BANK_EUR) in their own currency; the banking series are excluded from total_usd.
Aggregated USD value of all balances per day.
Total inflows/outflows of the period in USD.
Current snapshot (available + held, valued at spot).