Environment

Daily values: streamflow, gage height (mean/max/min/median)

Changed on

Daily statistically derived values, such as mean daily streamflow (discharge), one row per calendar day per (site, parameter). Record often goes back to the 1900s. Values marked 'A' are approved, 'P' are provisional. Dual-path: legacy WaterServices primary, OGC daily fallback.

get/api/v1/environment/usgs-water/dv

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/environment/usgs-water/dv
  • Auth: API key in header x-api-key

Query parameters

sitestring required

USGS site number(s), comma-separated.

parameterstring

Parameter code(s), comma-separated.

start_datestring

Start date YYYY-MM-DD.

end_datestring

End date YYYY-MM-DD.

stat_codestring

Statistic code filter (00001=max, 00002=min, 00003=mean, 00008=median).

Response

Daily-value time series for each (site, parameter, statistic) tuple.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes