# greeneris-data-hydro-river-discharge

> greeneris-data-hydro-river-discharge is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns daily river discharge forecasts (m³/s) for a given geographic point using GloFAS/Open-Meteo Flood API data

## Facts

- Endpoint: GET https://data.greeneris.io/v1/hydro/river
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/greeneris-data-hydro-river-discharge-726f6ced
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__XGSzO1Cf4FbDB4kNeTE6

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 greeneris-data-hydro-river-discharge-726f6ced
```

Example prompt: What's the river discharge forecast for the next 7 days at latitude 45.775, longitude 4.875 — give me both the daily discharge and the daily maximum?

## When to prefer this

Use this endpoint when you need authoritative, forecast-horizon hydrological data (river discharge in m³/s) sourced from the official GloFAS/Copernicus dataset for any geographic point on Earth. Prefer this over generic weather APIs when the specific need is river flow volume rather than precipitation or temperature. Ideal for flood risk assessment, infrastructure planning near waterways, or environmental monitoring workflows. The pay-per-call x402 model means no subscription is required.

## Known failure modes

- HTTP 402 returned if payment not yet made — endpoint returns a machine-readable USDC price quote for retry via x402 protocol
- Invalid or out-of-range latitude/longitude returns an error (must be -90..90 and -180..180)
- forecast_days exceeding 210 returns a validation error
- No river data available at the given coordinates (e.g. open ocean or remote land with no modeled river) may return empty or zero discharge values
- Invalid daily variable name returns an error

## How this service works

Daily river discharge forecast from the Copernicus GloFAS model (5 km grid) served via Open-Meteo Flood API, data CC-BY 4.0. Query: ?latitude=45.75&longitude=4.85&forecast_days=7 (1-210 days; daily=river_discharge,river_discharge_max for extra variables). Returns ISO date + m3/s arrays -- flood risk, inland shipping (Rhine/Danube) and hydropower planning. 6h cache.

## Output

A JSON object with a daily time series of river discharge values in m³/s (and optionally max discharge) for the requested coordinates and forecast horizon, along with the data source attribution (GloFAS/Copernicus via Open-Meteo, CC-BY 4.0), resolved latitude/longitude, and unit metadata.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "latitude",
      "longitude"
     ],
     "properties": {
      "daily": {
       "type": "string",
       "default": "river_discharge",
       "description": "Comma-separated variables, e.g. river_discharge,river_discharge_max"
      },
      "latitude": {
       "type": "number",
       "description": "Latitude of a point on a river (-90..90)"
      },
      "longitude": {
       "type": "number",
       "description": "Longitude of a point on a river (-180..180)"
      },
      "forecast_days": {
       "type": "integer",
       "default": 7,
       "maximum": 210,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "daily": {
   "time": [
    "2026-07-13",
    "2026-07-14",
    "2026-07-15"
   ],
   "river_discharge": [
    296.17,
    290.07,
    281.49
   ]
  },
  "source": "GloFAS (Copernicus Emergency Management Service) via Open-Meteo Flood API, CC-BY 4.0",
  "latitude": 45.775,
  "longitude": 4.8750153,
  "daily_units": {
   "time": "iso8601",
   "river_discharge": "m³/s"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/greeneris-data-hydro-river-discharge-726f6ced/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)