{"uid":"cap_y-MicY_EFNj5EnAQN0NEq","slug":"us-weather-risk-api-f7b2c7ab","name":"US Weather Risk API","description":"US operational weather-risk decision API for agents. Submit a US latitude/longitude, 6-72 hour horizon, and operational profile to receive a deterministic 0-100 risk score, level, hazard reasons, freshness, and provenance derived from public National Weather Service forecasts, observations, and alerts where available. Unlike a raw weather forecast, the response combines wind, precipitation, temperature, visibility, severe weather, and data-quality signals into a machine-readable decision input. Successful calls cost 0.005 USDC.","url":"https://api.weatherriskapi.com/v1/us-weather-risk?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"profile":{"enum":["general","travel","delivery","outdoor"],"type":"string","default":"general","description":"Operational weighting: general, travel, delivery, or outdoor."},"latitude":{"type":"number","maximum":90,"minimum":-90,"multipleOf":0.000001,"description":"Latitude in decimal degrees for an NWS-supported US location."},"longitude":{"type":"number","maximum":180,"minimum":-180,"multipleOf":0.000001,"description":"Longitude in decimal degrees for an NWS-supported US location."},"horizonHours":{"enum":[6,12,24,48,72],"type":"integer","default":24,"description":"Look-ahead window: 6-12 hours for imminent actions, 24 for next-day planning, 48-72 for multi-day screening."}}},"responseSchema":{"type":"json","example":{"reasons":[{"code":"wind","summary":"Forecast wind exceeds the delivery profile threshold.","evidence":{"unit":"mph","value":30,"source":"forecast","endTime":"2026-10-04T13:00:00.000Z","sourceId":null,"startTime":"2026-10-04T12:00:00.000Z","threshold":"windSpeedMph >= 30"},"component":"wind","contribution":25}],"sources":[{"url":"https://api.weather.gov/points/38,-122","kind":"points","retrievedAt":"2026-10-04T11:55:00.000Z","upstreamUpdatedAt":null}],"freshness":{"alerts":"fresh","points":"fresh","forecast":"fresh","observation":"fresh"},"riskLevel":"moderate","riskScore":36}},"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_SnN8my7fdEQDzscTQoakA","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":"Returns a deterministic 0-100 weather risk score with hazard reasons and severity level for a US location, forecast horizon, and operational profile, derived from National Weather Service data.","exampleAgentPrompt":"What's the weather risk score at latitude 37.7749, longitude -122.4194 for the next 24 hours using the delivery profile?","exampleUseCases":[{"title":"Drone delivery route safety check","prompt":"Before we dispatch the afternoon drone deliveries from our Oakland warehouse, can you pull the weather risk score for latitude 37.8044, longitude -122.2712 over the next 6 hours using the delivery profile? Flag it if the risk is anything above low."},{"title":"Pre-event outdoor venue screening","prompt":"We're planning an outdoor concert at Zilker Park in Austin — can you check the weather risk score for latitude 30.2672, longitude -97.7431 over the next 48 hours using the outdoor profile, and tell me what the main hazard reasons are?"},{"title":"Multi-day field crew scheduling","prompt":"Our construction crews need to work at a site near Denver, latitude 39.7392, longitude -104.9903 — can you run a 72-hour weather risk assessment using the general profile so we can decide whether to schedule the pours this week?"}],"resultDescription":"A JSON object containing: a numeric riskScore (0-100), a riskLevel label (e.g. 'moderate'), an array of reasons each with a hazard code, human-readable summary, evidence details (value, threshold, unit, time window, source), and per-component contribution score; plus a sources array with upstream NWS URLs and retrieval timestamps, and a freshness map indicating staleness of alerts, points, forecast, and observation data.","failureModes":["Location outside NWS coverage area (non-US coordinates) — API returns an error indicating unsupported location","NWS upstream data unavailable or stale — freshness fields will indicate 'stale' or missing, risk score may reflect degraded confidence","Invalid latitude/longitude values outside allowed range — schema validation error","Unsupported horizonHours value outside the enum set — schema validation error","Payment failure (insufficient USDC balance) — x402 payment required error before scoring occurs"],"whenToPreferThis":"Choose this endpoint when you need a single machine-readable risk number and structured hazard reasons for a US location, rather than raw forecast data you'd have to interpret yourself. It is purpose-built for operational decision-making by AI agents and automation pipelines — ideal when the agent needs to make a go/no-go decision based on weather without building its own multi-factor scoring logic. Prefer it over raw NWS API calls when you need normalized, profile-weighted scores that combine wind, precipitation, temperature, visibility, and alerts into one signal. Best for delivery, logistics, outdoor operations, and travel use cases where interpretable hazard reasons matter as much as the score itself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:31:50.325Z","isFirstParty":false,"canonicalSlug":"us-weather-risk-api-f7b2c7ab"}