Free static example · no wallet required
Global weather forecast
Inspect the exact response envelope first. When you need current analysis for your own input, one successful x402 call costs $0.003 USDC on Base or Solana.
No accountNo subscriptionExact USDC priceFresh calls only are paid
Full response envelope
What you receive
Demonstration data only. The paid endpoint returns a fresh result and settlement receipt.
{
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "data.us-weather-forecast",
"version": "1",
"data": {
"location": {
"latitude": 38.8951,
"longitude": -77.0364,
"city": "Washington",
"state": "DC",
"timezone": "America/New_York",
"grid": {
"office": "LWX",
"x": 97,
"y": 71
},
"resolvedPlace": {
"query": "Washington, DC, US",
"geonameId": 4140963,
"name": "Washington",
"countryCode": "US",
"admin1Code": "DC",
"candidateCount": 1,
"ambiguous": false,
"attribution": "GeoNames (CC BY 4.0; https://www.geonames.org/).",
"licenseUrl": "https://creativecommons.org/licenses/by/4.0/"
}
},
"forecastType": "day_night",
"units": "us",
"generatedAt": "2026-08-12T03:09:21+00:00",
"updatedAt": null,
"periodCount": 2,
"periodsTruncated": true,
"periods": [
{
"number": 1,
"name": "Tonight",
"startTime": "2026-08-11T23:00:00-04:00",
"endTime": "2026-08-12T06:00:00-04:00",
"isDaytime": false,
"temperature": 72,
"temperatureUnit": "F",
"temperatureTrend": null,
"probabilityOfPrecipitationPercent": 23,
"relativeHumidityPercent": 87,
"dewpoint": {
"value": 22.2,
"unitCode": "wmoUnit:degC"
},
"windSpeed": "5 mph",
"windDirection": "W",
"shortForecast": "Slight Chance Showers And Thunderstorms",
"detailedForecast": "A slight chance of showers and thunderstorms. Mostly cloudy, with a low around 72. West wind around 5 mph."
},
{
"number": 2,
"name": "Wednesday",
"startTime": "2026-08-12T06:00:00-04:00",
"endTime": "2026-08-12T18:00:00-04:00",
"isDaytime": true,
"temperature": 88,
"temperatureUnit": "F",
"temperatureTrend": null,
"probabilityOfPrecipitationPercent": 12,
"relativeHumidityPercent": 62,
"dewpoint": {
"value": 20.6,
"unitCode": "wmoUnit:degC"
},
"windSpeed": "6 mph",
"windDirection": "NW",
"shortForecast": "Partly Sunny",
"detailedForecast": "Partly sunny, with a high near 88. Northwest wind around 6 mph."
}
],
"currentConditions": {
"requested": true,
"available": true,
"stationId": "KDCA",
"stationName": "Washington/Reagan National Airport, DC",
"observedAt": "2026-08-12T03:52:00+00:00",
"description": "Mostly Cloudy",
"temperature": {
"value": 24.4,
"unitCode": "wmoUnit:degC"
},
"dewpoint": {
"value": 21.1,
"unitCode": "wmoUnit:degC"
},
"relativeHumidityPercent": 81,
"heatIndex": {
"value": 25.1,
"unitCode": "wmoUnit:degC"
},
"windChill": null,
"windDirection": {
"value": 250,
"unitCode": "wmoUnit:degree_(angle)"
},
"windSpeed": {
"value": 9.3,
"unitCode": "wmoUnit:km_h-1"
},
"windGust": null,
"visibility": {
"value": 16090,
"unitCode": "wmoUnit:m"
},
"sourceUrl": "https://api.weather.gov/stations/KDCA/observations/latest",
"warning": null
},
"activeAlerts": {
"requested": true,
"available": true,
"updatedAt": "2026-08-12T04:09:00+00:00",
"alertCount": 0,
"alertsTruncated": false,
"alerts": [],
"sourceUrl": "https://api.weather.gov/alerts/active?point=38.8951%2C-77.0364&status=actual&limit=10",
"warning": null
},
"source": {
"provider": "NOAA/National Weather Service",
"dataset": "NWS API forecast with optional observations and active alerts",
"pointsUrl": "https://api.weather.gov/points/38.8951,-77.0364",
"forecastUrl": "https://api.weather.gov/gridpoints/LWX/97,71/forecast?units=us",
"documentationUrl": "https://www.weather.gov/documentation/services-web-api",
"disclaimerUrl": "https://www.weather.gov/disclaimer",
"upstreamAccess": "free open data",
"attribution": "Weather data: NOAA/National Weather Service. Place coordinates resolved from GeoNames under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/); source: https://www.geonames.org/.",
"transformation": "API Acre normalized selected NWS fields; this response is not an official government product and does not imply NOAA/NWS endorsement."
},
"retrievedAt": "2026-08-12T04:10:00+00:00",
"limitations": [
"Place-name resolution uses the bundled GeoNames cities500 index, ranked by exact-name quality and population; inspect resolvedPlace and qualify ambiguous names. Coverage is limited to locations supported by the United States National Weather Service, including supported U.S. territories.",
"Current conditions, when requested, come from the nearest available reporting station and observations may be delayed.",
"Internet delivery and timeliness are not guaranteed. For life-safety decisions, check current official alerts and NWS dissemination channels.",
"Active alerts are a bounded point-in-time subset; radar and historical weather are not included."
]
},
"meta": {
"duration_ms": 42,
"cached": false,
"sources": [],
"warnings": [],
"next_actions": []
}
}Example request
Input JSON
{
"place": "Washington, DC, US",
"periods": 2,
"include_current_conditions": true,
"include_active_alerts": true
}Delivery contract
One paid POST
Get a global weather forecast for a city/locality name or exact coordinates. Returns normalized day/night or hourly periods worldwide: NOAA/NWS is preferred within supported U.S. coverage for optional station conditions and active alerts, while MET Norway provides an attributed open-data fallback globally.
POST /v1/data/us-weather-forecast
Need current data?
Run this exact service.
The checkout verifies the request, selected network, USDC asset, recipient, and price before opening a wallet.