# Saylor Innovations River Flood Forecast

> Saylor Innovations River Flood Forecast is a paid API for AI agents from saylorinnovations.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

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

## Facts

- Endpoint: GET https://saylorinnovations.com/api/water/river-forecast?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/saylor-innovations-river-flood-forecast-6e5f89d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GLQDM38qXCMtDC_aIw0_9

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 saylor-innovations-river-flood-forecast-6e5f89d1
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## 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",
      "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",
       "descriptio
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/saylor-innovations-river-flood-forecast-6e5f89d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from saylorinnovations.com](https://www.zero.xyz/host/saylorinnovations.com/llms.txt)