{"uid":"cap_BMeOeEDZoDOQPFlzEsLJr","slug":"agents-x402stock-xyz-hyperliquid-perp-dex-trade-fill-history-by-wallet-779efe00","name":"Hyperliquid Perp DEX Trade Fill History by Wallet","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","required":["address"],"properties":{"limit":{"type":"integer","default":50,"maximum":200,"exclusiveMinimum":0},"address":{"type":"string","description":"Solana account address (base58)."}}},"responseSchema":{"type":"object","required":["source","as_of","venue","market","address","count","fills"],"properties":{"as_of":{"type":"string"},"count":{"type":"number"},"fills":{"type":"array","items":{"type":"object","required":["time","coin","side","direction","price","size","start_position","closed_pnl","fee","fee_token","crossed","order_id","hash"],"properties":{"fee":{"anyOf":[{"type":"number"},{"type":"null"}]},"coin":{"type":"string"},"hash":{"type":"string"},"side":{"anyOf":[{"enum":["buy","sell"],"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"time":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"crossed":{"type":"boolean"},"order_id":{"type":"number"},"direction":{"type":"string"},"fee_token":{"type":"string"},"closed_pnl":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_position":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"venue":{"type":"string"},"market":{"type":"string","const":"perp"},"source":{"type":"string","const":"x402stock"},"address":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WBpc-yuRnx8kdvhBhWHKC","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns paginated executed trade fill history for any wallet address on the Hyperliquid perpetuals DEX, including side, direction, price, size, PnL, and fees.","exampleAgentPrompt":"Pull the last 100 trade fills for Hyperliquid perp wallet 0x1234abcd... and show me the coin, direction, price, size, and closed PnL for each.","exampleUseCases":[{"title":"Trader PnL audit on Hyperliquid","prompt":"Get the most recent 200 fills for Hyperliquid perp address 0xDEAD...BEEF and calculate the total closed PnL across all trades."},{"title":"Monitoring a whale's perp activity","prompt":"Check what perpetuals trades wallet 0xABCD...1234 has executed on Hyperliquid in the last batch of 50 fills — I want to see which coins they're trading and which direction."},{"title":"Fee analysis for a specific trader","prompt":"Fetch the last 50 fills for 0x9876...FEDC on Hyperliquid perps and tell me how much total fees they've paid and in what token."}],"resultDescription":"Returns a JSON object containing the wallet address, venue, market type (perp), timestamp of data, fill count, and an array of fill objects — each with time, coin, buy/sell side, open/close direction, price, size, starting position, closed PnL, fee, fee token, crossed flag, order ID, and transaction hash. Fills are sorted most-recent first.","failureModes":["Invalid or malformed 0x wallet address returns an error or empty fills array","limit parameter exceeding 200 is rejected","Unknown or inactive wallet address returns count=0 with an empty fills array","Network or upstream Hyperliquid API unavailability causes a 5xx error","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need executed trade history (fills) for a specific wallet on the Hyperliquid perpetuals DEX — especially when you need per-trade details like closed PnL, fee breakdown, direction, and order IDs. Prefer this over generic block explorers when you want structured, normalized fill data without parsing raw chain state. No API key required; suitable for autonomous agent workflows paying per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T12:46:30.120Z","isFirstParty":false}