{"uid":"cap_N-_PVOMutFinWYoWCJ1aw","slug":"foundry-location-weather-evidence-be552e47","name":"Foundry Location Weather Evidence","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/location-weather-evidence","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},"alert_limit":{"type":"integer","default":5,"maximum":10,"minimum":1}}},"responseSchema":{"type":"json","example":{"route":"location-weather-evidence","result":{"alerts":[],"forecast":{"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":[]},"location":{"latitude":39.7456,"longitude":-97.0892},"provenance":{"license":"Open data free for any purpose; attribution and non-endorsement required","terms_url":"https://www.weather.gov/disclaimer","attribution":"NOAA / National Weather Service; normalized by Foundry; no endorsement","limitations":["Factual forecast and current alert evidence only; not an emergency warning service or a safety recommendation.","Sources have independent update and retrieval times; an empty alert list is not proof of safety.","Synthetic example only; no live weather claim."],"upstream_calls":3},"alerts_source":{"url":"https://api.weather.gov/alerts/active?point=39.7456%2C-97.0892","truncated":false,"updated_at":null,"retrieved_at":"2026-09-06T00:00:00Z","cache_age_seconds":0}},"observed_at":"2026-09-06T00:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tYfWR8R1ggytjRpbSbJs1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns NOAA/NWS official forecast periods and active weather alerts for a given latitude/longitude, with full source provenance, freshness metadata, and USDC micropayment pricing.","exampleAgentPrompt":"Can you pull the official NOAA weather forecast for the next 4 periods at latitude 39.7456, longitude -97.0892, including any active alerts, with full source attribution?","exampleUseCases":[{"title":"Field agent location weather check","prompt":"Get me the official NWS weather forecast for the next 6 periods at latitude 40.7128, longitude -74.0060, and flag any active weather alerts — I need the source provenance included."},{"title":"Automated logistics route weather evidence","prompt":"Fetch official weather evidence for coordinates 34.0522 latitude, -118.2437 longitude with up to 10 alert results and 8 forecast periods, so I can document conditions along our delivery route today."},{"title":"AI pipeline weather data enrichment","prompt":"Pull the NOAA forecast for lat 47.6062, lon -122.3321 — give me 3 forecast periods and any active alerts, I need the freshness timestamps and upstream source URL for our audit trail."}],"resultDescription":"A JSON object containing: normalized NWS forecast periods (name, startTime, endTime, temperature, temperatureUnit, windSpeed, windDirection, shortForecast, isDaytime), active weather alerts for the point, location echo (lat/lon), provenance block (license, attribution, terms URL, upstream call count, limitations), freshness metadata (retrievedAt, cacheAgeSeconds, state), and the upstream NWS source URL.","failureModes":["Coordinates outside NWS coverage area (e.g. non-US locations) may return empty or error results","NWS API upstream outage returns a degraded or error response","Invalid latitude/longitude range (outside -90 to 90 or -180 to 180) rejected by input schema","Empty alert list does not guarantee safety — explicitly noted in provenance limitations","Cache may serve data up to 30 seconds old; freshness state field indicates if retrieval is live","Payment failure (insufficient USDC) returns HTTP 402 before any weather data is retrieved"],"whenToPreferThis":"Choose this endpoint when you need official, source-attributed US weather forecasts and active alerts with explicit provenance metadata, freshness timestamps, and a fixed per-call USDC micropayment price. Prefer it over generic weather APIs when auditability, source licensing, and machine-readable provenance are required — for example in AI pipelines, compliance workflows, or evidence-gathering agents. Not suitable for non-US locations, emergency safety warnings, or high-frequency polling due to per-call cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:42:33.969Z","isFirstParty":false}