Current weather snapshot

Endpoint

https://apiacre.com/v1/data/current-weather

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.

Official 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.001 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/current-weather \
  -X POST \
  -d '{"city":"Washington, DC, US"}' \
  --max-amount 1000 \
  --json

Coinbase pay-for-service documentation · Buyer setup and wallet safety

npx --yes agentcash@latest check https://apiacre.com/v1/data/current-weather
npx --yes agentcash@latest fetch https://apiacre.com/v1/data/current-weather \
  --method POST \
  --header 'content-type: application/json' \
  --body '{"city":"Washington, DC, US"}' \
  --payment-protocol x402 \
  --payment-network base \
  --max-amount 0.001

Input example

{
  "city": "Washington, DC, US"
}

Response shape

View free static sample JSON

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.current-weather",
  "version": "1",
  "data": {
    "location": {
      "latitude": 38.8951,
      "longitude": -77.0364,
      "city": "Washington",
      "state": "DC",
      "timezone": "America/New_York",
      "grid": null,
      "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/"
      }
    },
    "current": {
      "dataKind": "observation",
      "effectiveAt": "2026-08-20T09:52:00+00:00",
      "condition": "Mostly Cloudy",
      "conditionCode": null,
      "temperatureC": 24.4,
      "dewpointC": 21.1,
      "relativeHumidityPercent": 81,
      "windSpeedMps": 2.58,
      "windGustMps": null,
      "windFromDirectionDegrees": 250,
      "visibilityM": 16090,
      "airPressureHpa": null,
      "cloudAreaFractionPercent": null,
      "precipitationAmountMm": null,
      "precipitationPeriodHours": null
    },
    "source": {
      "provider": "NOAA/National Weather Service",
      "dataset": "NWS nearest-station latest observation",
      "dataKind": "observation",
      "stationId": "KDCA",
      "stationName": "Washington/Reagan National Airport, DC",
      "sourceUrl": "https://api.weather.gov/stations/KDCA/observations/latest",
      "pointsUrl": "https://api.weather.gov/points/38.8951,-77.0364",
      "documentationUrl": "https://www.weather.gov/documentation/services-web-api",
      "termsUrl": "https://www.weather.gov/disclaimer",
      "licenseUrl": null,
      "modelRunUpdatedAt": null,
      "fallbackReason": null,
      "upstreamAccess": "free open data",
      "attribution": "Weather observation: 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 selected the nearest station returned by NWS, validated the observation timestamp, and normalized supported measurements to SI units; no model values were substituted."
    },
    "retrievedAt": "2026-08-20T10:00:00+00:00",
    "cacheTtlSeconds": 900,
    "limitations": [
      "Place-name resolution uses the bundled GeoNames cities500 index, ranked by exact-name quality and population; inspect resolvedPlace and qualify ambiguous names. NWS station observations are available only within supported U.S. coverage.",
      "The nearest reporting station may be some distance from the requested point, and observations can be delayed or incomplete.",
      "Null fields mean the station omitted a supported measurement; API Acre does not estimate missing observation values.",
      "This snapshot excludes forecasts and alerts and must not be used alone for life-safety, aviation, marine, or emergency decisions."
    ]
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "data.us-weather-forecast",
        "title": "Global weather forecast",
        "reason": "Extend the point-in-time snapshot with a separately authorized global hourly forecast.",
        "method": "POST",
        "path": "/v1/data/us-weather-forecast",
        "price": "$0.003",
        "input_template": {
          "latitude": "$result.data.location.latitude",
          "longitude": "$result.data.location.longitude",
          "forecast_type": "hourly",
          "units": "si",
          "periods": 6,
          "include_current_conditions": false,
          "include_active_alerts": false
        },
        "use_output": "Treat this as a separate paid request. Use the snapshot's source and effectiveAt for current conditions and the forecast periods for outlooks.",
        "handoff_path": "/catalog/data.us-weather-forecast",
        "checkout_path": "/try/data.us-weather-forecast",
        "sample_path": "/samples/data.us-weather-forecast",
        "maximum_atomic_usdc": "3000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      }
    ]
  }
}

Continue this workflow

These optional follow-ups use this result in a larger workflow. Each call shows a fresh x402 challenge and requires separate buyer authorization.

Try the payment challenge

curl -i -X POST 'https://apiacre.com/v1/data/current-weather' \
  -H 'content-type: application/json' \
  --data '{"city":"Washington, DC, US"}'