# AgentUtility Air Quality API

> AgentUtility Air Quality API is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns current air quality readings and AQI category (US and European) plus optional hourly forecast for any latitude/longitude coordinate

## Facts

- Endpoint: POST https://x402.agentutility.ai/air-quality
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-air-quality-api-709388f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fwkaqurZ3XQ-i-xklP0rg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentutility-air-quality-api-709388f0 -d '<json body>'
```

Example prompt: What's the current air quality at coordinates 34.05 latitude, -118.24 longitude, and give me an hourly AQI forecast for the next 24 hours?

## When to prefer this

Choose this endpoint when you need real-time or near-future air quality data for any global coordinate, especially when you need multiple pollutant dimensions (PM2.5, PM10, ozone, NO2, SO2, CO) alongside both US and European AQI standards in a single call. It is particularly suitable for agents operating in automated, USDC-settled workflows via x402 payment protocol. Prefer this over general weather APIs when air quality specifics (not just weather) are the primary concern.

## Known failure modes

- Invalid or out-of-range latitude/longitude returns an error indicating bad coordinates
- Forecast hours outside the 1–72 range may return a validation error
- Upstream Open-Meteo service unavailability may result in a 502 or timeout
- Missing required coordinate fields returns a 400-level error
- x402 payment failure or insufficient USDC balance blocks request before execution

## How this service works

Returns current air quality readings and AQI category for any latitude/longitude, with optional hourly forecast rows for the next 1-72 hours. Air-quality data from Open-Meteo. Use it as an air quality API covering US AQI, European AQI, PM2.5, PM10, ozone, nitrogen dioxide, sulphur dioxide, and carbon monoxide.

## Output

A JSON response containing current air quality measurements including US AQI value and category, European AQI, PM2.5, PM10, ozone, nitrogen dioxide, sulphur dioxide, and carbon monoxide concentrations. If forecast hours are requested (1–72), the response also includes timestamped hourly rows for each pollutant and AQI index over that period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "latitude",
      "longitude"
     ],
     "properties": {
      "hourly": {
       "type": "boolean",
       "description": "If true, include hourly pollutant/AQI rows. Default false."
      },
      "latitude": {
       "type": "number",
       "description": "Decimal degrees, range [-90, 90]. Positive north."
      },
      "longitude": {
       "type": "number",
       "description": "Decimal degrees, range [-180, 180]. Positive east."
      },
      "forecast_hours": {
       "type": "number",
       "description": "Hourly forecast horizon when hourly=true. 1-72. Default 24."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "units": {
       "type": "object",
       "properties": {
        "pm2_5": {
         "type": "string"
        },
        "us_aqi": {
         "type": "string"
        }
       }
      },
      "source": {
       "type": "string"
      },
      "current": {
       "type": "object",
       "properties": {
        "pm10": {
         "type": "number"
        },
        "time": {
         "type": "string"
        },
        "ozone": {
         "type": "integer"
        },
        "pm2_5": {
         "type": "number"
        },
        "us_aqi": {
         "type": "integer"
        },
        "european_aqi": {
         "type": "integer"
        },
        "carbon_monoxide": {
         "type": "integer"
        },
        "sulphur_dioxide": {
         "type": "integer"
        },
        "us_aqi_category": {
         "type": "string"
        },
        "nitrogen_dioxide": {
         "type": "integer"
        }
       }
      },
      "location": {
       "type": "object",
       "properties": {
        "latitude": {
         "type": "number"
        },
        "timezone": {
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "units": {
   "pm2_5": "μg/m³",
   "us_aqi": "USA AQI"
  },
  "source": "Open-Meteo Air Quality",
  "current": {
   "pm10": 14.1,
   "time": "2026-06-18T12:00",
   "ozone": 72,
   "pm2_5": 6.2,
   "us_aqi": 42,
   "european_aqi": 28,
   "carbon_monoxide": 210,
   "sulphur_dioxide": 1,
   "us_aqi_category": "good",
   "nitrogen_dioxide": 11
  },
  "location": {
   "latitude": 37.77,
   "timezone": "America/Los_Angeles",
   "longitude": -122.42
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-air-quality-api-709388f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)