Api Endpoint

Eckari

Official National Weather Service forecast for any US coordinate - six 12-hour day/night periods by default, or hourly - each with temperature in C and F, precipitation probability, a wind speed range in km/h, wind direction and a short forecast, plus the NWS issue time so an agent can judge its age. detail=full adds the narrative, icon, dewpoint and humidity. United States, its territories and coastal waters only. Use when: What is the weather forecast for these US coordinates?

Open interactive test console

Offering

Provider
api.eckari.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Weather And Environment
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.eckari.com/v1/weather/us/forecast
MIME type
application/json
First seen
2026-10-16T01:50:14.534Z
Last seen
Tags
weather, NWS, forecast, us, geospatial

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.003 USDC
Atomic price: 3000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "3000",
    "payTo": "0x9d6b6fdB04040a55d58B24ff4C90C08cf6083C8f"
  }
]

Observed health

Status
Healthy
Latest latency
1242 ms
Average latency
1152 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number",
          "description": "Latitude in decimal degrees (WGS84). Rounded to 4 decimal places before the National Weather Service lookup.",
          "minimum": -90,
          "maximum": 90
        },
        "lon": {
          "type": "number",
          "description": "Longitude in decimal degrees (WGS84). Rounded to 4 decimal places before the National Weather Service lookup.",
          "minimum": -180,
          "maximum": 180
        },
        "hourly": {
          "type": "boolean",
          "description": "Return hourly periods instead of the default 12-hour day/night periods. Hourly periods have no name and, at detail=full, carry dewpoint and humidity.",
          "default": false
        },
        "period_limit": {
          "type": "integer",
          "description": "Maximum number of 12-hour day/night periods to return, soonest first. Applies when hourly is false; use hours for hourly forecasts. NWS issues 14 periods (7 days); the default of 6 is three days. Named period_limit, not periods, because periods is the returned series.",
          "minimum": 1,
          "maximum": 14,
          "default": 6
        },
        "hours": {
          "type": "integer",
          "description": "Number of hourly periods to return, soonest first. Applies when hourly is true; use period_limit for day/night forecasts.",
          "minimum": 1,
          "maximum": 48,
          "default": 24
        },
        "detail": {
          "type": "string",
          "enum": [
            "compact",
            "full"
          ],
          "description": "compact (default) returns the fields an agent acts on. full adds the NWS narrative (detailed_forecast), the icon URL, the trend note and, for hourly periods, dewpoint_c and humidity_pct.",
          "default": "compact"
        }
      },
      "required": [
        "lat",
        "lon"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ],
          "type": "string"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {
            "detail": {
              "default": "compact",
              "description": "compact (default) returns the fields an agent acts on. full adds the NWS narrative (detailed_forecast), the icon URL, the trend note and, for hourly periods, dewpoint_c and humidity_pct.",
              "enum": [
                "compact",
                "full"
              ],
              "type": "string"
            },
            "hourly": {
              "default": false,
              "description": "Return hourly periods instead of the default 12-hour day/night periods. Hourly periods have no name and, at detail=full, carry dewpoint and humidity.",
              "type": "boolean"
            },
            "hours": {
              "default": 24,
              "description": "Number of hourly periods to return, soonest first. Applies when hourly is true; use period_limit for day/night forecasts.",
              "maximum": 48,
              "minimum": 1,
              "type": "integer"
            },
            "lat": {
              "description": "Latitude in decimal degrees (WGS84). Rounded to 4 decimal places before the National Weather Service lookup.",
              "maximum": 90,
              "minimum": -90,
              "type": "number"
            },
            "lon": {
              "description": "Longitude in decimal degrees (WGS84). Rounded to 4 decimal places before the National Weather Service lookup.",
              "maximum": 180,
              "minimum": -180,
              "type": "number"
            },
            "period_limit": {
              "default": 6,
              "description": "Maximum number of 12-hour day/night periods to return, soonest first. Applies when hourly is false; use hours for hourly forecasts. NWS issues 14 periods (7 days); the default of 6 is three days. Named period_limit, not periods, because periods is the returned series.",
              "maximum": 14,
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "lat",
            "lon"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}