---
title: "Get Address PnL Summary Data"
method: POST
path: "/api/v1/profiler/address/pnl-summary"
tags: ["Profiler"]
---

# Get Address PnL Summary Data

`POST /api/v1/profiler/address/pnl-summary`

Get aggregate PnL statistics and top profitable tokens for a specific wallet address.
This endpoint provides comprehensive profit and loss analysis including realized PnL, win rate, and top performing tokens.

## Request body

- ProfilerAddressPnlSummaryRequest
  - `address` string — Address to get PnL summary for
  - `entity_name` string — Entity name to get PnL summary for
  - `chain` 'all' | 'arbitrum' | 'avalanche' | 'base' | 'bnb' | 'ethereum' | 'linea' | 'mantle' | 'monad' | 'optimism' | 'plasma' | 'polygon' | 'robinhood' | 'sei' | 'solana' | 'sonic' | 'sui', required — Chains supported in profiler PnL analysis.
  - `date` DateRange, required — Date range model matching the API schema.
    - `from` string — Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)
    - `to` string — End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)

## Response `200`

Address PnL summary data

- ProfilerAddressPnlSummaryResponse — Response model for profiler address pnl-summary endpoint. Contains aggregate PnL statistics and top profitable tokens.
  - `pagination` PaginationInfo, required — Pagination information for API responses.
    - `page` integer — Current page number
    - `per_page` integer — Number of records per page
    - `is_last_page` boolean — Whether this is the last page
  - `top5_tokens` ProfilerTopToken[], required — Top 5 tokens by realized profit
    - `realized_pnl` number, required — Realized profit and loss in USD
    - `realized_roi` number, required — Realized return on investment as percentage
    - `token_address` string, required — Token contract address
    - `token_symbol` string, required — Token symbol
    - `chain` string, required — Blockchain chain
  - `traded_token_count` integer, required — Total number of different tokens that have been bought or sold
  - `traded_times` integer, required — Total number of sales (outflow or dex sell)
  - `realized_pnl_usd` number, required — Total realized profit and loss in USD
  - `realized_pnl_percent` number, required — Realized profit and loss as a percentage (not multiplied by 100)
  - `win_rate` number, required — Number of sales where price of the token was higher than cost basis

## Other responses

- `400` — Bad Request - Invalid request parameters or malformed request
- `401` — Authentication error - No API key found in request
- `402` — Payment Required - This endpoint supports pay-per-request via x402 and MPP. x402 responses advertise payment options in `Payment-Required`; MPP responses advertise a fresh `WWW-Authenticate: Payment ...` challenge. Successful MPP responses may include `Payment-Receipt`.
- `403` — Forbidden - User does not have required subscription tier or has exceeded credit limit
- `404` — Not Found - The requested resource was not found
- `422` — Validation error - Invalid request parameters
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/nansen/apis/nansen-api.md) · [All operations](https://skmtc.net/nansen/apis/nansen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nansen/nansen-api/revisions/02a4d2e7d827/schema)