---
title: "GET /v3/portfolio/history"
method: GET
path: "/v3/portfolio/history"
tags: ["Portfolio"]
---

# GET /v3/portfolio/history

`GET /v3/portfolio/history`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v3/portfolio/history`
- Auth: HTTP bearer

Returns on-demand Mobula historical net worth for the authenticated principal’s current managed wallets. The Portfolio service caches complete results. Incomplete backfill returns 202, never an empty successful chart. Only range is accepted; callers cannot supply wallet addresses or another user. Existing /v3/portfolio/performance retains its observed equity/cash contract.

## Query parameters

- `range` '24h' | '7d' | '30d', required

## Response `200`

Complete reconstructed history

- PortfolioHistory
  - `message` string, required
  - `responseObject` PortfolioHistorySnapshot, required: Provider-reconstructed historical net worth, including the effect of deposits and withdrawals. This is not trading P&L or locally observed equity/cash; historical cash is not supplied. Wallet scope is resolved from the authenticated principal.
    - `source` 'zerion', required
    - `kind` 'historical_net_worth', required
    - `currency` 'USD', required
    - `range` '24h' | '7d' | '30d', required
    - `from_ms` string, required
    - `to_ms` string, required
    - `fetched_at_ms` string, required
    - `points` object[], required
      - `timestamp_ms` string, required
      - `equity_usd` string, required
  - `statusCode` 200, required
  - `success` true, required

## Other responses

- `202`: Provider history is being prepared; retry after the stated interval
- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `429`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Portfolio history temporarily unavailable. Capacity exhaustion returns code portfolio_history_busy with bounded Retry-After guidance; provider backfill instead returns HTTP 202. Other failures return portfolio_history_unavailable.

---

[API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)