{"uid":"cap_prvmTT4fEa1XczIN5TpJc","slug":"x402stock-hyperliquid-perp-dex-fill-history-f658f69d","name":"x402stock Hyperliquid Perp DEX Fill History","description":"Recent fills (executed trade history) for any wallet on the Hyperliquid perp DEX, by 0x address: per fill the time, coin, buy/sell side, direction (open/close long/short), price, size, start position, closed PnL, fee, and order id, most recent first. Tune with `?limit=` (default 50, max 200). Read-only public chain data, no key. Pass the address in the path. From x402stock","url":"https://agents.x402stock.xyz/api/v1/perps/fills/:address","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","address":{"type":"string"}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":200,"exclusiveMinimum":0}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iQWbxAFyZ4d5XFb1EYPJb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paginated executed trade fill history for a given wallet address on the Hyperliquid perpetuals DEX, including price, size, PnL, fees, and direction per fill.","exampleAgentPrompt":"Pull the last 100 trade fills for Hyperliquid perp wallet 0x1234...abcd — I want to see each fill's coin, side, direction, price, size, closed PnL, and fee.","exampleUseCases":[{"title":"Audit a trader's recent perp activity","prompt":"Show me the 50 most recent fills for the Hyperliquid perps wallet 0xAbCd...1234 — I want to see what coins they traded, whether they were opening or closing positions, and what their PnL looked like on each fill."},{"title":"Track fees paid by a wallet","prompt":"How much in fees has the Hyperliquid wallet 0x5678...efab paid across its last 200 fills? Pull the fill history so I can tally it up."},{"title":"Review closed PnL after a volatile session","prompt":"I need to review all the closed PnL entries from the last fills on my Hyperliquid perp wallet 0xDead...Beef — can you fetch up to 200 of them so I can see how I did during today's market move?"}],"resultDescription":"A list of up to 200 executed trade fills for the specified wallet, ordered most-recent-first. Each fill includes: timestamp, coin/asset symbol, buy or sell side, trade direction (open long, close long, open short, close short), fill price, fill size, starting position size, closed PnL, fee paid, and the associated order ID.","failureModes":["Invalid or malformed 0x wallet address returns an error or empty result","Limit parameter exceeds 200 results in a validation error","Wallet with no Hyperliquid perp history returns an empty fills array","Network or upstream Hyperliquid API downtime causes timeout or 5xx error","Payment not processed (x402 protocol failure) results in 402 response"],"whenToPreferThis":"Use this endpoint when you need historical executed fill data (not open orders or positions) for a specific Hyperliquid perpetuals wallet. It is ideal for PnL analysis, fee auditing, trade journaling, or due-diligence on a trader's execution history. It requires only a public 0x wallet address and no API key, making it easy to call for any wallet on-chain. Prefer this over generic DEX data tools when the target is specifically Hyperliquid perp fills.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:12.421Z","isFirstParty":false}