{"uid":"cap_xDI5Wy3sdmoInmocHaz8f","slug":"x402-ottoai-services-3f9cf2c9","name":"Hyperliquid Perpetual Trading History","description":"Hyperliquid perpetual trading history: fills, funding payments, and realized PnL per position.","url":"https://x402.ottoai.services/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_so9-SfiRY_Uab_rKoniXB","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 fills, funding payments, and realized PnL history for a given wallet address on Hyperliquid perpetuals.","exampleAgentPrompt":"Pull up the full Hyperliquid perpetuals trading history for wallet 0xAbC123...def — I want to see all my fills, funding payments, and realized PnL per position.","exampleUseCases":[{"title":"Calculate trading performance for tax reporting","prompt":"I need to prepare my tax documents for Hyperliquid trading this year. Can you pull my complete trading history including all fills, funding payments, and realized PnL for wallet 0x742d35Cc6634C0532925a3b844Bc7e7595f42...?"},{"title":"Audit realized losses across positions","prompt":"Show me every position I've closed on Hyperliquid and break down which ones lost money. I want to see the realized PnL for each trade along with any funding payments I paid out on wallet 0x8f39c6a3B91F17Bc8345e8f..."},{"title":"Track funding income from perpetuals","prompt":"How much have I earned just from funding payments on my Hyperliquid account at 0x5e4d2c8B9a3F1E6c7d2a9... over the last month? Show me all the funding I've received and subtract anything I've paid."}],"resultDescription":"Returns an array of historical trading events for the given wallet on Hyperliquid, including trade fills (entry/exit executions), funding payments received or paid, and realized profit and loss broken down per position.","failureModes":["Missing or invalid wallet address returns an error","Wallet address with no Hyperliquid activity returns an empty history array","Malformed EVM address format causes a validation error","Payment not included or insufficient USDC results in a 402 response","Hyperliquid API downtime may cause delayed or failed responses"],"whenToPreferThis":"Use this endpoint when you need historical perpetuals trading data for a specific Hyperliquid wallet, including fills, funding payments, and realized PnL. Prefer this over general portfolio endpoints when the user specifically wants perp trading activity rather than current balances. Ideal for performance analysis, tax reporting, or auditing trading history on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:46:25.357Z","isFirstParty":false}