Observations

Returns METAR and SPECI weather observations from 20 NWS stations across the US. Data includes temperature, dewpoint, wind, pressure, visibility, sky cover, and raw METAR text.

Request

GET /api/v1/observations

Parameters

Name	Type	Required	Description
`station`	string	No	Station code (e.g., `NYC`, `LAX`, `ORD`)
`from`	string	No	Start time (RFC3339). Default: 24h ago
`to`	string	No	End time (RFC3339). Default: now
`type`	string	No	Filter by type: `METAR` or `SPECI`
`units`	string	No	`raw` (default), `metric`, or `imperial`
`tz`	string	No	`UTC` (default), `station`, or IANA name
`format`	string	No	Output format: `json` (default), `csv`, `parquet`
`columns`	string	No	Comma-separated column names to include (e.g., `close,volume`)
`limit`	integer	No	Max results (default 1000)
`offset`	integer	No	Pagination offset

Unit conversion

Field	Raw	Metric	Imperial
Temperature	°F	°C	°F
Wind speed	knots	m/s	mph
Pressure (altimeter)	inHg	hPa	inHg
Visibility	miles	km	miles
Precipitation	inches	mm	inches
Snow depth	inches	mm	inches

Example

curl "https://api.mostlyright.xyz/api/v1/observations?station=NYC&units=metric&limit=2"

from therminal import TherminalClient

client = TherminalClient()
obs = client.observations(station="NYC", units="metric", limit=2, as_dataframe=True)

Response

[
  {
    "station_code": "NYC",
    "observed_at": "2026-03-20T15:51:00Z",
    "observation_type": "METAR",
    "source": "awc",
    "temp_f": 10.61,
    "dewpoint_f": 0,
    "wind_speed_kt": 2,
    "altimeter_inhg": 1017.09,
    "visibility_miles": 16.09,
    "sky_cover_1": "CLR",
    "raw_metar": "METAR KNYC 201551Z AUTO VRB04KT 10SM CLR 11/00 A3007 RMK AO2 SLP173 ..."
  }
]

Try it

GET /api/v1/observations

station

units

limit

Click "Send →" to try it live

Data source

Live observations from AWC (5-second polling). Historical from IEM and NOAA ISD. See Data Sources for full details.