# Vibe Springs Air Quality Index API

> Vibe Springs Air Quality Index API is a paid API for AI agents from vibesprings.net, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Retrieves real-time and forecast AQI data including PM2.5, PM10, ozone, NO2, SO2, CO, and US/European AQI scale parameters for any global location

## Facts

- Endpoint: GET https://vibesprings.net/api/air-quality
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibesprings-net-803ffe17
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5aU_5GWzEmnKcZXlNYMi6

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 vibesprings-net-803ffe17
```

Example prompt: What's the air quality index in Beijing right now, and can you give me the PM2.5, ozone, and NO2 levels forecasted for the next 3 days?

## When to prefer this

Use this endpoint when you need global air quality data including multiple pollutant readings (PM2.5, PM10, O3, NO2, SO2, CO) with both real-time and short-range forecast capability, and when US and/or European AQI scale labeling is needed for health or environmental intelligence applications

## Known failure modes

- Invalid or unrecognized location string returns an error or empty result
- Forecast days parameter out of range (1-7) may cause validation failure
- Coordinates outside valid lat/lon range may return no data
- Network timeout or upstream data provider outage
- Payment failure or insufficient USDC balance for x402 protocol

## How this service works

Real-time and forecast air quality index (AQI) and particulate matter database. Retrieves PM2.5, PM10, ozone (O3), nitrogen dioxide (NO2), sulfur dioxide (SO2), carbon monoxide (CO), US AQI scale labels, and European AQI parameters for any location globally. Crucial for smart city analytics, health monitoring, outdoor event planning, and environmental geointelligence.

## Output

Returns current and forecasted AQI data including PM2.5, PM10, ozone (O3), NO2, SO2, CO concentrations, US AQI scale labels, and European AQI parameters for the requested location and forecast window

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "days": 3,
   "location": "London"
  }
 }
}
```

## 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",
     "required": [
      "location"
     ],
     "properties": {
      "days": {
       "type": "number",
       "description": "Forecast window in days, ranging from 1 to 7 days (default is 1)"
      },
      "location": {
       "type": "string",
       "description": "City name, region, country, or coordinate pairs (e.g. 'Beijing', 'New York', '39.9042,116.4074')"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "current": {
   "pm10": 60.2,
   "ozone": 22.1,
   "pm2_5": 43.5,
   "us_aqi": 120,
   "us_aqi_label": "Unhealthy for Sensitive Groups",
   "carbon_monoxide": 0.8,
   "nitrogen_dioxide": 18.4
  },
  "location": "Beijing, China",
  "daily_summary": [
   {
    "date": "2026-05-24",
    "max_pm2_5": 45,
    "avg_us_aqi": 110,
    "overall_label": "Unhealthy for Sensitive Groups"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibesprings-net-803ffe17/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vibesprings.net](https://www.zero.xyz/host/vibesprings.net/llms.txt)