Pay-per-call air quality index and pollutant data for any lat/lon coordinate via OpenWeather.
What it does
This MPP endpoint provides air quality data from OpenWeather, accessible through the Locus Micropayment Protocol. Given a latitude and longitude, it returns the current Air Quality Index (AQI) along with pollutant concentrations. Each call costs $0.006 (6,000 base units of pathUSD on Tempo L2) with no API key or subscription required — just a per-request micropayment.
The air quality endpoint is part of a broader OpenWeather service suite hosted on the same Locus MPP gateway, which also offers current weather, 5-day forecasts, One Call 3.0 (full forecast with alerts), weather overviews, geocoding, and reverse geocoding. All endpoints accept POST requests with JSON bodies and settle payments via the Tempo method in pathUSD.
The request schema is minimal: provide `lat` (latitude, -90 to 90) and `lon` (longitude, -180 to 180) as required numeric fields. The underlying data comes from OpenWeather's Air Pollution API, which typically returns AQI on a 1–5 scale plus concentrations for CO, NO, NO₂, O₃, SO₂, PM2.5, PM10, and NH₃. Note that the probe did not capture a 402 challenge on HEAD/GET (the endpoint returned 404), which is expected since this is a POST-only endpoint per the OpenAPI spec.
Capabilities
Use cases
- —Check real-time air quality index for a given location before outdoor activities
- —Integrate pollutant concentration data into health or environmental monitoring dashboards
- —Enrich location-based apps with AQI data without managing API keys or subscriptions
- —Automated agent workflows that need air quality context for travel or logistics decisions
Fit
Best for
- —AI agents needing on-demand air quality data with no subscription
- —Developers who want pay-per-call pricing without API key management
- —Applications requiring global AQI and pollutant breakdowns by coordinate
Not for
- —Historical air quality time-series analysis (this endpoint returns current data only)
- —High-volume bulk data ingestion where a direct OpenWeather subscription would be cheaper
Quick start
curl -X POST https://openweather.mpp.paywithlocus.com/openweather/air-quality \
-H "Content-Type: application/json" \
-d '{"lat": 40.7128, "lon": -74.0060}'Example
Request
{
"lat": 40.7128,
"lon": -74.006
}Endpoint
Quality
The OpenAPI spec is well-defined with clear request schema and pricing, but no response schema or example response is provided. The probe returned 404 on HEAD/GET, which is expected for a POST-only endpoint, but means no live 402 challenge was captured. No crawled documentation pages returned useful content.
Warnings
- —No 402 challenge was captured because the endpoint is POST-only; HEAD and GET returned 404. The endpoint is likely live but liveness could not be confirmed from the probe alone.
- —No response schema is documented in the OpenAPI spec — the 200 response only says 'Successful response' with no body definition.
- —The currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on the Tempo settlement method; if this assumption is wrong, the stated price of $0.006 would be incorrect.
- —All crawled pages returned 404 JSON errors; no supplementary documentation was available from the gateway itself.
Citations
- —Air quality endpoint costs 6000 base units via Tempo method with the listed currency addresshttps://openweather.mpp.paywithlocus.com
- —Request schema requires lat and lon as numeric fieldshttps://openweather.mpp.paywithlocus.com
- —Part of a broader OpenWeather suite including current weather, 5-day forecast, geocoding, reverse geocoding, One Call, and weather overviewhttps://openweather.mpp.paywithlocus.com
- —API reference available at openweathermap.org/apihttps://openweathermap.org/api
- —LLM-oriented docs referenced at beta.paywithlocus.com/mpp/openweather.mdhttps://beta.paywithlocus.com/mpp/openweather.md