---
title: "Get Prediction Market Address Summary"
method: POST
path: "/api/v1/prediction-market/address-summary"
tags: ["Prediction Markets"]
---

# Get Prediction Market Address Summary

`POST /api/v1/prediction-market/address-summary`

Get wallet-level PnL summary for a single Polymarket trader.
Returns realized PnL, unrealized PnL, win rate, and wallet age.

**What it helps to answer:**

1. **What is this trader's overall Polymarket performance?**
2. **How many markets has this trader won vs traded?**
3. **How old is this wallet and when did it start trading?**

## Request body

- AddressSummaryRequest — Request for address summary endpoint.
  - `address` string, required — Wallet address (hex, with or without 0x prefix)
  - `pagination` PaginationRequest — Pagination parameters for API requests.
    - `page` integer — Page number (1-based)
    - `per_page` integer — Number of records per page (max 1000)

## Response `200`

Address summary data

- AddressSummaryResponse — Response for address summary endpoint.
  - `pagination` PaginationInfo — 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
  - `data` AddressSummaryItem[], required — Address summary (single row)
    - `address` string — Trader address (hex)
    - `first_seen` string, date — Date of first on-chain activity on Polygon
    - `wallet_age_days` integer — Days since first on-chain activity
    - `realized_pnl_usd` number — Realized PnL in USD
    - `unrealized_pnl_usd` number — Unrealized PnL from open positions in USD
    - `total_pnl_usd` number — Total PnL (realized + unrealized) in USD
    - `markets_won` integer — Number of markets with positive total PnL
    - `markets_traded` integer — Total number of markets with fills
    - `win_rate` number — Win rate (markets_won / markets_traded, 0-1)
    - `p2p_tokens_sent` number — Total tokens sent via P2P transfers
    - `p2p_tokens_received` number — Total tokens received via P2P transfers

## 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)