{"uid":"cap_Wt0P8PDq3wwOIXo6WKmcI","slug":"natur-river-anomaly-detector-97ffae42","name":"Natur River Anomaly Detector","description":"Compares the recent record of a gauge against its own longer history and reports three kinds of finding, kept separate because their causes differ. An extreme level is a reading in the top or bottom percentile of the reference period. An unusual rate of rise is a change per hour exceeding the station own typical rate by a stated factor — this is the figure that matters in a flood and it leads the level rather than following it, so it is reported even when the absolute value is still ordinary.","url":"https://natur.halowerk.com/v1/river-anomaly","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"site_id":{"type":"string","maxLength":20,"minLength":6},"parameter":{"enum":["discharge","gauge_height"],"type":"string","default":"gauge_height"},"sensitivity":{"enum":["low","normal","high"],"type":"string","default":"normal"},"recent_hours":{"type":"integer","default":24,"maximum":168,"minimum":2},"reference_days":{"type":"integer","default":60,"maximum":365,"minimum":7}}},"responseSchema":null,"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_-oBWT1iJzQK6dyOqbMuP2","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":"Compares a river gauge's recent readings against its historical baseline to detect extreme water levels and unusual rates of rise that may signal flooding","exampleAgentPrompt":"Check gauge station USGS-01234500 for anomalies — tell me if the current reading of 4.2 meters is in the extreme percentile of its historical record, and whether its rate of rise over the past hour is more than 3 times the station's typical hourly change.","exampleUseCases":[{"title":"Flood early-warning system for river network","prompt":"Run an anomaly check on gauge station Rhine-Cologne: the current level is 6.8 meters, and it has risen 0.9 meters in the last hour. Tell me if that level is in the top percentile of the historical record, and whether the rate of rise is unusually fast compared to what this station normally does — I need to know before the crest arrives."},{"title":"Automated alert for irrigation intake managers","prompt":"Check gauge station Sacramento-Delta-12 right now — the reading is 2.1 meters and it went up 0.15 meters in the past hour. Is that level extreme by historical standards, and is that rate of rise unusual enough to trigger an intake closure alert?"},{"title":"Research: distinguishing level extremes from rapid-rise events","prompt":"For gauge station Thames-Teddington with a current reading of 3.4 meters that has risen 0.4 meters this hour, tell me separately whether the absolute level qualifies as extreme and whether the rate of rise is anomalous — I want to understand if these are occurring together or independently."}],"resultDescription":"Returns up to three categorized findings: (1) whether the current level falls in an extreme percentile of the station's historical reference period, (2) whether the hourly rate of rise exceeds the station's typical rate by a specified factor, and (3) any third anomaly type with its cause distinguished from the others. Each finding is reported independently so users can act on leading indicators like rate-of-rise even when absolute levels are not yet extreme.","failureModes":["Unknown or invalid gauge station ID returns an error with no findings","Insufficient historical data for the reference period prevents percentile calculation","Missing or malformed current reading or rate-of-rise input causes a validation error","Rate-of-rise factor threshold set to zero or negative value may produce unexpected results","Station with very short history may yield unreliable percentile comparisons"],"whenToPreferThis":"Choose this endpoint when you need to detect hydrological anomalies that are action-worthy before a flood crest arrives — particularly the rate-of-rise signal, which leads the absolute level. It is better than a simple threshold alert because it adapts to each station's own historical behavior rather than applying a fixed global cutoff. Prefer it over raw gauge data fetching when you need a decision-ready output that separates extreme levels from rapid-rise events by cause.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:25.089Z","isFirstParty":false}