{"uid":"cap_E5r3qN7CaDuoUTmjSiAz_","slug":"nansen-hyperliquid-perp-pnl-summary-d172f5e5","name":"Nansen Hyperliquid Perp PnL Summary","description":"Get Hyperliquid Perp PnL Summary","url":"https://api.nansen.ai/api/v1/profiler/perp-pnl-summary","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"object"},"address":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_73NoGxXmBsPaNLP3BqvhO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a profit and loss summary for a given wallet address on the Hyperliquid perpetuals market over a specified date range","exampleAgentPrompt":"Can you pull the Hyperliquid perp PnL summary for wallet 0x1234567890abcdef1234567890abcdef12345678 for the date range January 1 to March 31 2025?","exampleUseCases":[{"title":"Trader monthly performance review","prompt":"Show me the Hyperliquid perpetuals PnL summary for my wallet 0xabc123def456abc123def456abc123def45678ab for the month of April 2025 — I want to see how my perp trading went."},{"title":"Smart money wallet due diligence","prompt":"I'm researching a wallet I've been following — can you get the Hyperliquid perp PnL summary for 0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef from January 1 to June 30 2025 so I can assess their trading track record?"},{"title":"Portfolio attribution for perp desk","prompt":"Pull the Hyperliquid perp PnL summary for address 0x9999aaaa8888bbbb7777cccc6666dddd5555eeee covering Q1 2025 — I need to attribute profits from our perpetual positions for the quarterly report."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:53.919Z","isFirstParty":false}