Api Endpoint

api-staging.eckari.com

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-staging.eckari.com
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Financial Analysis
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://api-staging.eckari.com/v1/weather/us/forecast
MIME type: application/json
First seen: 2026-10-16T03:02:07.735Z
Last seen: 2026-11-02T17:06:14.077Z
Tags: weather, NWS, forecast, us, geospatial

Website

Payment pricing

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

Payment option 1: 0.003 USDC
Atomic price: 3000 · Network: eip155:84532 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:84532",
    "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
    "amount": "3000",
    "payTo": "0x7c0Ba1d16322Ee426D6508a74b571Dd73A5a35DA"
  }
]

Observed health

Status: Healthy
Latest latency: 536 ms
Average latency: 930 ms
HTTP status: 402
Last checked: 2026-11-02T17:06:14.071Z
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

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object"
    }
  },
  "required": [
    "type"
  ]
}