{"uid":"cap_ifZPc0qhcLw0DVQgqQSh5","slug":"annalist-hlp-vault-state-8fe03951","name":"Annalist HLP Vault State","description":"Signed data for AI agents, paid per call over x402. Hyperliquid crowd state, smart money and liquidations with what historically happened next, plus independent checks of x402 services and MCP servers.","url":"https://api.annalist.dev/v1/vaults/hlp?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"apr":0.03,"net_usd":-12000000,"most_short":[{"coin":"BTC","net_usd":-8000000}],"account_value_usd":380000000}}},"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_4If3OV9QmuLKXKDLZinAP","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 current Hyperliquid HLP vault metrics including APR, net USD exposure, largest short positions, and account value — signed data delivered via x402 micropayment.","exampleAgentPrompt":"What does the Hyperliquid HLP vault look like right now — what's the APR, total account value, and which coin has the biggest short position?","exampleUseCases":[{"title":"Monitor HLP vault yield and exposure","prompt":"Check the current APR and net USD position on the Hyperliquid HLP vault and let me know if the vault is heavily short any single coin."},{"title":"Crypto trading desk market brief","prompt":"Pull the latest HLP vault data — I need the account value, net exposure in USD, and the top short positions so I can factor crowd positioning into my trade today."},{"title":"Automated DeFi portfolio alert","prompt":"Get me the current HLP vault state including APR and largest short positions — I want to know if the net USD position has gone more negative than negative $15 million."}],"resultDescription":"Returns a JSON object with: apr (annual percentage rate as a decimal), net_usd (net dollar exposure, negative = net short), most_short (array of coin symbols and their net USD short exposure), and account_value_usd (total vault AUM). Data is cryptographically signed by Annalist for agent verifiability.","failureModes":["402 Payment Required if x402 payment header is missing or insufficient — must include 0.01 USDC payment","Stale data if Hyperliquid API is temporarily unavailable upstream","Invalid or malformed response if the vault identifier is incorrect","Network timeout if Annalist infrastructure is under load"],"whenToPreferThis":"Choose this endpoint when you need real-time, signed Hyperliquid HLP vault metrics — particularly APR, net positioning, and top short exposure — and require cryptographic proof of data integrity for agent workflows. Prefer this over scraping Hyperliquid directly when you need verifiable, pay-per-call data in an agentic pipeline that already handles x402 micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:44:29.128Z","isFirstParty":false,"canonicalSlug":"annalist-hlp-vault-state-8fe03951"}