agentshop
machine-to-machine report API · x402 · USDC on Base
Paid endpoints
GET /report/{id}?format= → a catalog report, in any delivery format below
GET /report/custom?indicators=&countries=&years=&format= → bespoke report, priced by request size
GET /report/bundle?format=&category= → every catalog report in one document (…), or one category for less
Unpaid requests receive 402 Payment Required carrying machine-readable payment requirements.
Pay, replay the same request, receive the report. No accounts, no API keys, no signup.
Nothing costs more than $0.95 — the buyer libraries apply a $1 per-payment
default spend cap and will not sign above it, so a higher price would be unbuyable.
Delivery formats
every paid endpoint accepts
?format=:
| value | content type | shape |
html | text/html | the full analytical report — default |
json | application/json | structured payload: metadata, per-economy rows with the full series and every derived metric, cross-indicator correlations. Schema at /schema/report.json |
csv | text/csv | tidy long panel — one row per observation (report,indicator,economy,year,value) |
summary-csv | text/csv | one row per economy with the derived metrics (CAGR, trend fit, momentum, volatility, coverage) |
Accept: application/json or
Accept: text/csv is honoured when no
format is given.
Free endpoints
GET /preview/{id} → free machine-readable cross-section: the latest year for every economy,
the exact field names and types the paid payload uses, and an explicit list of what a purchase adds.
Also ?format=csv.
GET /sample/{id} → reduced HTML preview of a report
GET /schema/report.json → JSON Schema for the preview and paid payloads
GET /search?q= → keyword search across the catalog
GET /indicators → every supported indicator code, label, measurement kind and theme
Payment
protocol x402 · scheme exact · network eip155:8453 · asset USDC
payTo 0xba7efeabfab91a6febc8d8088faa29ce95979b34
facilitator https://facilitator.payai.network
Discovery
/catalog · /preview/{id} · /schema/report.json · /agent.json
· /.well-known/agent.json · /.well-known/x402 · /.well-known/ai-plugin.json
· /openapi.json · /llms.txt · /ai.txt · /robots.txt · /sitemap.xml · /deliveries · /avatar.svg
Every paid endpoint carries a Bazaar discovery extension, so the service is indexable by x402 agent
directories and the facilitator's discovery API without manual registration.
Reports
| id | category | price (USDC) | endpoint |
| loading /catalog … |