{"uid":"cap_5g2WwxtJlcWNNzLWeXRoS","slug":"defi-shield-hazel-vercel-app-bd69883f","name":"DeFi Shield Whale Alerts","description":"","url":"https://defi-shield-hazel.vercel.app/api/defi/whale-alerts","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"properties":{"chain":{"type":"string","description":"Chain (default: base)"},"token_address":{"type":"string","description":"Token address to monitor (0x + 40 hex chars)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"chain":"base","token_address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},"response":{"name":null,"chain":"base","period":"24h","symbol":null,"analyzed_at":"2026-06-16T01:18:28.904Z","total_supply":null,"token_address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","large_transfers":[],"response_time_ms":105,"net_flow_direction":"neutral","total_transfers_24h":0,"whale_activity_score":0}},"exampleRequest":{"chain":"base","token_address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_flpK0g5cnHgC5nkyifvJB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Detects large token transfers, calculates net flow direction, and produces a whale activity score for a given token on a specified chain over the past 24 hours.","exampleAgentPrompt":"Check whale activity for USDC (contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913) on Base — are there any large transfers in the last 24 hours, and is the net flow bullish or bearish?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the token address, chain, analysis period (24h), a list of large transfers detected, the net flow direction (e.g. 'neutral', 'inflow', 'outflow'), a whale activity score (numeric), total transfer count, and the timestamp of analysis. Token name and symbol may be null if not resolved.","failureModes":["Token address not found or invalid — returns empty large_transfers and zero counts","Chain not supported — may return error or empty result","No on-chain data available for the period — returns zeros and neutral direction","Network timeout or RPC failure — response may be delayed or error returned","Token has no whale-level activity in 24h — returns valid response with empty arrays and score of 0"],"whenToPreferThis":"Use this endpoint when you need a quick, scored summary of whale-level token movement on a specific chain within the last 24 hours, especially when you want to assess accumulation vs. distribution pressure or detect unusual large-wallet activity without running raw on-chain queries yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:53:26.717Z","isFirstParty":false}