verify_before_pay | Free key, or $0.25 USDC / query | The pre-payment check no seller can self-report. Probes the target live for its 402, checks the contract against what you expect and the seller's own published config, then adds settlement recency, the circular signal, and price versus market. Returns route true/false/inconclusive, each with dated evidence. Call this before your agent authorizes any x402 payment. |
get_market_summary | Free | Current AI agent commerce market overview: total daily transaction volume, USDC spend, unique buyer agents, live service providers, and the top spending categories with their share of volume. |
get_category_detail | Free key | All services in a specific category (llm, data, search, infra, content, markets, payments, comms; aliases accepted) with transaction counts, pricing, provider count, and reliability scores. |
get_niche_gaps | Free key, or $0.01 USDC / query | Ranks every category by opportunity_score (high volume, few providers) with share, top-provider concentration, and an Open/Tightening/Consolidating/Mature signal. Answers "where should I build an x402 service?" |
get_best_value_provider | $0.02 USDC / query | Ranks providers in one category by a composite of reliability (7-day success rate), reputation (unique buyers), and price. |
get_liveness | Free key, or $0.001 USDC / query | Per-domain liveness for any domain TrustBench probes, with full probe detail: up/down (7-day probe success rate >= 0.95), score, latency p50/p95, sample count, endpoint count, and last-probe time. Reads the same nightly rollup as get_category_detail; the difference is reach and depth, not freshness, it answers for domains that have no x402 volume at all, which the category tool cannot. |
get_changes | $0.10 USDC / query | Diffs today's market snapshot against a past date (up to 90 days back): new services, retired services, category share movements, and top movers. |
get_circular_signal | $0.99 USDC / query | Wash/circular-settlement signal, aggregate per facilitator: cluster count, cluster volume (30d/7d), self-funding %, external-payer count, flagged share of settlement, and trend. Aggregate only, no wallet addresses or operator identity. |
get_whale_activity | $0.99 USDC / query | Large settlements and movers over a window, aggregate by facilitator, category, and size band: amounts, counts, and per-category mover counts. Describes size and where, never who. |
get_token_metrics | Free key, or $0.01 USDC / query | First-party chart/time-series data by metric and date range: spend share over time, daily transactions, category concentration, new services, liveness score, and the Agent Commerce Index (ACI). |
get_provider_revenue | $0.99 USDC / query | Which providers earn the most over a window of daily snapshots, and how much of the market that answer can see. Attributed universe only, facilitator pass-through and circular-flagged wallets are excluded, and unresolved wallets are not dropped but surface as one explicit unattributed row (transaction share only; no dollar figure exists for them). Reports whether the recipient list was complete on every aggregated day. |
get_report_data | Free metadata + $0.99 USDC / query for full data | Free metadata (title, table of contents, executive summary excerpt) at the unauthenticated /api/paddock/mcp/report-data route; full structured JSON of the monthly State of Agent Commerce report, ecosystem trends, category breakdowns, the Agent Commerce Index (ACI) with component decomposition, protocol comparison, and reliability data, via the x402-hardened /api/paddock/mcp/report-data/paid route. |