{"uid":"cap_teSsgncPtOWRuk1NFXz5Z","slug":"chainhilt-hyperliquid-portfolio-report-bd2600d7","name":"ChainHilt Hyperliquid Portfolio Report","description":"Produce an agent-ready Hyperliquid portfolio report covering equity, PnL, leverage, margin health, liquidation exposure, and concentration. Errors: 400 invalid input, 502 provider failure. Treat spot and perp as one balance only when the account abstraction mode is \"unifiedAccount\".","url":"https://chainhilt.ai/api/v1/perp/hyperliquid/portfolio/report?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Hyperliquid account address to analyze."},"includeRaw":{"type":"boolean","description":"true to include the raw Hyperliquid payloads in the response."}}},"responseSchema":{"type":"json","example":{"report":{"riskLevel":"moderate","accountValue":"12500.00","withdrawable":"7400.00"}}},"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_LbeMkeArxkYBxKTZEBSa3","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":"Generates a comprehensive agent-ready portfolio report for a Hyperliquid account, covering equity, PnL, leverage, margin health, liquidation exposure, and concentration risk.","exampleAgentPrompt":"Pull a full Hyperliquid portfolio report for address 0xAbC1234567890abcdef1234567890abcdef123456 — I want to see my equity, PnL, leverage, margin health, and liquidation exposure.","exampleUseCases":[{"title":"Pre-trade risk check for perp trader","prompt":"Before I open another position, give me a full portfolio report for my Hyperliquid account 0xAbC1234567890abcdef1234567890abcdef123456 — I need to know my current leverage, margin health, and how close I am to liquidation."},{"title":"Automated daily portfolio health digest","prompt":"Every morning, generate a Hyperliquid portfolio report for 0xAbC1234567890abcdef1234567890abcdef123456 and flag if my risk level is anything other than low — include PnL and concentration breakdown."},{"title":"Withdrawable balance check before transfer","prompt":"How much can I safely withdraw from my Hyperliquid account 0xAbC1234567890abcdef1234567890abcdef123456 right now? Pull the portfolio report and give me the withdrawable amount and overall account value."}],"resultDescription":"Returns a structured JSON portfolio report containing risk level (e.g. 'moderate'), total account value, withdrawable balance, unrealized PnL, leverage metrics, margin health indicators, liquidation exposure, and position concentration data. Optionally includes raw Hyperliquid API payloads if includeRaw is true.","failureModes":["400 Bad Request: invalid or malformed Ethereum address (must match ^0x[a-fA-F0-9]{40}$)","502 Bad Gateway: upstream Hyperliquid provider failure or timeout","Empty or zero-value report if the address has no active positions or account history"],"whenToPreferThis":"Use this endpoint when an agent needs a holistic, pre-parsed risk and portfolio summary for a Hyperliquid account without having to manually aggregate raw on-chain data. Prefer this over raw Hyperliquid API calls when you need risk metrics (margin health, liquidation exposure, concentration) already computed and agent-readable. Best suited for trading bots, risk dashboards, or any workflow that needs to gate actions on portfolio health.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:38:20.248Z","isFirstParty":false,"canonicalSlug":"chainhilt-hyperliquid-portfolio-report-bd2600d7"}