{"uid":"cap_mn0nVy1YVFy1cCxBwWN3b","slug":"pa1m-hyperliquid-history-8c2c749c","name":"Pa1m Hyperliquid History","description":"Real-time Hyperliquid perpetuals data for AI agents.","url":"https://hyperliquid.hypa1m.xyz/history/%7Baddress%7D?utm_source=zero.xyz","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_nYXOTRXbzYTYWuCwz_TdZ","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":"Retrieves historical perpetuals position and margin data for a given Hyperliquid wallet address","exampleAgentPrompt":"Pull the perpetuals position history and margin summary for Hyperliquid wallet address 0xAbC123... so I can see what trades they've made.","exampleUseCases":[{"title":"Audit a trader's perp history","prompt":"Show me all the historical perpetuals positions and margin summary for Hyperliquid address 0x1234abcd... — I want to audit what trades this wallet has made."},{"title":"Monitor portfolio margin health","prompt":"Fetch the current margin summary and open positions on Hyperliquid for my wallet 0xdeadbeef... so I can see if I'm at risk of liquidation."},{"title":"Research a whale wallet's activity","prompt":"Look up the full perpetuals trading history on Hyperliquid for address 0x9999aaaa... — I'm trying to understand what positions this whale has been running."}],"resultDescription":"Returns a JSON object containing a list of perpetual positions (with details like asset, size, entry price, PnL) and a margin summary (including account value, margin usage, and unrealized PnL) for the queried wallet address.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Address with no Hyperliquid activity returns empty positions array and empty marginSummary","Payment failure (402) if USDC micropayment is not correctly attached","Rate limiting or timeout if Hyperliquid's underlying API is unavailable","Non-existent address may return empty data rather than an explicit error"],"whenToPreferThis":"Use this endpoint when you need on-chain perpetuals position and margin history for a specific Hyperliquid wallet address, especially in DeFi analytics, portfolio monitoring, or trader research workflows. Prefer this over general blockchain explorers when you specifically want Hyperliquid perp data in a structured, AI-ready format with micropayment access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:30:37.022Z","isFirstParty":false,"canonicalSlug":"pa1m-hyperliquid-history-8c2c749c"}