Usgs Water Tools#

Configuration File: usgs_water_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the usgs_water_tools.json configuration file.

Available Tools#

USGSWater_get_streamflow (Type: USGSWaterTool)#

Get recent streamflow (discharge) readings from USGS stream gages, in cubic feet per second (ft^3…

USGSWater_get_streamflow tool specification

Tool Information:

  • Name: USGSWater_get_streamflow

  • Type: USGSWaterTool

  • Description: Get recent streamflow (discharge) readings from USGS stream gages, in cubic feet per second (ft^3/s), with site name, state and coordinates. Values are usually every 15 minutes (some sites every 5) and provisional until reviewed. The USGS monitors over 10,000 stream gages across the United States. Source: USGS Water Data API (api.waterdata.usgs.gov, continuous values), which replaces the WaterServices API USGS is retiring on 2027-02-22.

Parameters:

  • sites (string) (required) USGS site number(s), comma-separated, up to 25 (e.g. ‘01646500’ for the Potomac River near Washington DC, ‘09380000’ for the Colorado River at Lees Ferry). A ‘USGS-’ prefix is accepted.

  • period ([‘string’, ‘null’]) (optional) How far back from now, as an ISO 8601 duration (e.g. ‘PT2H’ for 2 hours, ‘P1D’ for 1 day, ‘P7D’ for 7 days). Default: ‘P1D’.

  • max_values ([‘integer’, ‘null’]) (optional) Max values per site, newest kept, 1-10000 (shared across a site’s sensors when it has several). Default 500, about 1.7 days of 5-minute data.

Example Usage:

query = {
    "name": "USGSWater_get_streamflow",
    "arguments": {
        "sites": "example_value"
    }
}
result = tu.run(query)

USGSWater_get_water_level (Type: USGSWaterTool)#

Get recent water level (gage height) readings from USGS monitoring stations, in feet above the ga…

USGSWater_get_water_level tool specification

Tool Information:

  • Name: USGSWater_get_water_level

  • Type: USGSWaterTool

  • Description: Get recent water level (gage height) readings from USGS monitoring stations, in feet above the gage datum, with site name, state and coordinates. Useful for monitoring river and lake levels and flood conditions. Values are provisional until reviewed. Source: USGS Water Data API (api.waterdata.usgs.gov, continuous values), which replaces the WaterServices API USGS is retiring on 2027-02-22.

Parameters:

  • sites (string) (required) USGS site number(s), comma-separated, up to 25 (e.g. ‘01646500’ for the Potomac River near Washington DC, ‘09380000’ for the Colorado River at Lees Ferry). A ‘USGS-’ prefix is accepted.

  • period ([‘string’, ‘null’]) (optional) How far back from now, as an ISO 8601 duration (e.g. ‘PT2H’ for 2 hours, ‘P1D’ for 1 day, ‘P7D’ for 7 days). Default: ‘P1D’.

  • max_values ([‘integer’, ‘null’]) (optional) Max values per site, newest kept, 1-10000 (shared across a site’s sensors when it has several). Default 500, about 1.7 days of 5-minute data.

Example Usage:

query = {
    "name": "USGSWater_get_water_level",
    "arguments": {
        "sites": "example_value"
    }
}
result = tu.run(query)

USGSWater_get_water_temperature (Type: USGSWaterTool)#

Get recent water temperature readings from USGS monitoring stations, in degrees Celsius, with sit…

USGSWater_get_water_temperature tool specification

Tool Information:

  • Name: USGSWater_get_water_temperature

  • Type: USGSWaterTool

  • Description: Get recent water temperature readings from USGS monitoring stations, in degrees Celsius, with site name, state and coordinates. Useful for ecological monitoring, aquatic habitat assessment and water quality analysis. Not every gage measures temperature; sites without it are listed in metadata.sites_without_data. Source: USGS Water Data API (api.waterdata.usgs.gov, continuous values), which replaces the WaterServices API USGS is retiring on 2027-02-22.

Parameters:

  • sites (string) (required) USGS site number(s), comma-separated, up to 25 (e.g. ‘01646500’ for the Potomac River near Washington DC, ‘09380000’ for the Colorado River at Lees Ferry). A ‘USGS-’ prefix is accepted.

  • period ([‘string’, ‘null’]) (optional) How far back from now, as an ISO 8601 duration (e.g. ‘PT2H’ for 2 hours, ‘P1D’ for 1 day, ‘P7D’ for 7 days). Default: ‘P1D’.

  • max_values ([‘integer’, ‘null’]) (optional) Max values per site, newest kept, 1-10000 (shared across a site’s sensors when it has several). Default 500, about 1.7 days of 5-minute data.

Example Usage:

query = {
    "name": "USGSWater_get_water_temperature",
    "arguments": {
        "sites": "example_value"
    }
}
result = tu.run(query)