{"uid":"cap_U9RHidsNxTMBILCMNBjSM","slug":"vextorium-hyperliquid-trades-9b650d5a","name":"Vextorium Hyperliquid Trades","description":"Latest trades executed by any wallet on Hyperliquid: asset, side, open/close direction, price, size, USD value, realized PnL and fee, with totals. Track a trader or audit a bot.","url":"https://api.vextorium.com/v1/hyperliquid-trades?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["wallet"],"properties":{"limit":{"type":"integer","description":"Trades (1-200, default 30)"},"wallet":{"type":"string"},"currency":{"type":"string","description":"Only this asset (optional)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"detail":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"fee":{"type":["null","number"]},"date":{"type":["null","string"]},"side":{"type":["null","string"]},"size":{"type":["null","number"]},"asset":{"type":["null","string"]},"price":{"type":["null","number"]},"address":{"type":["null","string"]},"value_usd":{"type":["null","number"]},"realized_pnl_usd":{"type":["null","number"]}}}},"source":{"type":["string","null"]},"trades":{"type":["number","null"]},"wallet":{"type":["string","null"]},"total_fees":{"type":["number","null"]},"volume_usd":{"type":["number","null"]},"total_realized_pnl_usd":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"detail":[{"fee":0,"date":"2026-10-02T15:13:44+00:00","side":"buy","size":0.1576,"asset":"ETH","price":2705.5,"address":"Open Long","value_usd":426.39,"realized_pnl_usd":0},{"fee":0,"date":"2026-10-02T15:13:44+00:00","side":"sell","size":871,"asset":"BLUR","price":0.021368,"address":"Close Long","value_usd":18.61,"realized_pnl_usd":-0.266526}],"source":"Hyperliquid (open data)","trades":5,"wallet":"0x010461c14e146ac35fe42271bdc1134ee31c703a","total_fees":0,"volume_usd":517.16,"total_realized_pnl_usd":-0.73}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f2BzXbjzWuxbWaW1PyTOF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves recent trade history for a Hyperliquid wallet address, including per-trade details, fees, volume, and realized PnL.","exampleAgentPrompt":"Pull the last 50 Hyperliquid trades for wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a and give me the total volume, total fees, and realized PnL — filter to ETH trades only.","exampleUseCases":[{"title":"Trader profitability analysis","prompt":"Look up the last 100 Hyperliquid trades for 0x010461c14e146ac35fe42271bdc1134ee31c703a and tell me their total realized PnL and how much they paid in fees."},{"title":"Per-asset trade filtering","prompt":"Show me only the BLUR trades made by Hyperliquid wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a — I want to see size, price, and whether each was a win or loss."},{"title":"Copy-trading due diligence","prompt":"I'm considering copy-trading this wallet on Hyperliquid: 0x010461c14e146ac35fe42271bdc1134ee31c703a. Can you fetch their last 200 trades and summarize their win rate and total volume?"}],"resultDescription":"Returns a JSON object with a list of up to 200 individual trades (each with date, side, asset, price, size, USD value, fee, realized PnL, and position label), plus aggregate stats: total trade count, total volume in USD, total fees paid, and total realized PnL in USD. Also includes the source attribution and wallet address echo.","failureModes":["Invalid or unrecognized wallet address returns an error or empty result","Limit outside 1-200 range may be rejected or clamped","Currency filter that matches no trades returns an empty detail array","Network or Hyperliquid data availability issues may cause timeouts","Payment failure (insufficient USDC balance) blocks the request"],"whenToPreferThis":"Use this endpoint when you need granular, per-trade Hyperliquid perpetuals history for a specific wallet — including realized PnL, fees, and asset breakdown. Prefer it over generic DeFi endpoints when the user's question is specifically about Hyperliquid trading activity, or when you need realized PnL data that on-chain DEX aggregators don't provide for perpetuals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:51:56.434Z","isFirstParty":false,"canonicalSlug":"vextorium-hyperliquid-trades-9b650d5a"}