{"uid":"cap_r3IE_KYQkBVBRUVN7VptR","slug":"paddock-provider-revenue-api-be01632c","name":"Paddock Provider Revenue API","description":"Agent payments have no chargeback. Paddock is pre-payment verification for AI agents. get_provider_revenue ranks sellers by observed settled USDC over a window, resolved by wallet attribution.","url":"https://paddock.finance/api/paddock/mcp/provider-revenue?utm_source=zero.xyz","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":{"top":{"type":"integer","maximum":100,"minimum":1},"window":{"type":"integer","maximum":90,"minimum":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"tool":"get_provider_revenue","window":{"dates":["2026-07-24","2026-07-25"],"days_requested":7,"days_aggregated":7,"list_complete_all_days":true},"universe":"attributed","providers":[{"domain":"api.example.com","category":"llm","tx_count":3100,"revenue_usd":4200.5,"unique_buyers":210}],"unattributed":{"tx_count":3000,"revenue_usd":null,"share_of_listed_txns":0.25},"market_visibility":{"listed_txns":12000,"resolved_txns":9000,"coverage_pct_listed":0.75},"retroactive_exclusion_caveat":null}},"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_GXDpiuqMJ8eeYokYi55T9","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 ranked AI agent commerce revenue data by provider domain over a configurable time window, showing transaction counts, USD revenue, and unique buyer counts.","exampleAgentPrompt":"Pull me Paddock's provider revenue leaderboard for the last 7 days, top 20 providers, so I can see which API domains are earning the most from AI agents right now.","exampleUseCases":[{"title":"Weekly AI commerce market briefing","prompt":"Give me the Paddock provider revenue breakdown for the past 7 days, top 25 providers — I want to know which domains are capturing the most agent spending this week."},{"title":"LLM provider competitive benchmarking","prompt":"Pull the top 50 provider revenue rankings from Paddock over the last 30 days so I can benchmark how much agents are paying different LLM providers relative to each other."},{"title":"Market concentration research","prompt":"Fetch the Paddock provider revenue data for the last 14 days — I'm trying to understand how concentrated the AI agent commerce market is and what share is going to unattributed providers."}],"resultDescription":"Returns a JSON object with a ranked list of provider domains including category, transaction count, USD revenue, and unique buyer counts for the requested window; also includes unattributed transaction stats and market visibility coverage metrics (listed vs resolved transactions).","failureModes":["Invalid 'top' parameter outside 1-100 range returns validation error","Invalid 'window' parameter outside 1-90 days returns validation error","Payment failure or insufficient USDC balance blocks the request (x402 payment required)","Incomplete data coverage for very recent dates may reduce days_aggregated below days_requested","Some providers may appear as unattributed if domain resolution fails"],"whenToPreferThis":"Use this endpoint when you need a ranked, revenue-weighted view of which API provider domains are capturing agent spending over a specific recent time window. Prefer this over the best-value or liveness endpoints when the goal is market intelligence, competitive benchmarking, or understanding where agent commerce revenue is concentrating rather than finding the cheapest provider or checking uptime.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:46:58.641Z","isFirstParty":false,"canonicalSlug":"paddock-provider-revenue-api-be01632c"}