# Nansen Hyperliquid Perp PnL Summary

> Nansen Hyperliquid Perp 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-14).

Returns a profit and loss summary for a given wallet address on the Hyperliquid perpetuals market over a specified date range

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/profiler/perp-pnl-summary
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-hyperliquid-perp-pnl-summary-d172f5e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E5r3qN7CaDuoUTmjSiAz_

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-hyperliquid-perp-pnl-summary-d172f5e5
```

Example prompt: Can you pull the Hyperliquid perp PnL summary for wallet 0x1234567890abcdef1234567890abcdef12345678 for the date range January 1 to March 31 2025?

## When to prefer this

Use this endpoint when you need an aggregated PnL summary specifically for Hyperliquid perpetual futures trading for a given wallet and time window. It is ideal for performance reviews, smart money research, and portfolio attribution on the Hyperliquid exchange. Prefer this over raw transaction endpoints when you want pre-computed PnL metrics rather than individual trade data, and over general DEX trade endpoints when the query is specifically about Hyperliquid perps.

## Known failure modes

- Invalid or malformed wallet address (not 42-character hex format) returns an error
- Date range parameters missing or malformed result in a validation error
- Wallet address has no Hyperliquid perp trading history returns empty or zero results
- Date range too broad may time out or return partial data
- Payment failure due to insufficient x402 balance causes a 402 response
- Rate limiting if the endpoint is called too frequently

## How this service works

Get Hyperliquid Perp PnL Summary

## Output

A structured summary of profit and loss from perpetual futures trading on Hyperliquid for the specified wallet address and date range, including aggregated metrics such as total realized PnL, trade counts, and other performance indicators relevant to perp trading activity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "object"
  },
  "address": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-hyperliquid-perp-pnl-summary-d172f5e5/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)