# API Acre Current Weather

> API Acre Current Weather is a paid API for AI agents from apiacre.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Returns a current weather snapshot for a city name or coordinates, sourcing from the nearest NOAA/NWS station observation or MET Norway model point, with explicit labeling of data kind and provenance.

## Facts

- Endpoint: POST https://apiacre.com/v1/data/current-weather?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-acre-current-weather-19a955a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j5mjiVUw8C-J5QUix4Cb9

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 api-acre-current-weather-19a955a2 -d '<json body>'
```

Example prompt: What's the current weather in Washington DC right now — temperature, sky condition, and whether it's an actual observation or a model estimate?

## When to prefer this

Choose this endpoint when you need a single current-conditions snapshot (temperature, sky condition, timestamp) for any city name or lat/lon pair, with explicit sourcing from NOAA/NWS observations or MET Norway model data and clear labeling of data provenance. Prefer it over generic weather APIs when source transparency and SI-unit consistency matter, or when you need to distinguish real station observations from model interpolations. Use the companion forecast endpoint for multi-period outlooks.

## Known failure modes

- City name not found in GeoNames index — returns error or null location
- Coordinates out of range or malformed — returns validation error
- No NWS station nearby and MET Norway model unavailable — may return partial or null current fields
- Null fields in response when the reporting station omitted a measurement
- Rate limiting or payment failure (x402) — returns 402 or 429 status
- Stale cached response if cache TTL not yet expired (up to 900s)

## How this service works

Get one current weather snapshot for a city/locality name or exact coordinates. Returns the nearest NOAA/NWS station observation where available; otherwise returns the latest MET Norway model point, always labeled explicitly as observation or model with bounded SI fields and source provenance.

## Output

A JSON object with a `data` block containing: current weather fields (temperature in Celsius, condition string, effective timestamp, data kind), source provenance (provider, station ID/name, dataset label distinguishing observation vs model), resolved location metadata (city, state, lat/lon, timezone), a list of limitations, retrieval timestamp, and cache TTL. Also includes a `meta` block with processing duration, cache status, and suggested next-action endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "latitude": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  },
  "longitude": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "source": {
    "dataset": "NWS nearest-station latest observation",
    "dataKind": "observation",
    "provider": "NOAA/National Weather Service",
    "stationId": "KDCA",
    "stationName": "Washington/Reagan National Airport, DC"
   },
   "current": {
    "dataKind": "observation",
    "condition": "Mostly Cloudy",
    "effectiveAt": "2026-08-20T09:52:00+00:00",
    "temperatureC": 24.4,
    "conditionCode": null
   },
   "location": {
    "city": "Washington",
    "state": "DC",
    "latitude": 38.8951,
    "timezone": "America/New_York",
    "longitude": -77.0364
   },
   "limitations": [
    "Place-name resolution uses the bundled GeoNames cities500 index, ranked by ex...",
    "The nearest reporting station may be some distance from the requested point, ...",
    "Null fields mean the station omitted a supported measurement; API Acre does n...",
    "This snapshot excludes forecasts and alerts and must not be used alone for li..."
   ],
   "retrievedAt": "2026-08-20T10:00:00+00:00",
   "cacheTtlSeconds": 900
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": [
    {
     "path": "/v1/data/us-weather-forecast",
     "title": "Global weather forecast",
     "method": "POST",
     "reason": "Extend the point-in-time snapshot with a separately authorized global hourly ...",
     "service": "data.us-weather-forecast"
    }
   ]
  },
  "service": "data.current-weather",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-acre-current-weather-19a955a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)