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=:
valuecontent typeshape
htmltext/htmlthe full analytical report — default
jsonapplication/jsonstructured payload: metadata, per-economy rows with the full series and every derived metric, cross-indicator correlations. Schema at /schema/report.json
csvtext/csvtidy long panel — one row per observation (report,indicator,economy,year,value)
summary-csvtext/csvone 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

idcategoryprice (USDC)endpoint
loading /catalog …
Data © World Bank Open Data, licensed CC BY 4.0, attribution required. Reports are generated by an automated pipeline and are provided for research reference only. Not investment advice.
x402 is maintained by Coinbase (x402.org).