{"uid":"cap_T4INFQVFi_TyVwfcyB2rD","slug":"waterpulse-streamflow-api-0639cdd6","name":"WaterPulse Streamflow API","description":"Real-time streamflow for water and hydrology agents. Returns current flow conditions, flood-stage context, and low-flow drought signals from USGS gauge stations.","url":"https://waterpulse.theaslangroupllc.com/api/water/streamflow","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"lang":{"type":"string","description":"en | es | fr | de | ja | zh | ko | pt | ar (default: en)"},"site":{"type":"string","description":"USGS site number (optional) — e.g. 09380000 (Colorado River at Lees Ferry)"},"limit":{"type":"string","description":"5 | 10 | 20 (default: 10)"},"state":{"type":"string","description":"Two-letter US state code — e.g. CO | OR | TN | NY"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"signal":"Widespread below-normal flows across Colorado indicate ongoing drought stress. No flood risk at monitored sites.","data_source":"USGS Instantaneous Values Water Services","flow_summary":{"sites_in_flood":0,"lowest_flow_site":"Arkansas River nr Pueblo — 34% of median","sites_above_normal":1,"sites_below_normal":8},"query_summary":{"state":"CO","parameter":"discharge_cfs","sites_analyzed":10},"stream_readings":[{"date_time":"2026-06-07T14:00:00","site_code":"09380000","site_name":"Colorado River at Lees Ferry, AZ","discharge_cfs":"8420","flow_condition":"Below normal","percent_of_median":61}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hC-8hZD6ZwJk4gLmHkS4B","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time streamflow conditions from USGS gauge stations including current flow rate, flood-stage status, and low-flow drought signals.","exampleAgentPrompt":"What are the current streamflow conditions at USGS gauge 09380000 on the Colorado River near Lee's Ferry — is it in flood stage, normal flow, or showing any low-flow drought signals?","exampleUseCases":[{"title":"Irrigation scheduling for agricultural operations","prompt":"Check the current streamflow at our local USGS gauge station — I need to know if we're in drought conditions or if we can safely increase water intake for crop irrigation this week."},{"title":"Emergency flood risk assessment for communities","prompt":"We're getting reports of heavy rain upstream. Pull the real-time streamflow data from the nearest USGS gauges in our watershed and tell me if any are approaching flood stage — I need to know if we should issue evacuation warnings."},{"title":"Water rights compliance and allocation monitoring","prompt":"Our water permit requires us to stop withdrawals when streamflow drops below certain thresholds. Check our assigned gauge station right now and let me know if we're still above the minimum flow requirements or if we need to shut down operations."}],"resultDescription":"Returns current streamflow measurements from the specified USGS gauge station, including flow rate (likely in cubic feet per second), flood-stage context indicating whether flow is above flood thresholds, and low-flow drought signals indicating whether flow is below critical drought thresholds.","failureModes":["Invalid or unknown USGS gauge station ID returns error","Gauge station offline or data temporarily unavailable returns no data","USGS data feed latency causes stale readings","Region not covered by USGS gauge network returns no results","Payment failure (insufficient USDC balance) blocks request"],"whenToPreferThis":"Choose this endpoint when you need real-time streamflow data with flood and drought context from official USGS gauge stations. Prefer this over generic weather APIs when hydrological precision matters — e.g. for flood risk assessment, drought monitoring, irrigation planning, or water rights analysis. Use sibling endpoints for groundwater levels, water quality, or reservoir storage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:45.678Z","isFirstParty":false}