{"uid":"cap_HJzByvcBuEVYaqWHxHhkf","slug":"pa1m-hyperliquid-portfolio-endpoint-ed74d45d","name":"Pa1m Hyperliquid Portfolio Endpoint","description":"Real-time Hyperliquid perpetuals data for AI agents.","url":"https://hyperliquid.hypa1m.xyz/portfolio/%7Baddress%7D","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"EVM wallet address, 0x..."}}}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"positions":[],"marginSummary":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hpueaD2AVCb22DHZtooOA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches real-time perpetuals portfolio data (open positions and margin summary) for a given Hyperliquid wallet address.","exampleAgentPrompt":"What are the current open perpetuals positions and margin summary for Hyperliquid address 0xAbC123...def456?","exampleUseCases":[{"title":"Monitor trader's perpetuals exposure","prompt":"Keep an eye on the Hyperliquid address 0x1234...abcd and tell me what perpetual positions they have open right now and what their margin looks like."},{"title":"Portfolio health check before liquidation risk","prompt":"Check the current margin summary and open perp positions for Hyperliquid wallet 0xDEAD...BEEF — I want to know if they're close to getting liquidated."},{"title":"Analyze whale activity on Hyperliquid","prompt":"Look up the perpetuals portfolio for this Hyperliquid address 0xWhale...1234 and tell me what positions they're holding and their margin balance."}],"resultDescription":"Returns a JSON object containing an array of open perpetual positions and a margin summary object for the queried Hyperliquid wallet address. Positions may be empty if the address has none open; margin summary reflects account-level collateral and equity data.","failureModes":["Invalid or malformed wallet address returns empty positions and margin summary","Non-existent address returns empty data rather than an error","Network or upstream Hyperliquid API downtime may cause 5xx errors","Rate limiting may occur for excessive requests without proper payment","Payment of 0.003 USDC required per call via x402 protocol; failure to pay results in 402 response"],"whenToPreferThis":"Use this endpoint when you need real-time perpetuals portfolio data for a specific Hyperliquid wallet address, including open positions and margin summary. Prefer this over generic blockchain explorers when you specifically need Hyperliquid perp position data rather than spot balances or transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:47:05.582Z","isFirstParty":false}