{"uid":"cap_Y4sA54faPnKA_5L_G0HJp","slug":"clearcheck-streamflow-34b869e5","name":"ClearCheck Streamflow","description":"Live streamflow for a USGS gauge with a HIGH / NORMAL / LOW verdict vs the site's own median for this day of year.","url":"https://loonie-toll.onrender.com/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"],"type":"string"},"queryParams":{"type":"object","required":["site"],"properties":{"site":{"type":"string","description":"USGS site number, e.g. 03431500"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"query":{"type":"object","properties":{"site":{"type":"string"}}},"source":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"verdict":{"type":"string"},"siteName":{"type":"string"},"discharge":{"type":"object","properties":{"unit":{"type":"string"},"value":{"type":"integer"},"siteName":{"type":"string"},"observedAt":{"type":"string"}}},"disclaimer":{"type":"string"},"gageHeight":{"type":"object","properties":{"unit":{"type":"string"},"value":{"type":"number"},"siteName":{"type":"string"},"observedAt":{"type":"string"}}},"retrievedAt":{"type":"string"},"yearsOfRecord":{"type":"integer"},"historicalMedianForToday":{"type":"integer"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RbbpCsys8ZIu51rmEiQYW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live USGS streamflow data for a gauge site with a HIGH / NORMAL / LOW verdict compared to the historical median for that day of year.","exampleAgentPrompt":"What's the current streamflow condition at USGS gauge 03431500 — is it running high, low, or normal compared to what's typical for this time of year?","exampleUseCases":[{"title":"Kayaking safety check before launch","prompt":"Is the Harpeth River running high or low right now? Pull the streamflow for USGS site 03431500 and tell me if it's above or below normal for today."},{"title":"Flood monitoring for riverside property","prompt":"I own land near USGS gauge 11425500 — can you check the current discharge and let me know if the river is running HIGH compared to the historical median?"},{"title":"Fishing trip planning by flow conditions","prompt":"I'm planning a fly fishing trip this weekend. Can you check the current flow at USGS site 06719505 and tell me whether it's running normal or too high for wading?"}],"resultDescription":"Returns the current discharge in cfs, gage height, the historical median discharge for the same day of year, a HIGH/NORMAL/LOW verdict, supporting reasons, site name, observation timestamp, years of record used in the comparison, data source attribution, and a disclaimer.","failureModes":["Invalid or non-existent USGS site number returns an error","USGS data feed temporarily unavailable causes service error","Site exists but has no recent readings (sensor offline)","Insufficient historical record to compute median for that day of year"],"whenToPreferThis":"Use this endpoint when you need a quick human-readable verdict (HIGH/NORMAL/LOW) on river conditions relative to historical norms, not just raw gauge data. It's ideal for agents handling outdoor recreation planning, flood risk alerts, environmental monitoring, or any workflow that needs a contextual interpretation of streamflow rather than a raw number. Prefer this over directly querying USGS APIs when you want the median comparison and verdict computed for you in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:14.881Z","isFirstParty":false}