Air Quality Index

Fetch current US AQI, European AQI, particulate, carbon monoxide, nitrogen dioxide, and ozone values for a geocoded location.

0.02 USDC / request GET live_source Base mainnet x402 v2

Preview request

The preview path is rate-limited and does not charge. Production requests use the same parameters and return a standard x402 challenge when no payment signature is present.

curl --request GET \
  "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/air_quality?preview=true&city=Beijing"

Input contract

ParameterTypeRequiredDescription
citystringYesCity name or location coordinates.

Guaranteed response metadata

Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract and can be inspected through the preview request where available.

{
  "marketplace_metadata": {
    "data_mode": "live_source",
    "billable": true,
    "availability": "operational",
    "source": "Open-Meteo Air Quality API"
  }
}

Agent payment flow

Request the product, read the base64 PAYMENT-REQUIRED challenge, sign the exact Base-USDC authorization with an x402 buyer client, and retry using PAYMENT-SIGNATURE. A successful response includes PAYMENT-RESPONSE.