{"uid":"cap_kkXIlHUaHhukVRj8WIOKr","slug":"x402-trading-useotto-xyz-c69fde89","name":"Hyperliquid Perpetual Trading History","description":"Hyperliquid perpetual trading history including fills, funding payments, and PnL","url":"https://x402-trading.useotto.xyz/hl-transaction-history","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","description":"EVM wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"status":{"type":"string"},"history":{"type":"array"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ao3jutuGg_xV967AR1Obp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical trading activity for a Hyperliquid perpetual account, including fills, funding payments, and PnL, given a wallet address.","exampleAgentPrompt":"Pull up all the Hyperliquid perpetual trading history for wallet address 0xAbC123...including my fills, funding payments, and PnL.","exampleUseCases":[{"title":"Analyze trading performance across positions","prompt":"Can you show me all my fills and PnL history on Hyperliquid for wallet 0x742d35Cc6634C0532925a3b844Bc9e7595f42e7b so I can see which trades were profitable?"},{"title":"Track cumulative funding rate earnings","prompt":"Pull up the complete funding payment history for my Hyperliquid perpetual account at 0x1234567890abcdef to calculate my total funding income over the last few months."},{"title":"Audit all perpetual trading activity","prompt":"I need a full audit trail of every trade executed on Hyperliquid for address 0x9876543210fedcba—can you get me the complete transaction history with all fills, exits, and PnL details?"}],"resultDescription":"Returns a history array containing the wallet's Hyperliquid perpetual trading activity, including executed fills (trade entries/exits), funding payments made or received, and profit and loss figures across positions.","failureModes":["Missing or invalid EVM wallet address returns an error","Address with no Hyperliquid activity returns an empty history array","Malformed address format causes request rejection","Network or upstream Hyperliquid API unavailability causes timeout or error","Payment failure via x402 protocol prevents data retrieval"],"whenToPreferThis":"Use this endpoint when you need historical trading data specifically from Hyperliquid perpetuals for a given wallet address, including fills, funding, and PnL. Prefer this over generic portfolio endpoints when the user wants a detailed audit trail of perp trades rather than a current snapshot of positions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:36:01.205Z","isFirstParty":false}