Live river streamflow + gage height for a USGS site API

Latest measured streamflow (ft3/s) and gage height (ft) for a USGS monitoring site, normalized with rise/fall trend and a coarse flow class. Answers 'how high is the river right now?', 'is the Potomac rising or falling?'.

Price$0.01per request

MethodPOST

Route/v1/climate/usgs-streamflow

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache900s public

climatewaterstreamflowriverusgsgage-heighthydrologyfloodus

API URLhttps://x402.hexl.dev/v1/climate/usgs-streamflow

Integration docs

Example request

{
  "site": "01646500"
}

Example response

{
  "site": {
    "name": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
    "siteCode": "01646500",
    "latitude": 38.94977778,
    "longitude": -77.12763889
  },
  "parameters": [
    {
      "parameterCode": "00060",
      "name": "Streamflow, ft³/s",
      "unit": "ft3/s",
      "latest": 7740,
      "observedAt": "2026-06-04T18:50:00.000-04:00",
      "trend": null,
      "flowClass": "high"
    },
    {
      "parameterCode": "00065",
      "name": "Gage height, ft",
      "unit": "ft",
      "latest": 3.72,
      "observedAt": "2026-06-04T18:50:00.000-04:00",
      "trend": null
    }
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "description": "USGS site number (8-15 digits), e.g. '01646500'."
    }
  },
  "required": [
    "site"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}