{"uid":"cap_k67H21P3Qs6IRQkoviNmf","slug":"hyperextend-raw-market-trades-btc-db77be99","name":"Hyperextend Raw Market Trades (BTC)","description":"Raw market trades over a time window — the live hot tier (~24h) plus S3 read-through for older history (archive from 2025-05-25), merged. Each row mirrors HL's WsTrade verbatim, including the buyer/seller addresses (`users`) and the trade `hash`. Priced per asset-hour ($0.015 base, $0.03 HIP-3/HIP-4) plus $0.05 per uncached archive hour pulled (warms the cache); ≤24 asset-hours/request.","url":"https://api.hyperextend.xyz/v1/trades/BTC","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":null,"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_EjmahuEAphetaT_BSP_RA","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 raw market trade records for a given asset over a specified time window, merging live hot-tier data with S3-archived history, mirroring Hyperliquid's WsTrade format including buyer/seller addresses and trade hashes.","exampleAgentPrompt":"Pull all raw BTC trades on Hyperliquid from the last 6 hours, including the buyer and seller wallet addresses and trade hashes.","exampleUseCases":null,"resultDescription":"A list of trade rows in Hyperliquid WsTrade format, each containing the asset, trade price, size, timestamp, buyer address, seller address, and trade hash. Data is merged from the live hot tier and S3 archive for the requested time window.","failureModes":["Invalid or unsupported coin symbol returns an error or empty result","start/end timestamps outside the available archive range may return partial data","Requesting more than 24 asset-hours in a single call exceeds the limit and may be rejected","Uncached archive hours incur additional cost and may increase latency","Payment failure or insufficient USDC balance prevents call execution","Missing required path parameter (coin) causes a 400-level error"],"whenToPreferThis":"Use this endpoint when you need raw, tick-level trade data for a specific Hyperliquid asset including full counterparty wallet addresses and trade hashes. Prefer this over OHLCV candle endpoints when you need individual trade granularity rather than aggregated price bars. Best for on-chain trade auditing, wallet-level analysis, or reconstructing exact order flow over a time window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:28.488Z","isFirstParty":false}