# Citiview Air Quality History

> Citiview Air Quality History is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-14).

Returns daily air pollution history (PM2.5, PM10, ozone, NO2, SO2, CO) for any location for up to 365 days, including AQI, worst day, WHO exceedances, and trend direction.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/airquality/history?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-air-quality-history-865ed4c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_McVerXqA7MrXWbYOIccTP

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 citiview-air-quality-history-865ed4c0
```

Example prompt: What has the PM2.5 air quality been like in Denver over the last 60 days — was it getting better or worse, and how many days exceeded the WHO guideline?

## When to prefer this

Use this endpoint when you need historical daily air quality data (not real-time or forecast) for a specific place, want multi-pollutant flexibility (PM2.5, PM10, ozone, NO2, SO2, CO), or need summary statistics like worst day, WHO exceedance count, and trend direction — all in a single call. Prefer over generic weather APIs that lack pollutant-level granularity or WHO guideline comparison.

## Known failure modes

- No nearby active monitor found for the given coordinates or place name
- Invalid or out-of-range 'days' parameter (must be 1–365)
- Unknown place name that cannot be geocoded
- Unsupported pollutant parameter string
- Coordinates outside coverage area
- Payment failure or insufficient USDC balance (x402)

## How this service works

Air pollution history for any place: daily average, min and max of PM2.5 (or PM10, ozone, NO2, SO2, CO) from the nearest active monitor for up to 365 days, with daily US AQI, worst day, days over the WHO guideline and an improving/worsening trend.

## Output

Returns a time series of daily air quality readings from the nearest active monitor covering the requested parameter (PM2.5 by default), with each day's average, min, and max values, a daily US AQI score, the single worst day in the period, the total count of days exceeding the WHO guideline, and an overall improving or worsening trend indicator.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "days": {
       "type": "integer",
       "description": "1-365, default 30"
      },
      "near": {
       "type": "string",
       "description": "Place name"
      },
      "parameter": {
       "type": "string",
       "description": "pm25 (default), pm10, o3, no2, so2, co"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-air-quality-history-865ed4c0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)