{"x402Version":2,"resources":[{"resource":"https://paddock.finance/api/paddock/mcp/verify-before-pay","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"250000","maxAmountRequired":"250000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/verify-before-pay","description":"Should your agent pay this endpoint? The independent pre-payment check no seller can self-report. Probes the target unpaid at query time (GET then POST, decoding the 402 from the body and from the payment-required header), compares the decoded contract against your expected network/asset/seller/price, against the recipient wallet you named in pay_to, and against the seller's own published config, then adds observed settlement recency, flagged circular-cluster membership, and the category price comparison. Returns route true/false/inconclusive with dated evidence. Reports no success rate: Paddock observes settlements, not failed calls. Input: endpoint_url and/or pay_to, plus optional expect_* fields. $0.25/query; the free key covers it.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"endpoint_url":"https://api.example.com/x402/search","expect_network":"eip155:8453","expect_price_usdc":0.01}},"output":{"type":"json","example":{"tool":"verify_before_pay","schema_version":"verify_before_pay/0.15","checked_at":"2026-08-26T18:20:09.000Z","route":false,"reason_codes":["live_402_observed","contract_mismatch_price"],"summary":"Do not route: the live 402 contract does not match on price_usdc."}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"pay_to":{"type":"string"},"endpoint_url":{"type":"string"},"expect_network":{"type":"string"},"expect_asset":{"type":"string"},"expect_seller":{"type":"string"},"expect_price_usdc":{"type":"number","minimum":0}}}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"Should your agent pay this endpoint? The independent pre-payment check no seller can self-report. Probes the target unpaid at query time (GET then POST, decoding the 402 from the body and from the payment-required header), compares the decoded contract against your expected network/asset/seller/price, against the recipient wallet you named in pay_to, and against the seller's own published config, then adds observed settlement recency, flagged circular-cluster membership, and the category price comparison. Returns route true/false/inconclusive with dated evidence. Reports no success rate: Paddock observes settlements, not failed calls. Input: endpoint_url and/or pay_to, plus optional expect_* fields. $0.25/query; the free key covers it."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/gaps","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","maxAmountRequired":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/gaps","description":"Where to build or price next: every category ranked by opportunity score (high volume, few providers) with concentration and an Open/Tightening/Consolidating/Mature signal. Use before building an x402 service, to pick a category. Input: none. $0.01/query; the free key also covers it.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"top":10}},"output":{"type":"json","example":{"tool":"get_niche_gaps","categories":[{"category":"LLM & inference","category_id":"llm","opportunity_score":1.23,"signal":"Open"}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"top":{"type":"integer","minimum":1,"maximum":50}}}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"Where to build or price next: every category ranked by opportunity score (high volume, few providers) with concentration and an Open/Tightening/Consolidating/Mature signal. Use before building an x402 service, to pick a category. Input: none. $0.01/query; the free key also covers it."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/best-value","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"20000","maxAmountRequired":"20000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/best-value","description":"Which provider should your agent pay? Ranks a category by reliability (7-day share of probes that succeeded), reputation (unique buyers), and price — the strongest option, not just the cheapest. Each row carries its domain and per-query cost. Use before routing an agent payment. Input: category (llm|data|search|infra|content|markets|payments|comms). $0.02/query.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"category":"markets"}},"output":{"type":"json","example":{"tool":"get_best_value_provider","category":"markets","providers":[{"domain":"example.com","composite_score":0.91,"rank":1}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"category":{"type":"string"}},"required":["category"]}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"Which provider should your agent pay? Ranks a category by reliability (7-day share of probes that succeeded), reputation (unique buyers), and price — the strongest option, not just the cheapest. Each row carries its domain and per-query cost. Use before routing an agent payment. Input: category (llm|data|search|infra|content|markets|payments|comms). $0.02/query."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/liveness","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"1000","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/liveness","description":"Is this service actually up before you pay it? Per-domain liveness with 7-day share of probes that succeeded, latency p50/p95, sample counts and last-probe time — including domains with no payment history at all. Captured nightly, not probed at call time; for a check taken at query time use verify-before-pay. Input: domain. $0.001/query; the free key also covers it.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"domain":"api.example.com"}},"output":{"type":"json","example":{"tool":"get_liveness","domain":"api.example.com","up":true,"success_rate_7d":0.99,"latency_p50_ms":120}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"Is this service actually up before you pay it? Per-domain liveness with 7-day share of probes that succeeded, latency p50/p95, sample counts and last-probe time — including domains with no payment history at all. Captured nightly, not probed at call time; for a check taken at query time use verify-before-pay. Input: domain. $0.001/query; the free key also covers it."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/changes","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"100000","maxAmountRequired":"100000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/changes","description":"What moved: diff today against any snapshot up to 90 days back — new services, retired services, category share shifts, top movers. Use to monitor a market you already track. Input: since (YYYY-MM-DD). $0.10/query.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"since":"2026-09-01"}},"output":{"type":"json","example":{"tool":"get_changes","since":"2026-09-01","new_services":[],"category_movements":[]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"since":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["since"]}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"What moved: diff today against any snapshot up to 90 days back — new services, retired services, category share shifts, top movers. Use to monitor a market you already track. Input: since (YYYY-MM-DD). $0.10/query."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/circular-signal","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"990000","maxAmountRequired":"990000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/circular-signal","description":"Is the volume real? Wash/circular-settlement signal per facilitator: flagged clusters, flagged volume and share, self-funding percentage, detection date. The check sellers cannot self-report; methodology public. Returns flagged cluster count, cluster volume (30d/7d), self-funding %, external-payer count and trend, with the detection date and methodology version attached. Attributed to the facilitator only — never a seller wallet or an operator name. Use to discount settlement volume that is not real demand. Input: window (7d|30d). $0.99/query.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"window":"30d"}},"output":{"type":"json","example":{"tool":"get_circular_signal","methodology_version":"v0.1","facilitators":[{"facilitator":"meridian","cluster_count":2,"cluster_volume_usd":{"d30":215915.91,"d7":41203.84},"self_funding_pct":100,"external_payer_count":0,"flagged_share_of_listed_pct":1.06,"trend":"stable"}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"window":{"type":"string","enum":["7d","30d"]}}}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"Is the volume real? Wash/circular-settlement signal per facilitator: flagged clusters, flagged volume and share, self-funding percentage, detection date. The check sellers cannot self-report; methodology public. Returns flagged cluster count, cluster volume (30d/7d), self-funding %, external-payer count and trend, with the detection date and methodology version attached. Attributed to the facilitator only — never a seller wallet or an operator name. Use to discount settlement volume that is not real demand. Input: window (7d|30d). $0.99/query."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/whale-activity","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"990000","maxAmountRequired":"990000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/whale-activity","description":"Large settlements over a window, aggregated by facilitator, category, and size band — where big money moved, never who. Returns amounts and counts by facilitator, by category and by size band, plus per-category mover counts. Use to see whether a volume move is broad or one payer. Input: min_usd, window. $0.99/query.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"window":7,"min_usd":1000}},"output":{"type":"json","example":{"tool":"get_whale_activity","window_days":7,"large_threshold_usd":1000,"totals":{"large_settlement_providers":12,"large_settlement_volume_usd":480000},"by_facilitator":[{"facilitator":"coinbase","count":8,"volume_usd":320000}],"by_category":[{"category":"LLM & inference","count":5,"volume_usd":210000}],"size_bands":[{"band":"$100k+","min_usd":100000,"count":1,"volume_usd":150000}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"window":{"type":"integer","minimum":1,"maximum":90},"min_usd":{"type":"number","minimum":0}}}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"Large settlements over a window, aggregated by facilitator, category, and size band — where big money moved, never who. Returns amounts and counts by facilitator, by category and by size band, plus per-category mover counts. Use to see whether a volume move is broad or one payer. Input: min_usd, window. $0.99/query."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/provider-revenue","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"990000","maxAmountRequired":"990000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/provider-revenue","description":"Which providers earn most, on an honestly-bounded basis: attributed universe only, wash and facilitator wallets excluded, unresolved volume shown as its own row, completeness reported per day. Resolved by payTo wallet attribution, not by counting events. Use to size a competitor or a category. Input: window, top. $0.99/query.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"window":7,"top":20}},"output":{"type":"json","example":{"tool":"get_provider_revenue","universe":"attributed","window":{"dates":["2026-07-24","2026-07-25"],"days_requested":7,"days_aggregated":7,"list_complete_all_days":true},"providers":[{"domain":"api.example.com","category":"llm","revenue_usd":4200.5,"tx_count":3100,"unique_buyers":210}],"market_visibility":{"resolved_txns":9000,"listed_txns":12000,"coverage_pct_listed":0.75},"unattributed":{"revenue_usd":null,"tx_count":3000,"share_of_listed_txns":0.25},"retroactive_exclusion_caveat":null}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"window":{"type":"integer","minimum":1,"maximum":90},"top":{"type":"integer","minimum":1,"maximum":100}}}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"Which providers earn most, on an honestly-bounded basis: attributed universe only, wash and facilitator wallets excluded, unresolved volume shown as its own row, completeness reported per day. Resolved by payTo wallet attribution, not by counting events. Use to size a competitor or a category. Input: window, top. $0.99/query."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/token-metrics","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","maxAmountRequired":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/token-metrics","description":"First-party time series from Paddock's own census: spend share, daily transactions, concentration, new services, liveness score. Returns the chart series behind paddock.finance/charts by metric and date range: spend_share_over_time, daily_transactions, category_concentration, new_services, liveness_score, and the frozen Agent Commerce Index series (aci — SUSPENDED per ADR 0006: existing prints retained and served, no new prints computed, so that series does not advance). Use to chart or cite a trend. Input: metric, days or from/to. $0.01/query; the free key also covers it.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"metric":"daily_transactions","days":90}},"output":{"type":"json","example":{"tool":"get_token_metrics","metric":"daily_transactions","range":{"days":90,"from":"2026-03-25","to":"2026-06-23"},"points":[{"date":"2026-06-23","txns":341204}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"metric":{"type":"string","enum":["spend_share_over_time","daily_transactions","category_concentration","new_services","liveness_score","aci","settled_share_by_service"]},"days":{"type":"integer","minimum":1,"maximum":730},"category":{"type":"string"}},"required":["metric"]}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"First-party time series from Paddock's own census: spend share, daily transactions, concentration, new services, liveness score. Returns the chart series behind paddock.finance/charts by metric and date range: spend_share_over_time, daily_transactions, category_concentration, new_services, liveness_score, and the frozen Agent Commerce Index series (aci — SUSPENDED per ADR 0006: existing prints retained and served, no new prints computed, so that series does not advance). Use to chart or cite a trend. Input: metric, days or from/to. $0.01/query; the free key also covers it."}}}},{"resource":"https://paddock.finance/api/paddock/mcp/report-data/paid","x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"990000","maxAmountRequired":"990000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x153AA87807D8f6deb65Bd53B137Cee7AD2dacCDb","resource":"https://paddock.finance/api/paddock/mcp/report-data/paid","description":"The monthly State of Agent Commerce as structured JSON: trends, category breakdowns, protocol comparison, reliability. Metadata is free at /api/paddock/mcp/report-data; this is the full dataset. Use to cite or rebuild the report's figures. Input: month (YYYY-MM). $0.99/query.","mimeType":"application/json","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"month":"2026-08"}},"output":{"type":"json","example":{"tool":"get_report_data","month":"2026-08","title":"State of Agent Commerce","data":{}}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET","HEAD","DELETE"]},"queryParams":{"type":"object","properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}}}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]},"resource":{"description":"The monthly State of Agent Commerce as structured JSON: trends, category breakdowns, protocol comparison, reliability. Metadata is free at /api/paddock/mcp/report-data; this is the full dataset. Use to cite or rebuild the report's figures. Input: month (YYYY-MM). $0.99/query."}}}}]}