PnL By Address

Get Prediction Market PnL by Address

post

Get profit and loss across all prediction markets for a specific wallet address. Shows per-market PnL including buy costs, sell proceeds, and redemption values.

What it helps to answer:

1. What is a trader's total PnL across all prediction markets?

2. Which markets has this address traded, and what were the results?

3. Does this trader have unrealized positions?

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request for PnL by address endpoint.

addressstring · min: 1 · max: 100Required

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

Example: 0x1234567890abcdef1234567890abcdef12345678

order_byany ofOptional

Sort order

Example: [{"direction":"DESC","field":"total_pnl_usd"}]

Responses

200

PnL by address 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/pnl-by-address

HTTPcURLJavaScriptPython

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

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "order_by": [
    {
      "direction": "DESC",
      "field": "total_pnl_usd"
    }
  ]
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "address": "text",
      "market_id": "text",
      "question": "text",
      "event_id": "text",
      "event_title": "text",
      "side_held": "Yes",
      "net_buy_cost_usd": 1,
      "net_sell_proceeds_usd": 1,
      "redemption_value_usd": 1,
      "unrealized_value_usd": 1,
      "total_pnl_usd": 1,
      "market_resolved": true
    }
  ]
}