US weather forecast

Endpoint

https://apiacre.com/v1/data/us-weather-forecast

Send 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.

Agent one-call path

Optional third-party AgentCash can inspect this route and handle the x402 retry. Its fetch command may automatically pay, so this example caps the call at exactly $0.003 USDC. Copying the command does not pay; review the local wallet and request before running it.

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 '{"latitude":38.8977,"longitude":-77.0365,"forecast_type":"day_night","units":"us","periods":2}' \
  --payment-protocol x402 \
  --payment-network base \
  --max-amount 0.003

AgentCash CLI documentation · Official SDK and wallet-safety alternatives

Input example

{
  "latitude": 38.8977,
  "longitude": -77.0365,
  "forecast_type": "day_night",
  "units": "us",
  "periods": 2
}

Response shape

View free static sample JSON

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.us-weather-forecast",
  "version": "1",
  "data": {
    "location": {
      "latitude": 38.8977,
      "longitude": -77.0365,
      "city": "Washington",
      "state": "DC",
      "timezone": "America/New_York",
      "grid": {
        "office": "LWX",
        "x": 97,
        "y": 71
      }
    },
    "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."
      }
    ],
    "source": {
      "provider": "NOAA/National Weather Service",
      "dataset": "NWS API forecast",
      "pointsUrl": "https://api.weather.gov/points/38.8977,-77.0365",
      "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": "Forecast data: NOAA/National Weather Service.",
      "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": [
      "Coverage is limited to locations supported by the United States National Weather Service, including supported U.S. territories.",
      "This result contains forecast periods only; it does not include active alerts, current observations, radar, or historical weather.",
      "Internet delivery and timeliness are not guaranteed. For life-safety decisions, check current official alerts and NWS dissemination channels.",
      "Inspect generatedAt, retrievedAt, and local conditions before relying on the forecast."
    ]
  },
  "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 '{"latitude":38.8977,"longitude":-77.0365,"forecast_type":"day_night","units":"us","periods":2}'