{"uid":"cap_GLQDM38qXCMtDC_aIw0_9","slug":"saylor-innovations-river-flood-forecast-6e5f89d1","name":"Saylor Innovations River Flood Forecast","description":"River flood forecast - modelled river discharge for the next 10 days on the largest river cell within 5 km of a coordinate, with seasonal comparison, trend and flood signal","url":"https://saylorinnovations.com/api/water/river-forecast?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","POST","PUT","PATCH","DELETE","HEAD"],"type":"string"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"string","description":"Latitude in decimal degrees, e.g. 40.71"},"lon":{"type":"string","description":"Longitude in decimal degrees, e.g. -74.01"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["daily"],"properties":{"note":{"type":["string","null"],"description":"Caveat or context for reading the result"},"daily":{"type":"array","items":{"type":"object"},"description":"Daily values"},"trend":{"type":["string","null"],"description":"Direction of recent change"},"source":{"type":["string","null"],"description":"Data source the values come from"},"location":{"description":"Place the data refers to"},"peak_date":{"type":["string","null"],"description":"Peak date"},"checked_at":{"type":["string","null"],"description":"Time the check was run (UTC)"},"flood_signal":{"type":["string","null"],"description":"Flood signal"},"cells_compared":{"type":["number","null"],"description":"Cells compared"},"peak_discharge_m3s":{"type":["number","null"],"description":"Peak discharge m3s"},"current_discharge_m3s":{"type":"number","description":"Current discharge m3s"},"peak_vs_seasonal_mean_x":{"type":["number","null"],"description":"Peak vs seasonal mean x"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lWEYEMWwBjjWo3FeCbuCx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a 10-day modelled river discharge forecast with flood signal, trend, seasonal comparison, and peak discharge for the nearest major river cell within 5 km of given coordinates","exampleAgentPrompt":"What's the 10-day river discharge forecast and flood signal for the area near latitude 40.71, longitude -74.01? I want to know if there's a flood risk and how current flow compares to the seasonal average.","exampleUseCases":[{"title":"Flood risk check for field crew","prompt":"Before we send the crew out to the site near 47.60° N, 122.33° W, can you check the 10-day river forecast and tell me if there's any flood signal or dangerous discharge trend we should know about?"},{"title":"Property flood monitoring alert","prompt":"I have a property near latitude 51.50, longitude -0.12 — can you pull the river discharge forecast for the next 10 days and let me know if the flood signal is elevated or the trend is worsening?"},{"title":"Seasonal flood comparison for research","prompt":"I'm studying seasonal river behavior near 48.85, 2.35. Can you get me the 10-day modelled discharge forecast and show me how the peak discharge compares to the seasonal mean?"}],"resultDescription":"A JSON object containing an array of daily modelled river discharge values for the next 10 days, current discharge in m³/s, peak discharge in m³/s and its date, a flood signal string, a trend direction string, the ratio of peak discharge to the seasonal mean, the number of river cells compared, the data source, the geographic location the data refers to, the time the check was run, and an optional note providing context or caveats.","failureModes":["No river cell found within 5 km of the given coordinates — returns a null or empty result for a location not near a modelled river","Invalid or out-of-range latitude/longitude values — API may return an error or unexpected result","Forecast model data temporarily unavailable — may return a null daily array or error response","Payment not processed — x402 payment required before data is returned","Coordinates in ocean or extremely remote areas with no modelled river cells — returns empty or null discharge data"],"whenToPreferThis":"Use this endpoint when you need hydrological river discharge forecasts specifically — not general weather, not rainfall, but modelled river flow data. It is ideal when you need flood risk signals, discharge trends, and seasonal comparisons for a specific geographic point. Prefer this over weather APIs when the downstream concern is river flooding rather than atmospheric conditions. It covers a 10-day forward window with a seasonal context, making it better suited for operational flood risk assessment than historical or real-time-only stream gauge APIs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:41:07.093Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-river-flood-forecast-6e5f89d1"}