# Nansen Polymarket Wallet PnL Summary

> Nansen Polymarket Wallet PnL Summary is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns wallet-level PnL summary for a Polymarket trader including realized/unrealized PnL, win rate, and wallet age

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/prediction-market/address-summary
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-a6f4af49
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f9AxmrhmexLWYRYdFp5f9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-a6f4af49
```

Example prompt: Can you pull up the Polymarket performance summary for wallet 0x1234...abcd? I want to see their realized and unrealized PnL, win rate, and how long they've been trading.

## When to prefer this

Use this endpoint when you need a high-level performance overview of a specific Polymarket trader — including PnL, win rate, and wallet age — in a single call. Prefer this over the address PnL detail endpoint when a summary is sufficient and cost efficiency matters. Best for profiling individual traders, vetting smart money wallets, or quickly benchmarking a prediction market participant.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Wallet address with no Polymarket activity may return empty or zero values
- Network or upstream Nansen data unavailability results in 5xx errors
- Payment failure (x402) if USDC balance is insufficient
- Rate limiting if too many calls are made in quick succession

## How this service works

Get Prediction Market Address Summary

## Output

Returns a wallet-level summary including realized PnL, unrealized PnL, win rate (markets won vs traded), and wallet age/start date for the specified Polymarket trader address.

## Example request

```json
{
 "input": {
  "body": {
   "address": "0x1234567890123456789012345678901234567890"
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "AddressSummaryRequest",
 "required": [
  "address"
 ],
 "properties": {
  "address": {
   "type": "string",
   "title": "Address",
   "examples": [
    "0x1234567890abcdef1234567890abcdef12345678"
   ],
   "maxLength": 100,
   "minLength": 1,
   "description": "Wallet address (hex, with or without 0x prefix)"
  },
  "pagination": {
   "type": "object",
   "title": "PaginationRequest",
   "properties": {
    "page": {
     "type": "integer",
     "title": "Page",
     "default": 1,
     "minimum": 1,
     "description": "Page number (1-based)"
    },
    "per_page": {
     "type": "integer",
     "title": "Per Page",
     "default": 10,
     "maximum": 1000,
     "minimum": 1,
     "description": "Number of records per page (max 1000)"
    }
   },
   "description": "Pagination parameters for API requests."
  }
 },
 "description": "Request for address summary endpoint.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "AddressSummaryResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "AddressSummaryItem",
    "properties": {
     "address": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Address",
      "description": "Trader address (hex)"
     },
     "win_rate": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Win Rate",
      "description": "Win rate (markets_won / markets_traded, 0-1)"
     },
     "first_seen": {
      "anyOf": [
       {
        "type": "string",
        "format": "date"
       }
      ],
      "title": "First Seen",
      "description": "Date of first on-chain activity on Polygon"
     },
     "markets_won": {
      "anyOf": [
       {
        "type": "integer"
       }
      ],
      "title": "Markets Won",
      "description": "Number of markets with positive total PnL"
     },
     "total_pnl_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Total Pnl Usd",
      "description": "Total PnL (realized + unrealized) in USD"
     },
     "markets_traded": {
      "anyOf": [
       {
        "type": "integer"
       }
      ],
      "title": "Markets Traded",
      "description": "Total number of markets with fills"
     },
     "p2p_tokens_sent": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "P2P Tokens Sent",
      "description": "Total tokens sent via P2P transfers"
     },
     "wallet_age_days": {
      "anyOf": [
       {
        "type": "integer"
       }
      ],
      "title": "Wallet Age Days",
      "description": "Days since first on-chain activity"
     },
     "realized_pnl_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Realized Pnl Usd",
      "description": "Realized PnL in USD"
     },
     "unrealized_pnl_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Unrealized Pnl Usd",
      "description": "Unrealized PnL from open positions in USD"
     },
     "p2p_tokens_received": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "P2P Tokens Received",
      "description": "Total tokens received via P2P transfers"
     }
    },
    "description": "Address summary data from ch_api_pm_address_summary."
   },
   "title": "Data",
   "description": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-a6f4af49/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)