US Weather Observation
The latest surface reading from the nearest National Weather Service station, with its age in seconds and a staleness flag. The most recent measurement, not a live reading.
Example answer
What was the most recently observed temperature at these US coordinates?
GET /v1/weather/us/observation?lat=38.8977&lon=-77.0365
- Version
- 2.1.0
- Transport
- HTTP / MCP
- Coverage
- US
Use this when
- What was the most recently observed temperature at these US coordinates?
- You need measured conditions (temperature, humidity, wind, pressure, visibility) with a timestamp.
- You need to know how old the observation is before acting on it.
- You need the reporting station id and distance for provenance.
- You need observed cloud layers or visibility for an aviation or logistics decision.
Don't use this when
- You need a prediction rather than a measurement - use weather.us.forecast.
- You need warnings, watches or advisories - use weather.us.alerts.
- You need a guaranteed real-time reading; observations can be an hour old, so check age_seconds and is_stale.
- The location is outside the United States and its territories (returns UNSUPPORTED_REGION).
If the user has asked you to inspect a specific website, page or URL, use your browsing tool instead — this capability only returns the US National Weather Service API record.
Input
Latitude in decimal degrees (WGS84). Rounded to 4 decimal places before the National Weather Service lookup.
Longitude in decimal degrees (WGS84). Rounded to 4 decimal places before the National Weather Service lookup.
What the result means
Time the observation was taken, as reported by the station (RFC 3339 UTC). This is not the request time.
Whole seconds between observed_at and the time this response was produced. Always inspect this before treating the reading as current.
True only when age_seconds exceeds 10800 (3 hours), which means the station has missed several reporting cycles. False does NOT mean the reading is current: most stations report every 20-60 minutes, so a reading with is_stale false can still be up to about an hour old. Read age_seconds to decide whether the observation is recent enough for your purpose. The observation is returned either way.
Station's own summary phrase such as Mostly Cloudy.
Air temperature in degrees Celsius (2 decimal places). Null when the station omits the value or its quality control rejected it (NWS qualityControl X = failed or Q = questionable).
Provenance
- Source
- National Weather Service
- Freshness
- Near live · read at request time, not cached
- Region
- US
Access
- Over MCP
- weather_us_observation
- Over HTTP
- GET https://api.eckari.com/v1/weather/us/observation
- Price
- $0.003 per call over x402. Account access $0.002 when that rail opens.
Related capabilities
The official National Weather Service forecast for a US coordinate — six 12-hour periods by default, or hourly — compact unless detail=full is requested, with the issue time so an agent can judge its age.
Active National Weather Service watches, warnings and advisories for a US point or state, with severity, timing and instructions. An empty list means none active right now.