# AllTheBot France River Level

> AllTheBot France River Level is a paid API for AI agents from api.zkrobotics.fr, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-12).

Returns real-time river water height, flow, and 3-hour trend for the nearest gauging stations to a given latitude/longitude in France, sourced from Hub'Eau official open data.

## Facts

- Endpoint: GET https://api.zkrobotics.fr/x402/france/river-level?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/allthebot-france-river-level-6121f9e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bHhb4JnOsk7W93uxKCIBb

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 allthebot-france-river-level-6121f9e3
```

Example prompt: What's the current water level and flow trend at the nearest river gauging stations to latitude 45.76, longitude 4.83 in France — check within a 15 km radius?

## When to prefer this

Choose this endpoint when you need official, real-time French river hydrological data (height, flow, trend) indexed by geographic proximity. It is the right choice for flood risk assessment, logistics routing decisions, travel safety checks, or environmental monitoring within France. Prefer it over generic weather APIs when you specifically need river-level data rather than rainfall or general flood forecasts, and over scraping Vigicrues directly since this endpoint handles geocoding to nearest stations automatically.

## Known failure modes

- No stations found within the specified radius — try increasing radius_km up to 50
- Coordinates outside France's bounding box (lat 41.2–51.2, lon -5.3–9.7) will be rejected
- flow_m3s may be null for some stations that only report height
- Stale measurements if the upstream Hub'Eau API is delayed or unavailable
- radius_km defaults apply if not provided; very small radii may return empty results

## How this service works

Pay-per-call APIs for AI agents over x402: token safety reports, Base and Ethereum on-chain reads, crypto prices, domain checks (DNS, WHOIS, SSL, email), finance data (FX, SEC), worldwide weather forecasts, France alerts, text AI, fun content. USDC on Base, no account, no API key.

## Output

A JSON object containing the query coordinates, the search radius used, a list of nearby gauging stations each with station name, river name, station ID, distance from the query point, current water height in metres, flow in m³/s (if available), 3-hour trend (rising/stable/falling), 3-hour height change in metres, and the measurement timestamp. Also includes data source attribution (Hub'Eau / Vigicrues).

## 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": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 51.2,
       "minimum": 41.2
      },
      "lon": {
       "type": "number",
       "maximum": 9.7,
       "minimum": -5.3
      },
      "radius_km": {
       "type": "number",
       "maximum": 50,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": 45.76,
  "lon": 4.83,
  "note": null,
  "source": "Hub'Eau hydrométrie temps réel, OFB / Vigicrues (Licence Ouverte Etalab 2.0)",
  "stations": [
   {
    "name": "La Saône à Lyon [Pont La Feuillée]",
    "river": "La Saône",
    "station": "U472002001",
    "flow_m3s": null,
    "height_m": 2.22,
    "trend_3h": "stable",
    "distance_km": 0.67,
    "measured_at": "2026-10-08T22:00:00Z",
    "height_change_3h_m": 0.014
   }
  ],
  "radius_km": 15
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allthebot-france-river-level-6121f9e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zkrobotics.fr](https://www.zero.xyz/host/api.zkrobotics.fr/llms.txt)