{"uid":"cap_4YbZs-I_5bmU-NHLWjKda","slug":"hyperextend-trades-history-9de42d9f","name":"Hyperextend Trades History","description":"Per-minute Hyperliquid market history: open interest, candles, trades, liquidations, HIP-3, spot and outcome markets. Query any window, pay per request over x402.","url":"https://api.hyperextend.xyz/v1/trades/%7Bcoin%7D","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","required":["coin"],"properties":{"coin":{"type":"string","description":"Asset symbol, e.g. BTC"}}},"queryParams":{"type":"object","required":[],"properties":{"end":{"type":"integer"},"start":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"px":"42000.0","sz":"0.5","tid":859758437920209,"coin":"BTC","hash":"0xa2f9738770fb57c6a473043cd486820204b5006d0bfe769846c21eda2fff31b1","side":"A","time":1700000000123,"users":["0xf513d3489017dea4e04c6a11cc62ec360054d7c6","0x1a2e6afa298b1cc50939b4b2b0b430e3c1ef3459"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.016","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.016/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.031","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.031","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tim59DgJ4QhrifVnNLnPX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.031","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-minute trade history (price, size, side, hash, users) for a given Hyperliquid asset over a specified time window","exampleAgentPrompt":"Pull all BTC trades on Hyperliquid from the last hour — I want to see price, size, side (buy/sell), and which wallet addresses were involved.","exampleUseCases":null,"resultDescription":"Returns an array of trade records for the requested coin, each containing: trade price (px), size (sz), trade ID (tid), coin symbol, transaction hash, side (A or B indicating buyer/seller), timestamp in milliseconds, and an array of two user wallet addresses involved in the trade.","failureModes":["Invalid or unsupported coin symbol returns 404 or empty result","Start/end timestamps out of valid range may return empty array","Malformed path parameter causes 400 error","Missing x402 payment header causes 402 Payment Required response","Very large time windows may return truncated or paginated results","Network timeout if querying extremely dense trading periods"],"whenToPreferThis":"Use this endpoint when you need raw trade-level data (individual fills) for a Hyperliquid perpetual or spot asset, including price, size, direction, and wallet addresses. Prefer this over candle/OHLCV endpoints when you need tick-level granularity or want to analyze individual trade events, not aggregated price bars. Choose this over open interest or funding endpoints when your goal is to examine actual executed trades rather than market state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:29.367Z","isFirstParty":false}