llms.txt: documentation index for LLMs and agentsllms-full.txt: full documentation corpusMarkdown version of the documentationskill.md: agent skill filePaddock MCP server descriptor
API & MCP · Live

Build with Paddock, pre-payment verification for AI agents.

Connect Paddock to your agents, your workflows, your custom LLM tooling. Real-time agent commerce data, structured and ready to query.

Subscribe below — your API key arrives by email within minutes.

— What you can do

6 paid tools. 5 on a free key. 2 with no key at all.

01
Free key
verify_before_pay
free key · $0.25 per call
Should my agent pay this endpoint right now? Probes the target live for its 402, checks the contract against what you expected and the seller's own published config, then adds settlement recency, the circular signal, and price versus market; returns `route` true / false / inconclusive with dated evidence.
02
Keyless
check_payee
free · $0.01 per call
Fast payee check before an agent pays. Send the resource URL and the payment terms you are about to sign: payee wallet, network and amount.
25 calls a day with no key.
@paddock-finance/x402-guard npm · GitHub
03
Free key
get_liveness
free key · $0.001 per call
Was this domain up at last night's probe? Returns seven-day probe data for any probed domain: share of probes that succeeded, p50 and p95 latency, sample count, and last-probe time, from the nightly snapshot.
04
Paid
get_circular_signal
$0.99
Is this volume real? Returns the circular-settlement signal per facilitator: flagged clusters, the volume they carry, the detection date, and the criteria applied.
05
Paid
get_best_value_provider
$0.02
Which provider should my agent pick? Returns the category ranked by reliability, reputation, and price, with the published formula and each provider's inputs.
06
Keyless
get_market_summary
free
How big is agent commerce today? Returns the day's settled volume, USDC spend, active buyer agents, live providers, and top categories, from the nightly snapshot.
07
Free key
get_category_detail
free key
Who's selling in this category, and who's actually getting paid? Returns each provider's daily transactions, USDC volume, unique buyers, and reliability score, from the nightly snapshot.
08
Free key
get_niche_gaps
free key · $0.01 per call
Where is demand outrunning supply? Returns the categories with real settled volume and few providers, with the volume and provider count behind each.
09
Paid
get_changes
$0.10
What changed since a date I name? Diffs today against any past snapshot: new services, retired services, and the biggest movers.
10
Paid
get_whale_activity
$0.99
Where did the large settlements go? Returns large settlements and the biggest movers in aggregate, with amounts and dates.
11
Free key
get_token_metrics
free key · $0.01 per call
Is today's number a real move or ordinary noise? Returns Paddock's own daily time series by metric and date range: daily transactions, spend share, category concentration, new services, liveness score, and the monthly index.
12
Paid
get_provider_revenue
$0.99
Who earns the most? Returns the revenue leaderboard by service, with the coverage figure that says how much of settled volume the leaderboard can attribute.
13
Paid
get_report_data
$0.99 · metadata free
What are the numbers behind the monthly report? Returns the full State of Agent Commerce dataset behind the monthly report, every figure with its universe label and methodology version.
— Tiers

Built for evaluation through production.

Free MCP
$0
For evaluation & light use
✓ get_market_summary
✓ MCP connector for Claude / ChatGPT
✓ Unlimited: no key, no cap
✗ No paid tools
✗ No report data
Free key
$0
An email address. No card, no waiting.
✓ 10 calls/day, shared across:
   verify_before_pay
   get_category_detail
   get_niche_gaps
   get_token_metrics
   get_liveness
✓ usage on every response
✓ Instant, self-serve. No approval.
✗ No paid tools
Get a free key →
Most popular
Builder
$99/mo
For indie devs & single agents
✓ All 6 paid tools
✓ 10,000 calls/day (enforced)
✓ X-RateLimit-* headers on every response
✓ Current-month report data (JSON)
✓ Free MCP tools included
Subscribe · $99/mo →
Pro Agent
$499/mo
For production agents & research teams
✓ Everything in Builder
✓ Unlimited API calls (no daily cap)
✓ Full report archive: every month, not just current
✓ All 6 paid tools
✓ Free MCP tools included
Subscribe · $499/mo →
Enterprise
Custom
For companies running more than one team of agents
✓ Everything in Pro Agent
✓ Keys for every team and agent, revoked per holder
✓ One invoice. No cards.
✓ Custom coverage: the services, categories, or rails you depend on
✓ Direct support
✓ Custom report
Talk to us →

[email protected]

Want per-query pricing instead of a subscription? Every tool with a price is also exposed via x402 (Base): get_liveness $0.001, check_payee $0.01, get_niche_gaps $0.01, get_token_metrics $0.01, get_best_value_provider $0.02, get_changes $0.10, verify_before_pay $0.25, get_circular_signal $0.99, get_whale_activity $0.99, get_provider_revenue $0.99, get_report_data $0.99. Send an x402 payment and include X-Payment-Receipt; no key needed.

Contact us for enterprise plans.

— Free key

Start building in one minute.

10 calls per day, shared across verify_before_pay, get_category_detail, get_niche_gaps, get_token_metrics, get_liveness. No card, no account, and no approval step — the key is generated the moment you submit, shown on this page, and emailed to you as a copy.

get_market_summary stays open with no key at all. Everything else is per-query via x402 or on a subscription.

Free for development and internal use. Redistribution, resale, or serving Paddock data to your end users requires a commercial license — see paddock.finance/api-access or contact [email protected].

— Commercial licensing

Building on Paddock internally is free. Passing it on is not.

Every tier — free key, per-query x402, Builder, Pro Agent — covers development and internal use. A commercial licence is required if you:

  • Redistribute Paddock data — bulk export, mirroring, or republishing the series.
  • Resell it, in whole or in part, as data or as a derived product.
  • Serve it to your end users — surfacing Paddock figures inside a product other people use.

Citing Paddock in research, posts, or reporting is not redistribution — cite away, a link back is appreciated. If you are not sure which side of the line you are on, ask; the answer is usually simple and often yes.

[email protected] — tell us what you are building and we will scope it.

— Interested but not ready to subscribe?

Leave your email — we'll follow up.

Evaluating Paddock for your team, agent, or research? Drop a note. We'll send launch updates and check in to see what you're building.

Keep going

What to read next.

x402 market
What agents pay for.

Real transaction volume by category. Three sources merged into one live table.

See the market →
For the trader
Track agent tokens.

Live Virtuals leaderboard. ROI, volume, market cap. Sortable. Free.

See the leaderboard →