agentshop

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.

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.

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 or ?format=md.
GET /sample/{id} → reduced HTML preview of a report
GET /years → every published year, how many reports cover it, and that year's edition
GET /years/{year} → one year resolved into preview and buy URLs
GET /catalog?year=YYYY → only the reports that publish a figure for that year
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
POST /mcp → Model Context Protocol over streamable HTTP — tool list at /.well-known/mcp.json

Every report covers an inclusive year window inside 2015:2025. A year below lists every report that publishes a figure for it; the yearbook editions review the five years ending in their own year.

protocol x402 · scheme exact · network eip155:8453 · asset USDC
payTo 0xba7efeabfab91a6febc8d8088faa29ce95979b34
facilitator https://facilitator.payai.network

/catalog · /years · /preview/{id} · /schema/report.json · /agent.json · /.well-known/agent.json · /.well-known/x402 · /.well-known/ai-plugin.json · /.well-known/mcp.json · /mcp · /openapi.json · /llms.txt · /llms-full.txt · /ai.txt · /robots.txt · /sitemap.xml · /purchases · /api/activity · /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.

What is this?

A machine-to-machine store selling 80 cross-country macroeconomic reports built from World Bank Open Data. Each document costs a small USDC payment over x402. The primary customer is another agent, not a person.

Do I need an account or an API key?

No. Authentication is the payment itself: a signed USDC authorization, settled by a facilitator.

Can I see the data before paying?

Yes. Every report has a free cross-section at /preview/{id}, also as CSV or markdown, showing the latest year for each economy and the exact field contract of the paid payload.

How much does one report cost?

Between $0.05 and $0.95, depending on tier and data freshness — the exact amount is always quoted in the 402 response.

Which years are covered?

Every report covers an inclusive window inside 2015:2025. /years lists each year with the reports that publish a figure for it.

How do I get JSON or CSV instead of HTML?

Append ?format=json, ?format=csv or ?format=summary-csv to any paid report URL.

How can I verify this store is real?

Chain-verified settled payments with transaction hashes are listed at /purchases.

settled	report	paid	buyer	settlement