{"uid":"cap_NSS94uTweCw9jVwV9a0rO","slug":"hyperliquid-account-portfolio-history-ada7f1c8","name":"Hyperliquid Account Portfolio History","description":"A Hyperliquid account's historical account value and PnL across day/week/month/all-time windows, for any 0x address.","url":"https://hyperliquid-accounts.use.x402atlas.com/portfolio","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"0x-prefixed 20-byte Hyperliquid account address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","address","portfolio"],"properties":{"address":{"type":"string","description":"Lower-cased account address queried"},"portfolio":{"type":"array","items":{"type":"array"},"description":"Upstream Hyperliquid portfolio payload relayed verbatim — a positional array of [period, series] pairs (day/week/month/allTime), each series holding account value and PnL points over time"},"queried_at":{"type":"string","format":"date-time","description":"Time the upstream was queried"}}}}}}},"responseSchema":{"type":"json","example":{"address":"0x0000000000000000000000000000000000000000","portfolio":[],"queried_at":"2026-07-10T12:00:00Z"}},"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_R-569Zen4gZ1-D14RdUDk","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 historical account value and PnL for a Hyperliquid address across day, week, month, and all-time windows.","exampleAgentPrompt":"Pull the Hyperliquid portfolio history for wallet 0x1234567890abcdef1234567890abcdef12345678 — I want to see the account value and PnL across the day, week, month, and all-time windows.","exampleUseCases":[{"title":"Monitor trader performance leaderboard","prompt":"I'm building a leaderboard of top Hyperliquid traders. Can you grab the historical PnL for these wallet addresses so I can rank them by their monthly and all-time returns?"},{"title":"Alert on account drawdown threshold","prompt":"Watch this Hyperliquid wallet's account value over the past week and let me know if the PnL has dropped below 10% — I need to flag risky positions."},{"title":"Compare portfolio performance across periods","prompt":"Pull the account history for my Hyperliquid wallet and compare how my returns look across the day, week, and month. I want to see if I'm trending up or down lately."}],"resultDescription":"A JSON object containing the queried wallet address, the timestamp of the query, and a portfolio array of [period, series] pairs for four time windows (day, week, month, allTime), each series holding account value and PnL data points over time as relayed verbatim from Hyperliquid's upstream API.","failureModes":["Invalid or malformed 0x address returns a validation error","Address with no Hyperliquid activity may return empty portfolio arrays","Upstream Hyperliquid API unavailability causes a 502/503 response","Missing required 'address' query parameter returns a 400 error","Payment not included or insufficient results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need historical account value or PnL data for a specific Hyperliquid wallet across standard time windows. Prefer this over sibling endpoints when the goal is performance analysis or portfolio tracking over time, rather than current open positions, spot balances, staking summary, or recent fills.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:23.265Z","isFirstParty":false}