# tokenguard Air Quality Lookup

> tokenguard Air Quality Lookup is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns current PM2.5, PM10, ozone, NO2, SO2, CO, dust concentrations plus US AQI, European AQI, and US AQI band for a named place

## Facts

- Endpoint: GET https://eltociear-tokenguard.hf.space/world/airquality
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-air-quality-lookup-f4e05963
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7rN7TO7qUjQefegf-5ruY

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 tokenguard-air-quality-lookup-f4e05963
```

Example prompt: What's the air quality in Delhi right now? Give me the PM2.5, PM10, and the US AQI rating so I know whether it's safe to go outside.

## When to prefer this

Choose this endpoint when you need current, multi-pollutant air quality data for a human-readable place name without handling geocoding yourself. It uniquely combines both US and European AQI standards with the actionable US AQI band label in a single call, making it ideal for health-advisory agents, travel assistants, and outdoor activity planners. Prefer it over coordinate-based APIs when your input is a city or place name rather than lat/lon.

## Known failure modes

- Unrecognized or ambiguous place name fails geocoding — returns error or null result
- Location with no nearby monitoring stations returns sparse or null pollutant data
- Transient upstream data source outage causes empty or stale readings
- Overly broad place names (e.g. 'Asia') may geocode to unexpected coordinates
- Rate limiting or payment failure returns 402 or 429 error

## How this service works

How breathable is the air in this place right now? Current PM2.5, PM10, ozone, NO2, SO2, CO and dust plus both the US and European AQI, and the US AQI band ('Good', 'Unhealthy') so the number is directly actionable. Takes a place name, not coordinates

## Output

Returns a JSON object containing current concentrations of PM2.5, PM10, ozone (O3), nitrogen dioxide (NO2), sulfur dioxide (SO2), carbon monoxide (CO), and dust, along with the numeric US AQI score, numeric European AQI score, and the US AQI band label (e.g. 'Good', 'Moderate', 'Unhealthy for Sensitive Groups', 'Unhealthy', 'Very Unhealthy', 'Hazardous') for the specified location.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "number",
   "description": "Latitude (use instead of location)"
  },
  "location": {
   "type": "string",
   "description": "Place name, e.g. 'Tokyo' — geocoded for you"
  },
  "longitude": {
   "type": "number",
   "description": "Longitude (use instead of location)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "us_aqi": 42,
  "location": "Tokyo, Japan",
  "uv_index": 5.2,
  "pollutants": {
   "ozone": 61,
   "pm2_5": 9.8
  },
  "european_aqi": 18,
  "us_aqi_category": "Good"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-air-quality-lookup-f4e05963/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)