{"uid":"cap_QftUIazDsJkcVn85JYkhS","slug":"true402-whale-swaps-feed-fdd9f1f3","name":"true402 Whale Swaps Feed","description":"The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.","url":"https://true402.dev/api/v1/base/whale-swaps","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"dex":{"enum":["uniswap-v3","aerodrome"],"type":"string","description":"Filter: 'uniswap-v3' | 'aerodrome'"},"min":{"type":"number","description":"Only swaps of at least this USD size (default 10000)"},"limit":{"type":"number","description":"Max swaps (1–200, default 50)"},"since":{"type":"number","description":"Only swaps at or after this block"},"direction":{"enum":["buy","sell"],"type":"string","description":"Filter: 'buy' | 'sell' (of the non-quote token)"}}},"responseSchema":{"type":"object","properties":{"chain":{"type":"string"},"count":{"type":"number"},"swaps":{"type":"array","description":"dex, pool, token, quote (WETH/USDC), usdValue, direction (buy/sell of the token), amountQuote, block, ageBlocks, ageSecondsApprox, txHash"},"latestBlock":{"type":"number","description":"Highest block the watcher has indexed"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BBhVlmAz7nxykHwpZLGPq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent large on-chain token swaps (whale trades) filtered by DEX, minimum USD size, direction, and block range","exampleAgentPrompt":"Show me the last 100 whale swaps on Uniswap v3 where someone bought at least $50,000 worth, starting from block 20000000.","exampleUseCases":null,"resultDescription":"A list of whale swap records matching the filters, each likely containing swap size in USD, DEX name, token pair, direction (buy/sell), and block number — up to the specified limit.","failureModes":["Invalid DEX value (not 'uniswap-v3' or 'aerodrome') returns error","Limit outside 1–200 range may return validation error","Invalid or future block number in 'since' returns empty or error","Payment failure (HTTP 402) if wallet has insufficient USDC balance","Network or indexer downtime returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need real-time or recent on-chain large-trade data from Uniswap v3 or Aerodrome, especially for whale-tracking, market sentiment, or DeFi arbitrage signal use cases. Prefer this over CEX trade feeds when you specifically need DEX on-chain swap data with block-level granularity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:55:34.686Z","isFirstParty":false}