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

# GET /v3/portfolio/performance

`GET /v3/portfolio/performance`

## 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/performance`
- Auth: HTTP bearer

Returns current complete marked spot-wallet equity, canonical Solana USDC cash, raw equity change, and actual historical observations for the authenticated principal. The server records at most one complete observation per UTC hour. Native gas assets are included only when priced; Hyperliquid/perps and pending cross-chain arrivals are not included.

## Query parameters

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

## Response `200`

Current portfolio totals and bounded historical observations

- PortfolioPerformance: Arbital-owned hourly spot-wallet equity history. Values are display-only; change is raw equity movement and includes deposits, withdrawals, and transfers.
  - `message` 'Portfolio performance found', required
  - `responseObject` PortfolioPerformanceObject, required
    - `change` union, required
      - object
        - `amount_usd` string, required
        - `baseline_observed_at_ms` string, required
        - `kind` 'raw_equity_change', required
        - `status` 'available', required
      - object
        - `kind` 'raw_equity_change', required
        - `reason` 'insufficient_history' | 'history_gap', required
        - `status` 'unavailable', required
    - `currency` 'USD', required
    - `current` PortfolioPerformancePoint, required
      - `cash_usd` string, required
      - `equity_usd` string, required
      - `observed_at_ms` string, required
    - `points` PortfolioPerformancePoint[], required
      - `cash_usd` string, required
      - `equity_usd` string, required
      - `observed_at_ms` string, required
    - `range` '24h' | '7d' | '30d' | 'all', required
  - `statusCode` 200, required
  - `success` true, required

## Other responses

- `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.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

[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)