{"uid":"cap_IHCmPdxbn43rnxT6On5lU","slug":"basewhale-oracle-x402-756c6f59","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/whale-stats","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":"StatsInput","properties":{"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":"StatsResponse","required":["success","network","tracked_token","valuation_source","source","fetched_at","latest_block","blocks_scanned","total_whale_transactions","total_whale_volume_usd","largest_single_transfer_usd","average_whale_transfer_usd","volume_category","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"},"tracked_token":{"type":"string","title":"Tracked Token"},"blocks_scanned":{"type":"integer","title":"Blocks Scanned"},"volume_category":{"type":"string","title":"Volume Category"},"valuation_source":{"type":"string","title":"Valuation Source"},"total_whale_volume_usd":{"type":"number","title":"Total Whale Volume Usd"},"total_whale_transactions":{"type":"integer","title":"Total Whale Transactions"},"average_whale_transfer_usd":{"type":"number","title":"Average Whale Transfer Usd"},"largest_single_transfer_usd":{"type":"number","title":"Largest Single Transfer Usd"}}}}}}},"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_MAWnUAEpfkUmEtLXceA2R","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 transfer statistics for Base Mainnet (Chain ID 8453), filtered by minimum USD value","exampleAgentPrompt":"Show me the top 20 whale transactions on Base mainnet right now, only include transfers worth at least $50,000.","exampleUseCases":[{"title":"DeFi trader monitoring whale moves","prompt":"What are the biggest on-chain transfers happening on Base right now? Show me the top 15 transactions but only ones over $100,000 so I can spot whale activity before it moves the market."},{"title":"Crypto researcher analyzing volume","prompt":"Pull the current whale stats for Base mainnet — I want to see up to 25 large transactions with a minimum of $30,000 each so I can calculate today's total whale volume."},{"title":"Bot alert for large Base transfers","prompt":"Check Base mainnet right now for any transfers over $75,000 and give me the full list of whale transactions so I can decide whether to adjust my positions."}],"resultDescription":"Returns a JSON object with the Base network identifier, a timestamp, the count of qualifying whale transactions, an array of individual large transfer records, and the total whale volume in USD across all returned transactions.","failureModes":["Payment not received or x402 payment header missing — returns 402 Payment Required","Invalid input types (e.g. non-integer limit) — returns 400 Bad Request","No transactions meet the min_usd threshold — returns empty transactions array with whale_count of 0","Base node unavailability or RPC outage — may return 503 or timeout","Rate limiting if too many requests in short succession"],"whenToPreferThis":"Choose this endpoint when you need real-time, pay-per-call access to large-transfer whale data specifically on Base Mainnet (Chain ID 8453) without committing to a subscription. It is ideal for agents that need on-demand whale activity snapshots, want to filter by a custom USD threshold, or are building micro-payment-enabled workflows using the x402 payment protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:40:58.869Z","isFirstParty":false}