# greeneris-data - European business verification for AI agents

> Your agent can verify any European business partner: company existence (official French SIREN registry), insolvency records, EU VAT validation before invoicing, LEI lookup, address and email verification, business-day deadlines, EU public tenders. Pay per call in USDC on Base via the x402 protocol - no account, no API key, the payment IS the authentication. The catalog also carries 40+ supporting data endpoints (FX, macro, crypto, weather) at commodity prices.

How to buy: GET any endpoint below -> HTTP 402 with a machine-readable quote (PAYMENT-REQUIRED header) -> sign a USDC transfer (EIP-3009, gasless) -> retry with the X-PAYMENT header. Any x402 client SDK automates this.

MCP server 'eu-verify' (streamable HTTP): https://data.greeneris.io/mcp - paid tools: lookup_company_fr, check_insolvency_fr, validate_vat_eu, validate_siret_fr, validate_iban, lookup_lei, verify_address_fr, validate_email, business_days_fr, find_public_tenders_eu, plus a free `catalog` tool.

## Machine-readable docs

- [OpenAPI](https://data.greeneris.io/openapi.json): schemas and parameters
- [x402 manifest](https://data.greeneris.io/.well-known/x402): payment terms per resource
- [Agent status](https://data.greeneris.io/agent-status): liveness and payment config

## Paid endpoints (price per call, USDC)

- [/v1/air/quality](https://data.greeneris.io/v1/air/quality) ($0.002): Hourly PM2.5/PM10/AQI forecast for any coordinates worldwide
- [/v1/aviation/metar](https://data.greeneris.io/v1/aviation/metar) ($0.002): Decoded METAR surface observations for up to 10 ICAO airports worldwide
- [/v1/books/isbn](https://data.greeneris.io/v1/books/isbn) ($0.002): ISBN-10/13 lookup returning a normalized book record (title, authors, publisher, pages)
- [/v1/btc/fees](https://data.greeneris.io/v1/btc/fees) ($0.001): Recommended Bitcoin fee rates (sat/vB) from the live mempool
- [/v1/ca/boc-rates](https://data.greeneris.io/v1/ca/boc-rates) ($0.002): Bank of Canada official CAD FX rates and policy rate, by series
- [/v1/crypto/fng](https://data.greeneris.io/v1/crypto/fng) ($0.001): Crypto Fear & Greed Index (0-100) with classification and 7-day delta
- [/v1/de/power-spot](https://data.greeneris.io/v1/de/power-spot) ($0.002): EPEX day-ahead hourly electricity spot prices for Germany (DE-LU) and Austria
- [/v1/defi/yields](https://data.greeneris.io/v1/defi/yields) ($0.01): Top-N DeFi pools by APY, filtered by chain, TVL and stablecoin flag
- [/v1/derivs/funding-arb](https://data.greeneris.io/v1/derivs/funding-arb) ($0.05): Ranked delta-neutral funding-rate arbitrage opportunities across Binance, Bybit, Hyperliquid
- [/v1/derivs/snapshot](https://data.greeneris.io/v1/derivs/snapshot) ($0.005): Funding rates, open interest and basis for crypto perps across Binance, Bybit and Hyperliquid
- [/v1/dev/deps](https://data.greeneris.io/v1/dev/deps) ($0.01): Supply-chain due diligence for a package: licenses, advisories, OpenSSF Scorecard
- [/v1/dev/eol](https://data.greeneris.io/v1/dev/eol) ($0.005): End-of-life status and days-to-EOL for software release cycles
- [/v1/dev/hn-top](https://data.greeneris.io/v1/dev/hn-top) ($0.002): Top Hacker News stories with score filter, aggregated in one call
- [/v1/dev/vulns](https://data.greeneris.io/v1/dev/vulns) ($0.01): Known CVEs/advisories for an exact package version (OSV.dev)
- [/v1/docker/image](https://data.greeneris.io/v1/docker/image) ($0.005): Docker Hub image health: activity status, pull count, freshness, latest tags
- [/v1/domain/dns](https://data.greeneris.io/v1/domain/dns) ($0.002): Live DNS lookup (A/AAAA/MX/TXT/NS/CNAME) with an email-readiness check
- [/v1/domain/rdap](https://data.greeneris.io/v1/domain/rdap) ($0.005): Domain due-diligence: age, expiry, registrar, status locks, nameservers
- [/v1/eth/gas](https://data.greeneris.io/v1/eth/gas) ($0.002): Ethereum gas: next-block base fee + priority-fee percentiles in gwei
- [/v1/eu/estr](https://data.greeneris.io/v1/eu/estr) ($0.002): Official ECB euro short-term rate (ESTR), latest fixing or recent history
- [/v1/eu/holidays-regional](https://data.greeneris.io/v1/eu/holidays-regional) ($0.005): Regional public holidays AND school holidays for 36 countries, subdivision-level
- [/v1/eu/inflation](https://data.greeneris.io/v1/eu/inflation) ($0.002): Official HICP inflation (annual rate) by EU country and COICOP item, from Eurostat
- [/v1/eu/instrument](https://data.greeneris.io/v1/eu/instrument) ($0.005): Regulatory identity card of a financial instrument by ISIN (ESMA FIRDS)
- [/v1/eu/policy-rates](https://data.greeneris.io/v1/eu/policy-rates) ($0.002): The three ECB key policy rates (refi, deposit facility, marginal lending)
- [/v1/eu/power-price](https://data.greeneris.io/v1/eu/power-price) ($0.005): Day-ahead electricity spot prices (EPEX) for any European bidding zone
- [/v1/eu/tenders](https://data.greeneris.io/v1/eu/tenders) ($0.01): Latest EU public tenders (TED) filtered by CPV code and buyer country
- [/v1/eu/vat-check](https://data.greeneris.io/v1/eu/vat-check) ($0.005): Validate an intra-EU VAT number against VIES with a timestamped result
- [/v1/eu/yield-curve](https://data.greeneris.io/v1/eu/yield-curve) ($0.005): Euro area AAA sovereign spot yield curve (ECB), with 2s10s spread
- [/v1/fr/bodacc](https://data.greeneris.io/v1/fr/bodacc) ($0.01): French BODACC legal announcements by SIREN: insolvencies, sales, filings
- [/v1/fr/business-days](https://data.greeneris.io/v1/fr/business-days) ($0.005): French business-day calculator: add N working days or count them between dates
- [/v1/fr/communes](https://data.greeneris.io/v1/fr/communes) ($0.001): French communes reference: postal code to INSEE code, population, departement, region
- [/v1/fr/company](https://data.greeneris.io/v1/fr/company) ($0.005): French company registry lookup (SIRENE) by name or SIREN, for KYB
- [/v1/fr/dpe](https://data.greeneris.io/v1/fr/dpe) ($0.005): French energy performance certificates (DPE) by address or postal code
- [/v1/fr/elevation](https://data.greeneris.io/v1/fr/elevation) ($0.001): Precise ground elevation for any point in France (IGN RGE ALTI DEM)
- [/v1/fr/fuel](https://data.greeneris.io/v1/fr/fuel) ($0.002): Live French gas-station fuel prices by departement or city, cheapest-first
- [/v1/fr/geocode](https://data.greeneris.io/v1/fr/geocode) ($0.001): Geocode or reverse-geocode any French address (official BAN, with confidence score)
- [/v1/fr/power-mix](https://data.greeneris.io/v1/fr/power-mix) ($0.002): French power grid live: demand, production mix, CO2 intensity, cross-border flows
- [/v1/fr/risks](https://data.greeneris.io/v1/fr/risks) ($0.005): Natural and technological risks registered for a French commune (GeoRisques)
- [/v1/fr/siret-check](https://data.greeneris.io/v1/fr/siret-check) ($0.001): French SIREN/SIRET checksum validation (Luhn + La Poste exception), offline
- [/v1/fr/tenders](https://data.greeneris.io/v1/fr/tenders) ($0.01): French public procurement notices (BOAMP) by department and sector keyword
- [/v1/fx/history](https://data.greeneris.io/v1/fx/history) ($0.002): Historical ECB FX rates: single past date or daily time series since 1999
- [/v1/fx/latest](https://data.greeneris.io/v1/fx/latest) ($0.001): Latest ECB reference FX rates for any base currency
- [/v1/fx/official](https://data.greeneris.io/v1/fx/official) ($0.005): Official US Treasury quarterly exchange rates (~170 currencies vs USD)
- [/v1/gb/carbon](https://data.greeneris.io/v1/gb/carbon) ($0.002): GB grid carbon intensity (gCO2/kWh): current and 48h forecast, national or per region
- [/v1/gb/power-demand](https://data.greeneris.io/v1/gb/power-demand) ($0.002): GB national electricity demand in MW, 5-minute resolution, near real time
- [/v1/geo/disasters](https://data.greeneris.io/v1/geo/disasters) ($0.005): Active worldwide disaster alerts (cyclone, flood, quake, volcano, wildfire, drought)
- [/v1/geo/postal](https://data.greeneris.io/v1/geo/postal) ($0.001): Postal code lookup worldwide: code -> city/state/lat/lon, or city -> codes
- [/v1/geo/quakes](https://data.greeneris.io/v1/geo/quakes) ($0.002): Real-time worldwide earthquakes with tsunami flag and PAGER alert level (USGS)
- [/v1/global/leading-indicators](https://data.greeneris.io/v1/global/leading-indicators) ($0.01): OECD Composite Leading Indicator (CLI) per country, with cycle-phase signal
- [/v1/global/lei](https://data.greeneris.io/v1/global/lei) ($0.005): LEI lookup or legal-name search: entity status, jurisdiction, HQ, renewal date
- [/v1/global/macro](https://data.greeneris.io/v1/global/macro) ($0.005): World Bank annual macro indicators (inflation, GDP, debt) for any country
- [/v1/hydro/river](https://data.greeneris.io/v1/hydro/river) ($0.005): Daily river discharge forecast (m3/s) for any river point, up to 210 days
- [/v1/logistics/container-check](https://data.greeneris.io/v1/logistics/container-check) ($0.002): Validate a shipping container number (ISO 6346 structure + check digit)
- [/v1/logistics/gtin-check](https://data.greeneris.io/v1/logistics/gtin-check) ($0.001): Validate a GTIN/EAN/UPC barcode number (GS1 mod-10 check digit)
- [/v1/nordics/power-price](https://data.greeneris.io/v1/nordics/power-price) ($0.002): Nord Pool day-ahead electricity prices for Estonia, Finland, Latvia, Lithuania
- [/v1/npm/cdn-rank](https://data.greeneris.io/v1/npm/cdn-rank) ($0.002): Browser-side popularity of an npm package: jsDelivr CDN rank and trend
- [/v1/npm/package](https://data.greeneris.io/v1/npm/package) ($0.005): npm package card: latest version, license, deps count, weekly downloads
- [/v1/oecd/cpi](https://data.greeneris.io/v1/oecd/cpi) ($0.002): National CPI inflation (annual rate) for OECD countries: USA, GBR, JPN and more
- [/v1/oracle/pyth](https://data.greeneris.io/v1/oracle/pyth) ($0.005): Pyth oracle crypto prices with confidence interval and EMA
- [/v1/predict/kalshi](https://data.greeneris.io/v1/predict/kalshi) ($0.01): Live Kalshi event-market odds (Fed, CPI, BTC, elections) with implied probabilities
- [/v1/predict/polymarket](https://data.greeneris.io/v1/predict/polymarket) ($0.01): Live Polymarket odds: market-implied probabilities for crypto, politics and macro events
- [/v1/pypi/package](https://data.greeneris.io/v1/pypi/package) ($0.002): PyPI package card: latest version, license, requires_python, dependencies
- [/v1/sea/state](https://data.greeneris.io/v1/sea/state) ($0.005): Sea-state forecast (wave height, swell, period, direction) with Mediterranean port presets
- [/v1/solar/history](https://data.greeneris.io/v1/solar/history) ($0.01): Daily solar irradiance and climate history (NASA POWER) for any point on Earth
- [/v1/space/kp](https://data.greeneris.io/v1/space/kp) ($0.002): Real-time planetary K-index (geomagnetic activity) with storm flag
- [/v1/space/launches](https://data.greeneris.io/v1/space/launches) ($0.005): Consolidated calendar of upcoming orbital launches (windows, pads, status)
- [/v1/stables/peg](https://data.greeneris.io/v1/stables/peg) ($0.02): Live stablecoin peg deviation in bps, cross-checked on Kraken and Binance
- [/v1/stables/supply](https://data.greeneris.io/v1/stables/supply) ($0.005): Stablecoin circulating supply with 24h/7d/30d net mint-burn flows
- [/v1/time/zone](https://data.greeneris.io/v1/time/zone) ($0.001): Current local time, date and DST status for any IANA timezone
- [/v1/us/debt](https://data.greeneris.io/v1/us/debt) ($0.002): Total US public debt outstanding, to the penny, updated daily
- [/v1/us/sec-fundamentals](https://data.greeneris.io/v1/us/sec-fundamentals) ($0.01): Official XBRL fundamentals for any US-listed company, from SEC EDGAR
- [/v1/us/treasury-rates](https://data.greeneris.io/v1/us/treasury-rates) ($0.005): Average interest rates paid on US Treasury securities, by security type
- [/v1/us/wx-alerts](https://data.greeneris.io/v1/us/wx-alerts) ($0.005): Active official US weather alerts (tornado, flood, fire...) by state or GPS point
- [/v1/validate/bic](https://data.greeneris.io/v1/validate/bic) ($0.001): BIC/SWIFT code validation: ISO 9362 structure + real ISO country code, offline
- [/v1/validate/email](https://data.greeneris.io/v1/validate/email) ($0.005): Email deliverability verdict: RFC syntax check + live MX lookup (no SMTP handshake)
- [/v1/validate/iban](https://data.greeneris.io/v1/validate/iban) ($0.001): IBAN validation: format, country length and mod-97 checksum (ISO 13616)
- [/v1/validate/isin](https://data.greeneris.io/v1/validate/isin) ($0.002): ISIN validation: ISO 6166 structure + Luhn base-36 checksum, offline
- [/v1/validate/lei](https://data.greeneris.io/v1/validate/lei) ($0.002): LEI checksum validation (ISO 17442, mod-97), offline -- no registry lookup
- [/v1/vehicle/vin](https://data.greeneris.io/v1/vehicle/vin) ($0.005): Decode any VIN to vehicle specs (make, model, engine, plant) via NHTSA vPIC
- [/v1/vol/dvol](https://data.greeneris.io/v1/vol/dvol) ($0.02): Crypto implied volatility: Deribit DVOL index level, 24h change and historical percentile
- [/v1/world/holidays](https://data.greeneris.io/v1/world/holidays) ($0.001): Official public holidays for any country and year (100+ countries)
- [/v1/wx/forecast](https://data.greeneris.io/v1/wx/forecast) ($0.001): Hourly weather forecast (up to 16 days) for any coordinates worldwide