{"uid":"cap_eELE4bvw6qRY0ElhYLB8a","slug":"paddock-whale-activity-api-d6df6f89","name":"Paddock Whale Activity API","description":"The live, neutral, citable source for what AI agents are paying for and where the market is concentrating. Free dashboards, API & MCP, monthly intelligence report.","url":"https://paddock.finance/api/paddock/mcp/whale-activity","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"window":{"type":"integer","maximum":90,"minimum":1},"min_usd":{"type":"number","minimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"tool":"get_whale_activity","totals":{"large_settlement_providers":12,"large_settlement_volume_usd":480000},"size_bands":[{"band":"$100k+","count":1,"min_usd":100000,"volume_usd":150000}],"by_category":[{"count":5,"category":"LLM & inference","volume_usd":210000}],"window_days":7,"by_facilitator":[{"count":8,"volume_usd":320000,"facilitator":"coinbase"}],"large_threshold_usd":1000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.99","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.99/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.99","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.99","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UO9-_uGEGnIKDLMvA_vCT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.99","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated data on large-volume AI agent payment activity, broken down by size band, category, and facilitator over a configurable time window.","exampleAgentPrompt":"Pull the Paddock whale activity data for the last 14 days, filtering to transactions of at least $500 USD, and show me how volume breaks down by category and facilitator.","exampleUseCases":[{"title":"Weekly market concentration briefing","prompt":"Give me this week's whale activity report from Paddock — I want to know which AI service categories and facilitators are absorbing the biggest payments over the last 7 days."},{"title":"Detecting emerging high-spend categories","prompt":"Use Paddock's whale activity endpoint with a 30-day window to find out if any new AI categories are starting to attract large-volume payments — anything over $1,000 minimum."},{"title":"Benchmarking Coinbase facilitator dominance","prompt":"Check Paddock's whale data for the past 14 days and tell me how much of the large-settlement volume is flowing through Coinbase versus other facilitators."}],"resultDescription":"A JSON object containing: total count and USD volume of large settlements, a breakdown by size band (e.g. $100k+), a breakdown by AI service category (e.g. LLM & inference), a breakdown by facilitator (e.g. Coinbase), the window in days, and the threshold used to define 'large' transactions.","failureModes":["window parameter out of range (must be 1–90 days) returns 422 validation error","min_usd below 0 returns validation error","insufficient data for the selected window may return empty arrays","payment failure or expired x402 token returns 402 Payment Required","rate limiting may return 429 if called too frequently"],"whenToPreferThis":"Choose this endpoint when you need aggregated, large-transaction-focused market intelligence about AI agent payments — especially to identify which categories or facilitators are absorbing outsized spend. It is distinct from raw transaction feeds or per-domain lookups; use it for macro market analysis, concentration risk assessment, or trend monitoring at the whale tier.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:30:54.803Z","isFirstParty":false}