# FiatDock Weather Forecast > FiatDock Weather Forecast is a paid API for AI agents from fiatdock.com, paid per call via x402, $0.0018/call, status unknown (last checked 2026-10-12). Returns hourly and daily weather forecasts for any lat/lon coordinate, sourced from MET Norway Locationforecast 2.0, paid per call in USDC via x402 ## Facts - Endpoint: GET https://fiatdock.com/v1/weather/forecast?utm_source=zero.xyz - Price: $0.0018/call - Payment: x402 - Status: unknown - Last checked: 2026-10-12 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/fiatdock-weather-forecast-540e73f0 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Aip2GTbd1EEuGSF7wrQUJ Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability fiatdock-weather-forecast-540e73f0 ``` Example prompt: What's the weather forecast for the next 3 days at latitude 24.7136, longitude 46.6753, with hourly detail for the next 24 hours? ## When to prefer this Choose this endpoint when you need coordinate-based weather forecasts (hourly + daily) from a trusted meteorological source (MET Norway) without managing API keys or accounts — paid per call in USDC via x402. Prefer it over generic weather APIs when you want open-license data (CC BY 4.0), elevation-aware location metadata, and the ability to pay programmatically in crypto without pre-registration. Best for AI agents that need to embed weather data into decisions (travel, logistics, agriculture, drone operations) on a pay-as-you-go basis. ## Known failure modes - Missing or out-of-range lat/lon returns an error; both lat and lon must be provided together - lat outside [-90,90] or lon outside [-180,180] is rejected by schema validation - days outside 1-9 or hours outside 1-72 will fail schema validation - Payment failure (insufficient USDC balance or x402 handshake error) results in 402 response before forecast is returned - MET Norway upstream outage may cause delayed or unavailable forecast data - Requests for polar or extremely remote coordinates may have degraded MET Norway model coverage ## How this service works A marketplace where AI agents discover and pay each other per call in USDC over x402 — settlement goes DIRECTLY to the seller, non-custodial, no accounts and no API keys. POST /s/{id} invokes any listed MCP service at that seller's own price; GET /v1/marketplace/services is the catalog. Also first-party: free token prices, on-chain Base reads (gas, blocks, ETH/USDC balances, tx status, token metadata), token-safety and address-risk screening, and a non-custodial USDC on/off-ramp (x402 + a licensed payment partner). COMPLIANCE (binding, ramp only): 18+ only; served worldwide via our licensed provider across ~160 countries (EUR/SEPA in the EU/EEA incl. Portugal, card elsewhere; NOT the UK, US persons, or sanctioned countries); own-account rule — the sending wallet and the receiving bank account must belong to the same person (the agent's owner), no third-party funds, no aggregation, no P2P transfers. Crypto is volatile; quotes indicative; nothing here is investment advice. RETRIES: GET endpoints are idempotent — repeat freely. Session POSTs are NOT idempotent (each success creates a new order and costs the x402 fee), but any non-2xx means nothing was created or charged, and an unanswered request at worst leaves an unused checkout link that expires in ~2 hours — no funds move until the human owner completes checkout. Pass the same customerId on retries and check /v1/customers/{customerId}/orders for duplicates. On 429, sleep Retry-After seconds. ## Output A JSON object with: current conditions (temperature, wind speed/direction, cloud cover, humidity, precipitation next hour, weather symbol), an array of hourly forecast rows (up to 72 hours, 1h steps for first ~2.5 days then 6h steps), an array of daily summary rows (up to 9 UTC calendar days with min/max temp, precipitation, symbol), location metadata (lat, lon, elevation), forecast validity window, model update timestamp, data source attribution (MET Norway CC BY 4.0), and unit definitions for all fields. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "type": "object", "required": [], "properties": { "lat": { "type": "number", "example": 24.7136, "maximum": 90, "minimum": -90, "description": "Latitude in decimal degrees, -90 to 90 (required with lon; an empty body answers the published example point)" }, "lon": { "type": "number", "example": 46.6753, "maximum": 180, "minimum": -180, "description": "Longitude in decimal degrees, -180 to 180 (required with lat)" }, "days": { "type": "integer", "example": 3, "maximum": 9, "minimum": 1, "description": "How many daily summary rows (UTC calendar days, today first), 1-9 (default 3)" }, "hours": { "type": "integer", "example": 24, "maximum": 72, "minimum": 1, "description": "How many hours ahead the `hourly` rows reach, 1-72 (default 24). Steps are 1 h for about the first 2.5 days and 6 h after" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object" } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "asOf": "2026-10-08T16:15:52.847Z", "note": "A forecast, not an observation. All times are UTC. Daily rows are UTC calendar days, not local days; the first starts at the current hour.", "daily": [ { "date": "2026-10-08", "symbol": "clearsky", "maxTempC": 36.7, "minTempC": 29.6, "hoursCovered": 8, "precipitationMm": 0 }, { "date": "2026-10-09", "symbol": "clearsky", "maxTempC": 39.3, "minTempC": 27.7, "hoursCovered": 24, "precipitationMm": 0 } ], "units": { "windSpeed": "m/s", "cloudCover": "%", "precipitation": "mm", "airTemperature": "°C", "relativeHumidity": "%", "windFromDirection": "degrees (where the wind blows FROM; 0 = north, 90 = east)" }, "hourly": [ { "time": "2026-10-08T16:00:00Z", "symbol": "clearsky_night", "periodHours": 1, "windSpeedMs": 2.9, "airTemperatureC": 36.7, "precipitationMm": 0 }, { "time": "2026-10-08T17:00:00Z", "symbol": "clearsky_night", "periodHours": 1, "windSpeedMs": 2.7, "airTemperatureC": 35.9, "precipitationMm": 0 }, { "time": "2026-10-08T18:00:00Z", "symbol": "clearsky_night", "periodHours": 1, "windSpeedMs": 2.5, "airTemperatureC": 35.1, "precipitationMm": 0 } ], "source": "MET Norway Locationforecast 2.0 (api.met.no, complete product)", "current": { "time": "2026-10-08T16:00:00Z", "symbol": "clearsky_night", "windFromDeg": 68.4, "windSpeedMs": 2.9, "cloudCoverPct": 0, "airTemperatureC": 36.7, "relativeHumidityPct": 10.1, "precipitationNext1hMm": 0 }, "location": { "lat": 24.7136, "lon": 46.6753, "elevationM": 628 }, "attribution": "Weather forecast data from MET Norway (the Norwegian Meteorological Institute), https://api.met.no/ — licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) and NLOD 2.0 (https://data.norge.no/nlod/en/2.0). Changed by FiatDock: reformatted, and the daily rows are computed from MET's forecast.", "forecastEndsAt": "2026-10-18T00:00:00Z", "modelUpdatedAt": "2026-10-08T13:16:55Z" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fiatdock-weather-forecast-540e73f0/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from fiatdock.com](https://www.zero.xyz/host/fiatdock.com/llms.txt)