{"uid":"cap_TbnNE613UyV1TrU-lPQPF","slug":"basewhale-oracle-x402-4a337923","name":"BaseWhale Oracle x402","description":"Real-Time On-Chain Whale & Large Transfer Oracle for Base Mainnet (Chain ID 8453), payable via x402.","url":"https://basewhale-x402.vercel.app/v1/whales","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","title":"WhaleInput","properties":{"limit":{"type":"integer","title":"Limit","default":15,"maximum":100,"minimum":1},"blocks":{"type":"integer","title":"Blocks","default":25,"maximum":50,"minimum":1},"min_usd":{"type":"number","title":"Min Usd","default":25000,"maximum":1000000000000000,"minimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"const":"json"},"example":{"type":"object","title":"WhaleResponse","required":["success","network","tracked_token","valuation_source","source","fetched_at","min_usd_filter","latest_block","blocks_scanned","whale_transactions_found","total_whale_volume_usd","transactions","timestamp"],"properties":{"source":{"type":"string","title":"Source"},"network":{"type":"string","title":"Network"},"success":{"type":"boolean","title":"Success"},"timestamp":{"type":"string","title":"Timestamp"},"fetched_at":{"type":"string","title":"Fetched At"},"latest_block":{"type":"integer","title":"Latest Block"},"transactions":{"type":"array","items":{"type":"object","title":"Transfer","required":["tx_hash","block_number","token","amount_atomic","amount_tokens","amount_usd","from_address","to_address"],"properties":{"token":{"type":"string","title":"Token"},"tx_hash":{"type":"string","title":"Tx Hash"},"amount_usd":{"type":"number","title":"Amount Usd"},"to_address":{"type":"string","title":"To Address"},"block_number":{"type":"integer","title":"Block Number"},"from_address":{"type":"string","title":"From Address"},"amount_atomic":{"type":"string","title":"Amount Atomic"},"amount_tokens":{"type":"number","title":"Amount Tokens"}}},"title":"Transactions"},"tracked_token":{"type":"string","title":"Tracked Token"},"blocks_scanned":{"type":"integer","title":"Blocks Scanned"},"min_usd_filter":{"type":"number","title":"Min Usd Filter"},"valuation_source":{"type":"string","title":"Valuation Source"},"total_whale_volume_usd":{"type":"number","title":"Total Whale Volume Usd"},"whale_transactions_found":{"type":"integer","title":"Whale Transactions Found"}}}}}}},"responseSchema":{"type":"object","properties":{"network":{"type":"string"},"timestamp":{"type":"string"},"whale_count":{"type":"integer"},"transactions":{"type":"array"},"total_whale_volume_usd":{"type":"number"}}},"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_L8qk40y_Zyx-F10WhgdiV","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 real-time on-chain whale transactions and large transfers on Base Mainnet (Chain ID 8453), filtered by minimum USD value","exampleAgentPrompt":"Show me the top 10 whale transactions on Base mainnet right now — only include transfers worth at least $50,000.","exampleUseCases":[{"title":"DeFi trader monitoring whale moves","prompt":"Pull the latest 20 whale transactions on Base mainnet with a minimum transfer size of $100,000 so I can see where the big money is moving before I make my trade."},{"title":"On-chain alert bot for large transfers","prompt":"Give me all whale transactions on Base right now above $75,000 — I want to know the count and total volume so I can decide if there's unusual activity today."},{"title":"Crypto analyst researching Base liquidity","prompt":"Fetch the top 15 large on-chain transfers happening on Base mainnet above $25,000 and tell me the total whale volume so I can include it in my market report."}],"resultDescription":"Returns a JSON object containing the network name (Base), a timestamp, the count of whale transactions found, an array of individual whale transactions, and the total USD volume of all whale transactions in the result set.","failureModes":["Payment not provided or invalid x402 payment header — returns 402 Payment Required","Invalid input parameters (e.g. non-integer limit) — returns 400 Bad Request","No whale transactions found meeting the minimum USD threshold — returns empty transactions array with whale_count of 0","Upstream Base node unavailability causing stale or missing data","Rate limiting if payment is not processed correctly"],"whenToPreferThis":"Choose this endpoint when you need real-time, on-chain large-transfer data specifically for Base Mainnet (Chain ID 8453). It is ideal for DeFi agents, trading bots, and market monitoring systems that need to detect whale activity programmatically with a low per-call cost of $0.02 USDC. Prefer this over general blockchain explorers when you need structured, filterable whale data via a simple API rather than raw block data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:34:53.516Z","isFirstParty":false}