{"uid":"cap_NOT7JKblP416nNI4Dk66e","slug":"tradesonar-whale-flow-events-3a70de0d","name":"TradeSonar Whale Flow Events","description":"Smart-money flow (open/close/increase/decrease/flip events)","url":"https://api.tradesonar.io/v1/whales/flow?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"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":100,"maximum":500,"minimum":1,"description":"Max flow events to return, 1-500"},"since_min":{"type":"integer","default":60,"maximum":1440,"minimum":1,"description":"Lookback window in minutes"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"events":[{"side":"...","time":"...","toUsd":"...","action":"...","ticker":"...","address":"...","fromUsd":"...","classification":"..."}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JlYnRlksoyOmTElB2kJqE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time-windowed stream of large on-chain dYdX order flow events attributed to smart-money/whale addresses, with classification and directional metadata.","exampleAgentPrompt":"Pull the last 60 minutes of whale flow events from TradeSonar on dYdX — give me up to 200 events so I can see which direction smart money is trading and which addresses are moving big size.","exampleUseCases":[{"title":"Pre-trade smart money direction check","prompt":"Before I open a BTC-USD perp position, check TradeSonar for the last 30 minutes of whale flow on dYdX — are big wallets net buying or selling? Show me up to 100 events."},{"title":"Unusual large-trade alert for a trading bot","prompt":"Every 5 minutes, grab the last 5 minutes of dYdX whale flow from TradeSonar with up to 50 events and alert me if any single address moves more than $500k in one direction."},{"title":"Post-market session whale activity review","prompt":"Give me a full 4-hour lookback of whale flow events on dYdX from TradeSonar — up to 500 events — so I can review what smart money did during the US trading session today."}],"resultDescription":"A JSON array of flow events, each containing the wallet address, ticker, trade side (buy/sell), action type, USD size in and out, classification label (e.g. whale/smart-money tier), and timestamp — plus a data_as_of freshness stamp with block height and replica lag.","failureModes":["Invalid limit value outside 1-500 range returns validation error","since_min exceeding 1440 returns parameter error","Payment not included or insufficient USDC returns 402 Payment Required","Replica lag or indexer downtime may cause stale data_as_of timestamps","Empty events array returned if no whale-sized flow occurred in the requested window"],"whenToPreferThis":"Choose this endpoint when you need raw, event-level whale order flow from dYdX on-chain data with address attribution and classification — as opposed to aggregated long/short ratios (use the crowding endpoint), funding data (use the funding endpoint), or candlestick OHLCV data. Best when you need to identify specific smart-money wallets, their trade direction, and exact USD sizing within a recent time window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:44:42.671Z","isFirstParty":false,"canonicalSlug":"tradesonar-whale-flow-events-3a70de0d"}