# AgentToll OpenAQ Air Quality Lookup

> AgentToll OpenAQ Air Quality Lookup is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches real-time air quality monitoring data from OpenAQ, filterable by country and result limit, returning sensor readings and metadata.

## Facts

- Endpoint: POST https://agenttoll.dev/paid/osint/openaq-air
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-openaq-air-quality-lookup-c227dc96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tnYAtTkltfVpiYvSLcscA

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 agenttoll-openaq-air-quality-lookup-c227dc96 -d '<json body>'
```

Example prompt: Pull the latest air quality readings from OpenAQ for India, give me up to 50 results so I can see current pollution levels across monitoring stations.

## When to prefer this

Use this endpoint when an AI agent needs programmatic access to real-time or recent air quality data from the OpenAQ global sensor network, filtered by country, without managing OpenAQ API credentials directly. Ideal for OSINT pipelines, environmental research agents, and public health monitoring workflows that operate on a pay-per-call basis via USDC on Base.

## Known failure modes

- Invalid or unrecognized country code returns empty data array
- Limit value out of acceptable range may cause validation error
- OpenAQ upstream unavailability results in failure response
- Payment failure (insufficient USDC balance) blocks the request
- Cached results may be slightly stale if cached flag is true

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns a JSON object with a data array containing air quality measurements from OpenAQ monitoring stations, a meta object with total count, source name, and generation timestamp, plus boolean flags for success and whether the result was cached.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "country": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "oneOf": [
    {
     "type": "array"
    },
    {
     "type": "object"
    }
   ]
  },
  "meta": {
   "type": "object",
   "properties": {
    "count": {
     "type": "integer"
    },
    "source": {
     "type": "string"
    },
    "generated_at": {
     "type": "string",
     "format": "date-time"
    }
   }
  },
  "cached": {
   "type": "boolean"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-openaq-air-quality-lookup-c227dc96/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)