Global weather forecast
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.
$0.003 USDCBase + Solanax402 v2POST
Endpoint
https://apiacre.com/v1/data/us-weather-forecastSend the JSON body below. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header; an x402-compatible buyer signs the requirement and retries with PAYMENT-SIGNATURE.
Pay $0.003 USDC and run in your browserOfficial Coinbase agent path
Coinbase Agentic Wallet can satisfy this x402 request in one command. Running it may pay automatically, so --max-amount is fixed to $0.003 USDC in atomic units. Copying the command does not install, authenticate, sign, or pay; review the request and use a separate low-value wallet before running it.
npx --yes awal@latest x402 pay https://apiacre.com/v1/data/us-weather-forecast \
-X POST \
-d '{"place":"Washington, DC, US","periods":2,"include_current_conditions":true,"include_active_alerts":true}' \
--max-amount 3000 \
--jsonCoinbase pay-for-service documentation · Buyer setup and wallet safety
Alternative third-party AgentCash commands
Run check first without payment. Its fetch command may automatically pay up to the exact listed price.
npx --yes agentcash@latest check https://apiacre.com/v1/data/us-weather-forecast
npx --yes agentcash@latest fetch https://apiacre.com/v1/data/us-weather-forecast \
--method POST \
--header 'content-type: application/json' \
--body '{"place":"Washington, DC, US","periods":2,"include_current_conditions":true,"include_active_alerts":true}' \
--payment-protocol x402 \
--payment-network base \
--max-amount 0.003Input example
{
"place": "Washington, DC, US",
"periods": 2,
"include_current_conditions": true,
"include_active_alerts": true
}Response shape
{
"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": []
}
}Try the payment challenge
curl -i -X POST 'https://apiacre.com/v1/data/us-weather-forecast' \
-H 'content-type: application/json' \
--data '{"place":"Washington, DC, US","periods":2,"include_current_conditions":true,"include_active_alerts":true}'