{"uid":"cap_lsuvmI-4N-Cl27vY0Ft3H","slug":"foundry-nws-forecast-2f34bda7","name":"Foundry NWS Forecast","description":"Pay-per-request evidence and data tools: CSV validation and reconciliation, DNS/email configuration evidence, and bounded official weather, earthquake, vehicle, company and study records. Exact USDC prices, explicit JSON contracts and source provenance. No mailbox, ownership, medical or safety guarantees.","url":"https://foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/v2/official/nws-forecast","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"periods":{"type":"integer","default":6,"maximum":14,"minimum":1},"latitude":{"type":"number","maximum":90,"minimum":-90},"longitude":{"type":"number","maximum":180,"minimum":-180}}},"responseSchema":{"type":"json","example":{"route":"nws-forecast","result":{"query":{"periods":4,"latitude":39.7456,"longitude":-97.0892},"source":"National Weather Service","freshness":{"state":"CURRENT_RETRIEVAL","retrievedAt":"2026-09-06T00:00:00Z","cacheAgeSeconds":0,"maximumCacheSeconds":30,"recordAgeIsNotRetrievalAge":true},"sourceUrl":"https://api.weather.gov","observedAt":"2026-09-06T00:00:00Z","provenance":{"license":"Open data free for any purpose; attribution and non-endorsement required","termsUrl":"https://www.weather.gov/disclaimer","truncated":false,"attribution":"NOAA / National Weather Service; normalized by Foundry; no endorsement","limitations":["Synthetic example only; identifiers and null values illustrate fields, not a live observation."],"modifications":"Selected factual fields, normalized names and bounded result count; no source ownership claimed.","upstreamCalls":1,"documentationUrl":"https://www.weather.gov/documentation/services-web-api"},"sourceUpdatedAt":null,"normalizedResult":[{"name":null,"number":null,"endTime":null,"isDaytime":null,"startTime":null,"windSpeed":null,"temperature":null,"shortForecast":null,"windDirection":null,"temperatureUnit":null}],"sourceProcessedAt":null,"rawSourceIdentifiers":[]},"observed_at":"2026-09-06T00:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1JQKh9wZfaCY4SOrMpkpt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a US latitude/longitude coordinate to the current National Weather Service forecast, returning a bounded number of forecast periods with source freshness metadata.","exampleAgentPrompt":"What's the NWS forecast for the next 4 periods at latitude 39.7456, longitude -97.0892? Pull the official National Weather Service data for that location.","exampleUseCases":[{"title":"Outdoor event weather check","prompt":"Can you get me the next 6 forecast periods from the National Weather Service for coordinates 40.7128, -74.0060? I need to know if it'll be safe to hold an outdoor event there."},{"title":"Agricultural field planning","prompt":"Fetch the NWS weather forecast for lat 36.1627, lon -86.7816 — give me the next 10 periods so I can plan irrigation this week."},{"title":"Real-time travel route weather","prompt":"I'm driving through Kansas tomorrow — can you grab the official National Weather Service forecast for 38.9717, -95.2353? Just the next 3 periods is fine."}],"resultDescription":"Returns a JSON object containing the queried coordinates and period count, forecast periods normalized from NWS data, source attribution (NOAA/NWS), freshness metadata including retrieval timestamp and cache age, the upstream NWS API URL, and provenance details including license and terms. The normalizedResult array contains the bounded forecast periods requested.","failureModes":["Coordinates outside the US or US territories may return no forecast data (NWS only covers US)","Invalid latitude/longitude values (outside -90/90 or -180/180) will be rejected by schema validation","Periods value exceeding 14 or below 1 will be rejected","NWS upstream API unavailability may result in errors or stale cached data","Coordinates in ocean or remote areas without NWS grid coverage may return empty results","Payment failure (x402) will block access before forecast is returned"],"whenToPreferThis":"Prefer this endpoint when you need official US government NWS forecast data for a specific geographic point identified by latitude/longitude. Choose this over general weather APIs when you need authoritative NOAA-sourced forecasts with explicit provenance, attribution, and freshness metadata. Ideal for agents that need to prove the forecast came from an official source, or when operating in a context where open-data government attribution is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:23.759Z","isFirstParty":false}