# Clink Forge AQI Site Lookup

> Clink Forge AQI Site Lookup is a paid API for AI agents from api.clinkforge.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Looks up air quality index (AQI) data for a specific monitoring site by site ID, returning government-sourced data rows with cryptographic provenance and attestation, paid per-call via USDC over x402.

## Facts

- Endpoint: GET https://api.clinkforge.com/v1/p/aqi-site-lookup
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clink-forge-aqi-site-lookup-436ffa31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xw-_QRrb3HoYrXU_e7mPi

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 clink-forge-aqi-site-lookup-436ffa31
```

Example prompt: Can you pull the current AQI data for monitoring site ID '060371103' from Clink Forge — I need the government-sourced reading with the full provenance chain so I can verify where the data came from.

## When to prefer this

Choose this endpoint when you need AQI data from a specific government monitoring station and require cryptographic provenance and attestation for trust, auditability, or compliance purposes. It is especially valuable for autonomous agents that must prove data authenticity without maintaining API accounts or keys, and when a per-call micropayment model in USDC is preferable to subscription billing. Prefer alternatives if you need broad geographic AQI search, real-time forecasting, or do not require provenance guarantees.

## Known failure modes

- Missing or invalid 'id' query parameter returns a validation error
- Unknown or non-existent site ID returns empty data rows or a not-found error
- Insufficient USDC payment or failed x402 transaction results in a 402 Payment Required response
- Site ID exceeds 60-character maximum length causes a schema validation rejection
- Government data source temporarily unavailable may return stale or error response
- Network timeout during on-chain payment settlement

## How this service works

Pay per call over x402. USDC on Base, no account, no API key. 28 government-sourced data products at $0.001–$0.05 per call, every response signed and provenance-chained.

## Output

Returns a JSON object containing: one or more AQI data rows with field values and record IDs, the product name and version, a provenance chain with SHA-256 hash, authoritative agency name, source URL, and observation timestamp, a cryptographic attestation with signature, result digest, and signing key ID, and a payment receipt with USD amount and on-chain settlement reference.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "maxLength": 60
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "field": "value",
    "_record_id": "R-100"
   }
  ],
  "product": "example-product",
  "row_count": 1,
  "provenance": [
   {
    "hash": "sha256...",
    "authority": "AGENCY",
    "source_url": "https://agency.gov/data",
    "observed_at": "2026-08-25T00:00:00Z"
   }
  ],
  "attestation": {
   "signature": "base64...",
   "result_digest": "sha256...",
   "signing_key_id": "forge-signing-1"
  },
  "payment_receipt": {
   "amount_usd": 0.01,
   "settlement_ref": "0xtx..."
  },
  "product_version": 1
 },
 "description": "data rows + provenance chain + attestation"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clink-forge-aqi-site-lookup-436ffa31/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.clinkforge.com](https://www.zero.xyz/host/api.clinkforge.com/llms.txt)