{"uid":"cap_k3KlKJfn9V9s9zFbQd1eQ","slug":"tradesonar-large-trades-whale-fills-201a8e91","name":"TradeSonar Large Trades (Whale Fills)","description":"Large trades (whale-sized fills)","url":"https://api.tradesonar.io/v1/markets/:ticker/large-trades?utm_source=zero.xyz","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":["ticker"],"properties":{"ticker":{"type":"string","description":"Market ticker, e.g. BTC-USD (NOT BTC-USDT). See /v1/markets for valid tickers."}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":100,"maximum":500,"minimum":1},"lookback_min":{"type":"integer","default":60,"maximum":1440,"minimum":1,"description":"Lookback window in minutes"},"min_notional":{"type":"number","default":50000,"description":"Minimum trade notional in USD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0zBRnKIoqQCwJErqWGirR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns large on-chain trades (whale-sized fills) for a given dYdX market ticker within a configurable lookback window and notional threshold","exampleAgentPrompt":"Show me all whale-sized fills on BTC-USD from the last 60 minutes where the notional was at least $100,000 — pull up to 200 trades.","exampleUseCases":[{"title":"Whale alert for crypto trading bot","prompt":"Check BTC-USD on TradeSonar for any large trades above $250,000 notional in the last 30 minutes and tell me if there's unusual whale activity I should act on."},{"title":"Smart money flow analysis before entry","prompt":"Before I enter a position on ETH-USD, pull the last 90 minutes of dYdX large fills above $50,000 notional so I can see which direction the big players have been trading."},{"title":"Post-market whale activity review","prompt":"Give me a summary of the largest trades on SOL-USD over the past 4 hours — filter for anything above $100,000 notional and show up to 500 fills."}],"resultDescription":"A list of whale-sized trade fills for the specified market, each record containing details such as trade size, notional value in USD, direction, and timestamp. Results are bounded by the requested lookback window (up to 1440 minutes), minimum notional threshold, and record limit (up to 500).","failureModes":["Invalid ticker format (e.g. using BTC-USDT instead of BTC-USD) returns an error — use /v1/markets to validate tickers","lookback_min exceeding 1440 or below 1 returns a validation error","limit exceeding 500 returns a validation error","No trades found matching filters returns an empty list","Network or payment authentication failure returns a 402 or 5xx error"],"whenToPreferThis":"Use this endpoint when you specifically need to identify large institutional or whale-sized fills on dYdX perpetual markets. It is distinct from general candlestick or order book data because it surfaces individual large trades above a configurable notional threshold, making it ideal for smart money flow analysis, whale tracking, and market impact detection. Prefer it over general OHLCV endpoints when trade-level granularity and notional size filtering matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:30:39.768Z","isFirstParty":false,"canonicalSlug":"tradesonar-large-trades-whale-fills-201a8e91"}