{"openapi":"3.0.0","info":{"title":"Paddock — Agent Commerce Data","description":"Live data on the AI agent economy. Tracks what AI agents buy across x402 and MPP payment protocols. Free tier: market summary and category detail. Paid tier (Builder $99/mo or Pro Agent $499/mo, or x402 per-query): niche gap analysis and structured report data.","version":"1.0.0"},"servers":[{"url":"https://paddock.finance"}],"paths":{"/api/mcp/summary":{"get":{"operationId":"get_market_summary","summary":"Get live agent commerce market summary","description":"Returns current x402 transaction volume, top spending categories, live server count, and market overview. Free — no authentication required. Use this to answer questions about the current state of agent commerce.","responses":{"200":{"description":"Market summary with category breakdown","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"summary":{"type":"object","properties":{"daily_transactions":{"type":"number"},"daily_volume_usdc":{"type":"string"},"unique_buyer_agents":{"type":"number"},"live_service_providers":{"type":"number"}}},"top_categories":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"daily_transactions":{"type":"number"},"providers":{"type":"number"},"share_of_volume":{"type":"string"}}}},"insight":{"type":"string"},"subscription_url":{"type":"string"}}}}}}}}},"/api/mcp/category":{"get":{"operationId":"get_category_detail","summary":"Get detail for a specific agent commerce category","description":"Returns all services in a category with transaction counts, pricing, and reliability scores. Free — no authentication required. Valid categories: llm, data, search, infra, content, trading, payments, social.","parameters":[{"name":"name","in":"query","required":true,"description":"Category name: llm, data, search, infra, content, trading, payments, or social","schema":{"type":"string","enum":["llm","data","search","infra","content","trading","payments","social"]}}],"responses":{"200":{"description":"Category detail with services and reliability","content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"summary":{"type":"object","properties":{"total_daily_transactions":{"type":"number"},"provider_count":{"type":"number"},"market_status":{"type":"string"}}},"services":{"type":"array","items":{"type":"object","properties":{"service":{"type":"string"},"domain":{"type":"string"},"daily_transactions":{"type":"number"},"unique_buyers":{"type":"number"}}}},"subscription_url":{"type":"string"}}}}}}}}},"/api/mcp/gaps":{"get":{"operationId":"get_niche_gaps","summary":"Find open niches in agent commerce (Paddock API)","description":"Returns categories with real agent spend (>500 daily transactions) and fewer than 3 service providers. These are open niches where a new entrant could capture significant market share. Requires a Paddock API key (Builder $99/mo or Pro Agent $499/mo) or an x402 per-query payment. Pass your API key in X-Paddock-Key header.","security":[{"ProApiKey":[]}],"responses":{"200":{"description":"Open niches with opportunity scores","content":{"application/json":{"schema":{"type":"object","properties":{"open_niches":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"daily_transactions":{"type":"number"},"providers":{"type":"number"},"opportunity_score":{"type":"number"},"signal":{"type":"string"}}}},"summary":{"type":"string"}}}}}},"402":{"description":"Payment required — Builder $99/mo, Pro Agent $499/mo, or x402 per-query","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"pro_required"},"message":{"type":"string"},"subscribe":{"type":"object"},"x402":{"type":"object"}}}}}}}}},"/api/mcp/report-data":{"get":{"operationId":"get_report_data","summary":"Get structured State of Agent Commerce report data (Paddock API or x402)","description":"Returns machine-readable JSON of monthly agent commerce trends: category breakdown, open niches, protocol comparison, chain distribution, reliability metrics. Three access tiers: (1) no auth — free metadata only (title, TOC, executive summary excerpt under 200 words), (2) Paddock API key (Builder $99/mo current month, Pro Agent $499/mo all history), or (3) x402 per-query at $0.99 USDC. Different from the $299/mo human report — this is structured data for agents.","parameters":[{"name":"month","in":"query","required":false,"description":"Report month in YYYY-MM format (e.g. 2026-06). Defaults to current published month.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}}],"security":[{"ProApiKey":[]}],"responses":{"200":{"description":"Structured report data (full if paid, metadata only if free)","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"month":{"type":"string"},"access":{"type":"string","enum":["free","x402","builder","pro_agent"]},"title":{"type":"string"},"table_of_contents":{"type":"array","items":{"type":"string"}},"executive_summary":{"type":"string"},"data":{"type":"object"}}}}}},"402":{"description":"Payment required for full report data — $0.99 USDC via x402, or API key"}}}}},"components":{"securitySchemes":{"ProApiKey":{"type":"apiKey","in":"header","name":"X-Paddock-Key","description":"Paddock API key issued upon Builder or Pro Agent subscription. See https://paddock.finance/api-access"}}}}