# Foundry Location Weather Evidence

> Foundry Location Weather Evidence is a paid API for AI agents from foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-14).

Returns NOAA/NWS official forecast periods and active weather alerts for a given latitude/longitude, with full source provenance, freshness metadata, and USDC micropayment pricing.

## Facts

- Endpoint: POST https://foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/v2/official/location-weather-evidence
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foundry-location-weather-evidence-be552e47
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N-_PVOMutFinWYoWCJ1aw

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 foundry-location-weather-evidence-be552e47 -d '<json body>'
```

Example prompt: Can you pull the official NOAA weather forecast for the next 4 periods at latitude 39.7456, longitude -97.0892, including any active alerts, with full source attribution?

## When to prefer this

Choose this endpoint when you need official, source-attributed US weather forecasts and active alerts with explicit provenance metadata, freshness timestamps, and a fixed per-call USDC micropayment price. Prefer it over generic weather APIs when auditability, source licensing, and machine-readable provenance are required — for example in AI pipelines, compliance workflows, or evidence-gathering agents. Not suitable for non-US locations, emergency safety warnings, or high-frequency polling due to per-call cost.

## Known failure modes

- Coordinates outside NWS coverage area (e.g. non-US locations) may return empty or error results
- NWS API upstream outage returns a degraded or error response
- Invalid latitude/longitude range (outside -90 to 90 or -180 to 180) rejected by input schema
- Empty alert list does not guarantee safety — explicitly noted in provenance limitations
- Cache may serve data up to 30 seconds old; freshness state field indicates if retrieval is live
- Payment failure (insufficient USDC) returns HTTP 402 before any weather data is retrieved

## How this service works

Pay-per-request evidence and data tools: CSV validation and reconciliation, DNS/email configuration evidence, and bounded official weather, earthquake, vehicle, company and study records. Exact USDC prices, explicit JSON contracts and source provenance. No mailbox, ownership, medical or safety guarantees.

## Output

A JSON object containing: normalized NWS forecast periods (name, startTime, endTime, temperature, temperatureUnit, windSpeed, windDirection, shortForecast, isDaytime), active weather alerts for the point, location echo (lat/lon), provenance block (license, attribution, terms URL, upstream call count, limitations), freshness metadata (retrievedAt, cacheAgeSeconds, state), and the upstream NWS source URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "periods": {
   "type": "integer",
   "default": 6,
   "maximum": 14,
   "minimum": 1
  },
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  },
  "alert_limit": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "route": "location-weather-evidence",
  "result": {
   "alerts": [],
   "forecast": {
    "query": {
     "periods": 4,
     "latitude": 39.7456,
     "longitude": -97.0892
    },
    "source": "National Weather Service",
    "freshness": {
     "state": "CURRENT_RETRIEVAL",
     "retrievedAt": "2026-09-06T00:00:00Z",
     "cacheAgeSeconds": 0,
     "maximumCacheSeconds": 30,
     "recordAgeIsNotRetrievalAge": true
    },
    "sourceUrl": "https://api.weather.gov",
    "observedAt": "2026-09-06T00:00:00Z",
    "provenance": {
     "license": "Open data free for any purpose; attribution and non-endorsement required",
     "termsUrl": "https://www.weather.gov/disclaimer",
     "truncated": false,
     "attribution": "NOAA / National Weather Service; normalized by Foundry; no endorsement",
     "limitations": [
      "Synthetic example only; identifiers and null values illustrate fields, not a live observation."
     ],
     "modifications": "Selected factual fields, normalized names and bounded result count; no source ownership claimed.",
     "upstreamCalls": 1,
     "documentationUrl": "https://www.weather.gov/documentation/services-web-api"
    },
    "sourceUpdatedAt": null,
    "normalizedResult": [
     {
      "name": null,
      "number": null,
      "endTime": null,
      "isDaytime": null,
      "startTime": null,
      "windSpeed": null,
      "temperature": null,
      "shortForecast": null,
      "windDirection": null,
      "temperatureUnit": null
     }
    ],
    "sourceProcessedAt": null,
    "rawSourceIdentifiers": []
   },
   "location": {
    "latitude": 39.7456,
    "longitude": -97.0892
   },
   "provenance": {
    "license": "Open data free for any purpose; attribution and non-endorsement required",
    "terms_url": "https://www.weather.gov/disclaimer",
    "attribution": "NOAA / National Weather Service; normalized by Foundry; no endorsement",
    "limitations": [
     "Factual forecast and current alert evidence only; not an emergency warning service or a safety recommendation.",
     "Sources have independent update and retrieval times; an empty alert list is not proof of safety.",
     "Synthetic example only; no live weather claim."
    ],
    "upstream_calls": 3
   },
   "alerts_source": {
    "url": "https://api.weather.gov/alerts/active?point=39.7456%2C-97.0892",
    "truncated": false,
    "updated_at": null,
    "retrieved_at": "2026-09-06T00:00:00Z",
    "cache_age_seconds": 0
   }
  },
  "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foundry-location-weather-evidence-be552e47/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev](https://www.zero.xyz/host/foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/llms.txt)