{"uid":"cap_9rLzGyFEocPHpJLZIDfh9","slug":"ethereum-erc-20-whale-large-trade-tracker-4ef9c96b","name":"Ethereum ERC-20 Whale & Large-Trade Tracker","description":"Whale and large-trade tracker for an ERC-20 on Ethereum: every buy and sell in the last N minutes on the token's deepest WETH/USDC pools (Uniswap v3), with USD size, side, wallet and transaction for the largest trades, buy/sell volume and net flow, and the wallets that bought or sold the most.","url":"https://onchaincheck.dev/eth/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"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"limit":{"type":"string","pattern":"^\\d{1,2}$","description":"Max trades listed, 1 to 40, default 20"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Token contract address on Ethereum"},"minUsd":{"type":"string","pattern":"^\\d+(\\.\\d+)?$","description":"Only list trades at least this large in USD, default 1000"},"minutes":{"type":"string","pattern":"^\\d{1,3}$","description":"Look-back window in minutes; 5 to 240, default 60 (capped at 12,000 blocks, about 50 minutes on Arbitrum)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"eth","notes":"Trades from the 3 deepest WETH/USDC pools; other pairs and aggregator-internal routes are not counted. Wallets are transaction senders, looked up for the 40 largest trades.","token":{"symbol":"UNI","address":"0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984","decimals":18},"window":{"to":"2026-10-22T16:22:59.000Z","from":"2026-10-22T15:22:59.000Z","minutes":60,"toBlock":26249326,"fromBlock":26249026},"summary":{"buys":7,"sells":22,"trades":29,"netFlowUsd":-62919.8,"buyVolumeUsd":775.696,"sellVolumeUsd":63695.5,"largestTradeUsd":12127.7},"nativeUsd":2399.99,"topBuyers":[{"netUsd":333.4,"trades":1,"wallet":"0xFE272453cdBE33969155E54F5EAa9267bEEaa496","soldUsd":0,"boughtUsd":333.4},{"netUsd":192.4,"trades":1,"wallet":"0xF2448FF6E5E68a8Ef70B62d9f7dfE3C43253A1F5","soldUsd":0,"boughtUsd":192.4},{"netUsd":98,"trades":1,"wallet":"0x124Ae9d407c6644688F6A667D6a205f26AC36b30","soldUsd":0,"boughtUsd":98},{"netUsd":88.86,"trades":1,"wallet":"0x5f73CfaCb6e225266946feE476A8b20902154565","soldUsd":0,"boughtUsd":88.86},{"netUsd":41.09,"trades":1,"wallet":"0x544B0538C070C9B0872A1C34e124F088a3865aF3","soldUsd":0,"boughtUsd":41.09}],"topSellers":[{"netUsd":-14380,"trades":5,"wallet":"0x5B43453FCE04b92E190f391a83136bfBeCEDEFd1","soldUsd":14380,"boughtUsd":0},{"netUsd":-12130,"trades":1,"wallet":"0xd5a809D6dbEe62A34Cf4106080C6e04B8d9ce285","soldUsd":12130,"boughtUsd":0},{"netUsd":-8849,"trades":1,"wallet":"0x8357eFA84F91013Bd6b285eF0f6b93C211cC3d9d","soldUsd":8849,"boughtUsd":0},{"netUsd":-7432,"trades":1,"wallet":"0x05a94A8Dd7eb1ba5b1114CC5eF18855A221Ac317","soldUsd":7432,"boughtUsd":0},{"netUsd":-5504,"trades":1,"wallet":"0x8bBe5D78bE45931Cf4815D8A00bf38c3DDD36782","soldUsd":5504,"boughtUsd":0}],"largeTrades":[{"tx":"0x254948fa1fc779edf4268e84b804fffefe7dd32db455779c54ad78f349b7b0cd","dex":"uniswap-v3","usd":12127.7,"side":"sell","block":26249063,"wallet":"0xd5a809D6dbEe62A34Cf4106080C6e04B8d9ce285","approxTime":"2026-10-22T15:30:23.000Z","quoteAmount":5.0532446,"quoteSymbol":"WETH","tokenAmount":1716.8438},{"tx":"0xdb57be14caada6f93d3342bdaf96bf15eb30f17bdadfe2aa5f2caf356f61d3fa","dex":"uniswap-v3","usd":8849.27,"side":"sell","block":26249269,"wallet":"0x8357eFA84F91013Bd6b285eF0f6b93C211cC3d9d","approxTime":"2026-10-22T16:11:35.000Z","quoteAmount":3.6872074,"quoteSymbol":"WETH","tokenAmount":1255.6263},{"tx":"0x8cc47225f61cc51a395adefc1ab74ff5a304f2d65a9cbed34524aba228010564","dex":"uniswap-v3","usd":7431.89,"side":"sell","block":26249322,"wallet":"0x05a94A8Dd7eb1ba5b1114CC5eF18855A221Ac317","approxTime":"2026-10-22T16:22:11.000Z","quoteAmount":3.0966311,"quoteSymbol":"WETH","tokenAmount":1056.3754},{"tx":"0xf087fc7262fd6a0902d311486ebd012b8bbf40711da818d3cf9f83e37f2a8aca","dex":"uniswap-v3","usd":6281.59,"side":"sell","block":26249066,"wallet":"0x5B43453FCE04b92E190f391a83136bfBeCEDEFd1","approxTime":"2026-10-22T15:30:59.000Z","quoteAmount":2.6173378,"quoteSymbol":"WETH","tokenAmount":889.86901},{"tx":"0x41df3a253d1d138fac757efa1cabb7ae3f16f2ff715273513436258f438b98ee","dex":"uniswap-v3","usd":5503.92,"side":"sell","block":26249291,"wallet":"0x8bBe5D78bE45931Cf4815D8A00bf38c3DDD36782","approxTime":"2026-10-22T16:15:59.000Z","quoteAmount":2.2933067,"quoteSymbol":"WETH","tokenAmount":781.38876}],"poolsScanned":[{"dex":"uniswap-v3","pool":"0x1d42064Fc4Beb5F8aAF85F4617AE8b3b5B8Bd801","pairedWith":"WETH"},{"dex":"uniswap-v3","pool":"0xfaA318479b7755b2dBfDD34dC306cb28B420Ad12","pairedWith":"WETH"},{"dex":"uniswap-v3","pool":"0x360b9726186C0F62cc719450685ce70280774Dc8","pairedWith":"WETH"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_X_cz2y5InotyDv_dxwDdB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns buy/sell trades, volume, net flow, and top whale wallets for an ERC-20 token on Ethereum Uniswap v3 WETH/USDC pools over a configurable look-back window.","exampleAgentPrompt":"Show me all large trades (over $5,000) for the UNI token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum in the last 60 minutes — I want to see the top whale buyers and sellers and the net flow.","exampleUseCases":[{"title":"Whale dump alert before trading","prompt":"I'm about to buy some PEPE tokens at 0x6982508145454Ce325dDbE47a25d4ec3d2311933 — can you first check if any big wallets have been selling heavily in the last 30 minutes on Ethereum? Show me trades over $2,000."},{"title":"Net flow sentiment check for DeFi token","prompt":"What's the overall buy vs sell pressure on the UNI token (0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984) on Ethereum over the past 2 hours? I want to know the net flow and total volume on Uniswap v3."},{"title":"Identify top accumulating wallets","prompt":"Which wallets bought the most of the LINK token at 0x514910771AF9Ca656af840dff83E8264EcF986CA on Ethereum in the last 45 minutes, and how much did they spend? Show me up to 10 of the largest trades."}],"resultDescription":"A JSON object containing: token metadata (symbol, address, decimals), the query window (from/to timestamps, block range, minutes), a summary (buy count, sell count, total trades, buy volume USD, sell volume USD, net flow USD, largest trade USD), a list of large individual trades (with tx hash, DEX, USD size, side, block, wallet, approx time), top buyer wallets ranked by USD bought, top seller wallets ranked by USD sold, and the current ETH/USD price. Notes clarify that only the 3 deepest WETH/USDC Uniswap v3 pools are included.","failureModes":["Invalid or non-Ethereum token address returns an error or empty result","Token has no WETH/USDC Uniswap v3 pools — returns empty trades with a note","minutes parameter outside 5–240 range may be capped or rejected","No trades in the window returns summary with zeroes and empty arrays","Payment failure (402) if x402 USDC payment not provided","Rate limiting or node unavailability may cause transient 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need real-time on-chain trade intelligence for a specific ERC-20 token on Ethereum Mainnet, specifically from Uniswap v3 WETH/USDC pools. It is ideal for whale monitoring, sentiment analysis via net flow, or identifying large individual transactions by wallet. Prefer it over generic DEX screeners when you need wallet-level attribution and structured buy/sell summaries for agent-driven trading decisions or alerts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:32.857Z","isFirstParty":false,"canonicalSlug":"ethereum-erc-20-whale-large-trade-tracker-4ef9c96b"}