{"uid":"cap_VGGz63dwO1dpIiJKcH6He","slug":"synthora-usgs-real-time-streamflow-gage-height-7d65690a","name":"SYNTHORA USGS Real-Time Streamflow & Gage Height","description":"Returns real-time instantaneous streamflow (discharge) and gage height for any USGS water-monitoring site as JSON from USGS Water Services, keyless. Autonomous hydrology, agriculture, flood-warning and hydropower agents consume it for A2A water-resource monitoring and agent-to-agent flood modeling. Ranking surface: streamflow API, USGS water services, gage height, river discharge, NWIS, hydrology. Pay-per-call via x402 on Base. No charge on upstream failure.","url":"https://usgs-realtime-streamflow.hergertsynthora.com/service","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","description":"Returns real-time instantaneous streamflow (discharge) and gage height for any USGS water-monitoring site as JSON from USGS Water Services, keyless. Autonomous hydrology, agriculture, flood-warning an"}}},"responseSchema":{"type":"json","example":{"ok":true,"niche":"usgs_realtime_streamflow","result":{},"receipt":{"alg":"ed25519"}}},"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_uT0sJxyPAeepjRvdCXm5P","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 instantaneous streamflow (discharge) and gage height data for any USGS water-monitoring site via USGS NWIS Water Services, no API key required.","exampleAgentPrompt":"What's the current streamflow and gage height at USGS site 01646500? Pull the real-time instantaneous values for discharge and stage parameters.","exampleUseCases":[{"title":"Flood early warning monitoring","prompt":"Keep an eye on USGS site 03339000 on the Wabash River — pull the real-time gage height and streamflow discharge so I can track whether river levels are approaching flood stage."},{"title":"Irrigation scheduling for farm","prompt":"I need current streamflow data from USGS site 09380000 on the Colorado River near Lee Ferry — give me the live discharge reading so I can decide whether to open the irrigation diversion today."},{"title":"Hydropower turbine flow planning","prompt":"Fetch the real-time river discharge at USGS site 14211720 on the Sandy River — I need the instantaneous streamflow in cubic feet per second to plan tonight's hydropower generation schedule."}],"resultDescription":"Returns a JSON object containing real-time instantaneous streamflow (discharge in cfs) and gage height (river stage in feet) for the requested USGS water-monitoring site, sourced directly from USGS NWIS Water Services. The response wraps the USGS data under an 'ok' status flag and a 'result' payload containing the measurement values and timestamps.","failureModes":["Invalid or nonexistent USGS site ID returns empty or error result","USGS NWIS service outage causes upstream data unavailability","Invalid parameterCd code yields no data in the result payload","Sites with no recent measurements may return stale or missing instantaneous values","Malformed JSON input schema causes request rejection"],"whenToPreferThis":"Choose this endpoint when you need keyless, real-time access to USGS NWIS instantaneous streamflow and gage height data for specific monitoring stations without managing USGS API credentials. It is ideal for autonomous hydrology, flood-warning, agricultural irrigation, and hydropower agents that require live river conditions on demand. Prefer it over direct USGS API calls when operating within an x402 micropayment-enabled agent pipeline or when a managed wrapper with structured JSON responses is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:33:25.125Z","isFirstParty":false}