Get Hyperliquid Perp PnL Summary

Get Hyperliquid Perp PnL Summary

post

Get aggregate realized PnL statistics for a Hyperliquid perpetual trader over a date range. Returns total realized PnL, closing-notional return, fees, trade counts, win rate, and top coins.

What it helps to answer:

1. What is the total realized PnL for a Hyperliquid trader over a time period?

2. What is the win rate based on closing trades?

3. Which perp coins are the most profitable for this trader?

Note: This endpoint covers realized PnL only. For current unrealized PnL and open positions, use the profiler/perp-positions endpoint.

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

Request model for the Hyperliquid perp PnL summary endpoint.

addressstring · min: 42 · max: 42Required

Hyperliquid wallet address in 42-character hexadecimal format

Example: 0x47f5a6397b79deaaca5c456503e7c1a49357b942

Responses

200

Hyperliquid perp PnL 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

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/profiler/perp-pnl-summary

HTTPcURLJavaScriptPython

POST /api/v1/profiler/perp-pnl-summary HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "address": "0x47f5a6397b79deaaca5c456503e7c1a49357b942",
  "date": {
    "from": "2026-04-30T00:00:00Z",
    "to": "2026-07-29T23:59:59Z"
  }
}

{
  "data": {
    "top5_coins": [
      {
        "coin": "text",
        "realized_pnl_usd": 1,
        "realized_roi": 1,
        "closed_trade_count": 1,
        "fees_usd": 1
      }
    ],
    "traded_coin_count": 1,
    "traded_times": 1,
    "closed_trade_count": 1,
    "winning_trade_count": 1,
    "realized_pnl_usd": 1,
    "realized_pnl_percent": 1,
    "win_rate": 1,
    "fees_usd": 1
  }
}