# Company data (GLEIF + national registers FR, NO, FI, LV, IE, GB, US, EE, TW, HK, SG, AU, HR) + Official FX rates, policy rates, US Treasury yields and inflation (ECB, NY Fed, US Treasury, Eurostat, BLS)

> Pay-per-call data APIs for AI agents. Payment per request with x402 (USDC, network eip155:8453) – no account, no API key, no subscription.

## How to call
- Send GET with query parameters. Without payment the answer is HTTP 402 with the x402 payment requirements; pay with any x402 client and repeat the request.
- Invalid input is rejected with HTTP 400 BEFORE payment. Not found (404) and source outages (503/504) are never charged.
- Every answer names its official source (attribution).

## Endpoints

### GET /v1/company – 0.002 USDC
Use when an agent must verify a company (KYC/KYB, supplier or invoice check): official legal name, address, legal form, active/dissolved, LEI, register number, VAT validity. Search by name= (+country=), id=, lei= or vat=. GLEIF worldwide plus official national registers: FR, NO, FI, LV, IE, GB, US, EE, TW, HK, SG, AU, HR – also firms without LEI. Source named in every answer. Bad input: HTTP 400 before payment; no match or outage is not charged.
- `name`: Company legal name (2-200 chars), e.g. Erste Group Bank.
- `country`: 2-letter ISO country code. FR, NO, FI, LV, IE, GB, US, EE, TW, HK, SG, AU, HR: official national register; other countries: GLEIF.
- `id`: National register number, needs country=: FR SIREN 303265045, NO 923609016, FI 0112038-9, LV 40003245752, IE 104547, GB 00445790, US SEC CIK 320193, EE 12417834, TW 20828393, HK 00015833, SG 196800306E, AU ACN 102443916, HR MBS 080722712 or OIB.
- `vat`: VAT number of a French, Norwegian, Finnish, Latvian or Croatian company, e.g. FR40303265045, NO923609016MVA, FI01120389, LV40003245752, HR + 11-digit OIB.
- `lei`: 20-character Legal Entity Identifier.
- Example: https://x402-apis.pages.dev/v1/company?name=Erste+Group+Bank&country=AT

### GET /v1/fx-rates – 0.002 USDC
Use when an agent needs an official exchange rate to convert prices, invoices or portfolios: ECB euro reference rates for ~30 currencies (USD, GBP, CHF, JPY, CNY …), latest or for any day since 1999, with any base currency (cross rates computed from the ECB fix). Returns the exact rate date. Source named in every answer. Bad input: HTTP 400 before payment; unknown currency or outage is not charged.
- `base`: Base currency, 3 letters, default EUR. Any ECB reference currency.
- `symbols`: Comma-separated target currencies, e.g. USD,CHF,GBP. Default: all.
- `date`: Day as YYYY-MM-DD (1999-01-04 or later). Default: latest. Weekends/holidays return the previous ECB fix.
- Example: https://x402-apis.pages.dev/v1/fx-rates?base=USD&symbols=EUR%2CCHF%2CGBP

### GET /v1/interest-rates – 0.002 USDC
Use when an agent needs today's central bank rates for loans, savings, valuation or macro answers: ECB key rates (deposit facility, main refinancing, marginal lending, with the date they took effect) and US Fed funds target range, effective fed funds rate (EFFR) and SOFR from the New York Fed. Official sources only, named in every answer. region=EA, US or all (default). Bad input: HTTP 400 before payment; outage is not charged.
- `region`: EA (euro area / ECB), US (Federal Reserve) or all. Default: all.
- Example: https://x402-apis.pages.dev/v1/interest-rates?region=all

### GET /v1/treasury-yields – 0.002 USDC
Use when an agent needs US government bond yields, a risk-free rate or the yield curve (e.g. 2Y/10Y spread, recession signal, discounting): official US Treasury daily par yield curve, 1 month to 30 years, latest or any day since 1990 (weekends/holidays return the previous business day). Includes 10Y-2Y and 10Y-3M spreads. Source named in every answer. Bad input: HTTP 400 before payment; outage is not charged.
- `date`: Day as YYYY-MM-DD (1990-01-02 or later). Default: latest published curve.
- Example: https://x402-apis.pages.dev/v1/treasury-yields?date=2026-10-01

### GET /v1/inflation – 0.002 USDC
Use when an agent needs the official inflation rate (year-on-year consumer prices) for a country: Eurostat HICP for the euro area, EU and 36 European countries (incl. CH, NO, TR) and US CPI-U from the Bureau of Labor Statistics. Latest month plus up to 36 months of history, flash estimates flagged. Source named in every answer. Bad input: HTTP 400 before payment; outage is not charged.
- `country` (required): 2-letter code: EA, EU, AT, BE, BG, CY, CZ, DE, DK, EE, EL, ES, FI, FR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK, IS, NO, CH, TR, AL, ME, MK, RS, XK, US. EA = euro area, EU = European Union.
- `months`: Number of months of history, 1-36. Default 12.
- Example: https://x402-apis.pages.dev/v1/inflation?country=AT&months=12

## Machine-readable
- [MCP server](https://x402-apis.pages.dev/mcp): every endpoint as an MCP tool (Streamable HTTP, POST; x402 payment in _meta["x402/payment"])
- [OpenAPI 3.1](https://x402-apis.pages.dev/openapi.json): all endpoints with prices, parameters and example answers
- [x402 discovery](https://x402-apis.pages.dev/.well-known/x402): list of paid resources

Contact: Stockwerk Studio, stockwerkstudio@gmail.com