---
title: "Get portfolio net worth history for an account"
method: GET
path: "/api/v2/account/{address}/portfolio/history"
tags: ["Account Endpoints"]
---

# Get portfolio net worth history for an account

`GET /api/v2/account/{address}/portfolio/history`

## Request

- Base URL: `https://api.opensea.io`
- URL: `https://api.opensea.io/api/v2/account/{address}/portfolio/history`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/account/:address/portfolio/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Get net worth time series data for a wallet address over a given timeframe.

## Path parameters

- `address` string, required

## Query parameters

- `timeframe` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH': Timeframe for portfolio analytics queries

## Response `200`

Portfolio history

- PortfolioHistoryResponse: Net worth time series data
  - `data_points` PortfolioHistoryDataPoint[], required: Time series data points
    - `nft_value_usd` string, required: NFT value in USD
    - `timestamp` number, double, required: Timestamp of the data point
    - `token_value_usd` string, required: Token value in USD
    - `value_usd` string, required: Total portfolio value in USD
  - `timeframe` string, required: The queried timeframe

## Other responses

- `400`: For error reasons, review the response data.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal server error. Please open a support ticket so OpenSea can investigate.

## Changes

- **2026-11-03** `2c7935d84f90`: 5 info
  - added the media type `*/*` for the response with the status `400`
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - …1 more

[Operation history](https://skmtc.dev/opensea/apis/opensea-api/changes/api/v2/account/:address/portfolio/history/get.md)

---

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