OPopensea
Account Endpoints

Get token transfers for a wallet's position in a currency

Changed on

Get a paginated, transfer-level breakdown of a wallet's position in a single currency (identified by contract_address + chain). Combine direction and transfer_type to distinguish zero-cost acquisitions (airdrops, CEX transfers) from buys.

get/api/v2/account/{address}/pnl/token-transfers

Request

Path parameters

addressstring required

The wallet address

Query parameters

contract_addressstring required

The currency's contract address

chain'base' | 'ethereum' | 'zora' | 'arbitrum' | 'sei' | 'avalanche' | 'polygon' | 'optimism' | 'ape_chain' | 'flow' | 'soneium' | 'ronin' | 'bera_chain' | 'solana' | 'shape' | 'unichain' | 'gunzilla' | 'abstract' | 'animechain' | 'hyperevm' | 'somnia' | 'monad' | 'hyperliquid' | 'megaeth' | 'ink' | 'robinhood' | 'stablechain' required

Blockchain chain identifier. Use the chain slug (e.g., 'ethereum', 'polygon', 'arbitrum', 'optimism', 'base')

Example:ethereum

The chain the currency is on

limitinteger

Number of results to return per page (1-200, default 20)

nextstring

Cursor for the next page of results

Response

Position token transfers

nextstring nullable

Cursor for the next page of results, or null if there are no more pages

total_countinteger required

Total number of token transfers for the position across all pages

Example response

{
  "token_transfers": [
    {
      "block_time": 1777334400,
      "direction": "IN",
      "price_usd": "0.0425",
      "quantity_raw": "1500000000",
      "transfer_type": "SWAP_BUY",
      "tx_signature": "0xabc123",
      "value_usd": "63.75"
    }
  ],
  "total_count": 17
}

Changes

  • 2c7935d84f90Revision changes
    • breaking

      removed the enum value b3 from the query request parameter chain

    • breaking

      removed the enum value blast from the query request parameter chain

    • breaking

      the response property became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • info

      added the new enum value stablechain to the query request parameter chain

    • 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