Address Summary

Get Prediction Market Address Summary

post

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?

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request for address summary endpoint.

addressstring · min: 1 · max: 100Required

Wallet address (hex, with or without 0x prefix)

Example: 0x1234567890abcdef1234567890abcdef12345678

Responses

200

Address summary data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

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

HTTPcURLJavaScriptPython

POST /api/v1/prediction-market/address-summary HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 94

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "address": "text",
      "first_seen": "2026-05-07",
      "wallet_age_days": 1,
      "realized_pnl_usd": 1,
      "unrealized_pnl_usd": 1,
      "total_pnl_usd": 1,
      "markets_won": 1,
      "markets_traded": 1,
      "win_rate": 1,
      "p2p_tokens_sent": 1,
      "p2p_tokens_received": 1
    }
  ]
}