# MacroLens

> Global macro statistics (World Bank) and official company registry lookups (Norway, France) for AI agents. Pay per call in USDC on Base via x402. No API key.

Base URL: https://macrolens.imac2014ville.workers.dev
OpenAPI: https://macrolens.imac2014ville.workers.dev/openapi.json
Source: https://github.com/Imac2014Ville/baselens

## Endpoints (GET with query params, or POST with JSON body)
- /company ($0.02): Official company registry lookup by name or registry number: legal form, status, address, industry, employees; France adds officers and revenue/net income. Norway (Enhetsregisteret) and France (SIRENE/RNE). Example: /company?country=NO&query=Equinor
- /country-profile ($0.01): One-call economic snapshot of a country: latest GDP, GDP per capita, growth, inflation, unemployment, population, debt, current account, exports, imports, FDI, life expectancy, lending rate. Example: /country-profile?country=JP
- /compare ($0.01): Rank up to 10 countries (or G7, BRICS, NORDICS) on one indicator using the latest available value of each. Example: /compare?countries=G7&indicator=unemployment
- /indicator ($0.005): Time series for one country and one macro indicator (gdp, gdp_per_capita, gdp_growth, inflation, unemployment, population, debt_to_gdp, current_account, exports, imports, fdi, gini, life_expectancy and more), default last 10 years. Example: /indicator?country=US&indicator=gdp

## Sources
World Bank Open Data (CC BY 4.0), Brønnøysund Enhetsregisteret (NLOD), Recherche d'entreprises/SIRENE (Licence Ouverte 2.0).

## Developer guides
- GDP and inflation API for AI agents: https://macrolens.imac2014ville.workers.dev/guides/gdp-inflation-api-for-ai-agents
- Compare countries' unemployment programmatically: https://macrolens.imac2014ville.workers.dev/guides/compare-countries-unemployment-api
- Norwegian and French company registry lookup API: https://macrolens.imac2014ville.workers.dev/guides/norway-france-company-registry-api

## How to pay
Call an endpoint without payment to receive HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON: scheme exact, network eip155:8453, asset USDC). Use an x402 client (@x402/fetch, x402-axios, or an MCP x402 wallet) to sign and retry. Malformed requests return 400 and lookups that fail return non-2xx, so they are not charged.