OPopensea
Account Endpoints

Get portfolio stats for an account

Changed on

Get portfolio analytics including total value, NFT/token breakdown, and P&L for a wallet address over a given timeframe.

get/api/v2/account/{address}/portfolio

Request

Path parameters

addressstring required

The wallet address

Query parameters

timeframe'HOUR' | 'DAY' | 'WEEK' | 'MONTH'

Timeframe for portfolio analytics queries

Timeframe for P&L calculation: HOUR, DAY, WEEK, MONTH

chainsChainIdentifier[]

Comma-separated chains to restrict the portfolio to (e.g. ethereum,base). When omitted, all supported chains are included. Returns 400 if all specified chains are unsupported.

[
  "ethereum"
]

Response

Portfolio stats

nft_value_usdstring required

NFT portfolio value in USD

pnl_absolutestring nullable

Absolute P&L in USD over the timeframe

pnl_percentagestring nullable

Percentage P&L over the timeframe

timeframestring required

The queried timeframe

token_value_usdstring required

Token portfolio value in USD

total_value_usdstring required

Total portfolio value in USD

Example response

{
  "nft_value_usd": "98200.0",
  "pnl_absolute": "+1250.00",
  "pnl_percentage": "+1.01",
  "timeframe": "WEEK",
  "token_value_usd": "27230.5",
  "total_value_usd": "125430.5"
}

Changes

  • 2c7935d84f90Revision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • info

      added the new optional query request parameter chains

    • info

      added the media type */* for the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status