OPopensea
Account Endpoints

Get trading P&L for an account

Changed on

Get aggregated realized and unrealized trading profit and loss across all currencies held by a wallet address. Returns 200 with figures (which may be zero for a real but flat wallet) when OpenSea has indexed P&L for the wallet, and 404 only when no P&L has been indexed for it — letting consumers distinguish "indexed but flat" from "not indexed".

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

Request

Path parameters

addressstring required

The wallet address

Response

Wallet trading P&L. Indexed wallets return 200 even when all figures are zero (real but flat).

current_value_usdstring required

Current USD value of the wallet's open positions (net_invested + unrealized P&L). Provides a visible anchor for the unrealized figure.

net_invested_usdstring required

Net amount invested in USD

realized_pnl_usdstring required

Realized P&L in USD from closed positions

return_percentagestring required

Total return as a signed percentage in percent units (e.g. +12.16 means +12.16%, -8.40 means -8.40%). Not a 0-1 ratio.

total_pnl_usdstring required

Total P&L in USD (realized + unrealized)

unrealized_pnl_usdstring required

Unrealized P&L in USD from open positions

Example response

{
  "current_value_usd": "12179.9",
  "net_invested_usd": "12500.0",
  "realized_pnl_usd": "+1840.25",
  "return_percentage": "+12.16",
  "total_pnl_usd": "+1520.15",
  "unrealized_pnl_usd": "-320.1"
}

Changes

  • 2c7935d84f90Revision changes
    • info

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

    • 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