WaterPulse | Apiosk Gateway

Method	Path	Description	Cost
GET	/api/water/agriculture-use	Agricultural water intelligence for grower and ag-trader agents. Returns irrigation demand, water-rights curtailments, and farm water cost, combining USGS groundwater, US Drought Monitor, and USDA data.	$0.17 default	View details
GET	/api/water/aquifer	Aquifer system analysis for water and investor agents. Returns depletion rates, recharge capacity, agricultural dependency, regulatory outlook, and sustainability for Ogallala, Central Valley, Floridan, and 30+ US aquifers.	$0.17 default	View details
GET	/api/water/drought	US drought status for water and ag-trader agents. Returns drought category breakdown by area from the US Drought Monitor, a 12-week trend, and agricultural/municipal impact.	$0.09 default	View details
GET	/api/water/flood-risk	Real-time flood risk for insurance and emergency-planning agents. Combines USGS stream gauges, Open-Meteo precipitation forecasts, and FEMA flood-zone context into current river conditions and actionable guidance.	$0.17 default	View details
GET	/api/water/gauge	Live USGS river-gauge tick, deterministic. Answers "what is the flow at this gauge right now", "is this river high or low vs this week". Returns the latest streamflow (discharge, cfs) and gage height (ft) for one USGS site plus the 7-day min/max range, reading count, site name and coordinates, straight from USGS instantaneous values. Unknown sites 404 before payment. No LLM, no key, public domain.	$0.01 default	View details
GET	/api/water/global-stress	Global water stress intelligence for risk and investor agents. Covers freshwater availability, groundwater depletion, transboundary conflict risk, and investment and operational implications for any region.	$0.17 default	View details
GET	/api/water/groundwater	Real-time groundwater levels for water and hydrology agents. Returns depth-to-water, trend analysis, and drought risk context from USGS monitoring wells for any US state.	$0.09 default	View details
GET	/api/water/quality	Water quality intelligence for water and utility agents. Returns contaminant levels, pH, dissolved oxygen, temperature, and drinking-water compliance from EPA Water Quality Portal and USGS.	$0.09 default	View details
GET	/api/water/streamflow	Real-time streamflow for water and hydrology agents. Returns current flow conditions, flood-stage context, and low-flow drought signals from USGS gauge stations.	$0.06 default	View details
GET	/api/water/supply-brief	Water supply intelligence for utility and investor agents. Covers reservoir storage, utility supply outlook, infrastructure investment, rate trajectory, drought restrictions, and a 5-year risk rating for any US city or region.	$0.57 default	View details
GET	/api/water/supply-snapshot	Deterministic water-supply numbers snapshot for a US state — latest USGS groundwater well readings (depth-to-water) and current US Drought Monitor D0-D4 breakdown. No LLM, no web search. The $0.50 /api/water/supply-brief adds reservoir storage, utility outlook, restrictions, rate trajectory, and a synthesized 5-year risk rating.	$0.29 default	View details
GET	/openapi.json	Returns this OpenAPI specification. Free endpoint — no payment required.	Free default	View details

Endpoint documentation

GET/api/water/agriculture-use

$0.17 default

Description

Agricultural water intelligence for grower and ag-trader agents. Returns irrigation demand, water-rights curtailments, and farm water cost, combining USGS groundwater, US Drought Monitor, and USDA data.

Documentation

Agricultural water use intelligence

Irrigation demand, water rights curtailments, and farm water cost intelligence for any US state. Combines USGS groundwater, US Drought Monitor, and USDA data.

**Price:** $0.15 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.17 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "description": "Crop type — e.g. alfalfa, cotton, corn, almonds, rice",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "Two-letter US state code — e.g. CA, ID, NE, WA, CO",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "state"
  ],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/aquifer

$0.17 default

Description

Aquifer system analysis for water and investor agents. Returns depletion rates, recharge capacity, agricultural dependency, regulatory outlook, and sustainability for Ogallala, Central Valley, Floridan, and 30+ US aquifers.

Documentation

Aquifer sustainability analysis

Deep analysis of major US aquifer systems. Returns depletion rates, recharge deficit, agricultural dependency, regulatory outlook, investment implications, and sustainability score. Covers Ogallala, Central Valley, Floridan, Edwards, and 30+ US aquifers.

**Price:** $0.15 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.17 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "aquifer": {
      "description": "Aquifer name — e.g. Ogallala, Central Valley, Floridan, Edwards, High Plains",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "State code for USGS data enrichment — e.g. KS, TX, CA",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "aquifer"
  ],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/drought

$0.09 default

Description

US drought status for water and ag-trader agents. Returns drought category breakdown by area from the US Drought Monitor, a 12-week trend, and agricultural/municipal impact.

Documentation

Drought status (US Drought Monitor)

Current US drought status from the US Drought Monitor. Returns D0-D4 category breakdown by percent area, 12-week trend, and agricultural/municipal/wildfire impact assessment.

**Price:** $0.08 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.09 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "Two-letter US state code — omit for national view",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/flood-risk

$0.17 default

Description

Real-time flood risk for insurance and emergency-planning agents. Combines USGS stream gauges, Open-Meteo precipitation forecasts, and FEMA flood-zone context into current river conditions and actionable guidance.

Documentation

Flood risk intelligence

Real-time flood risk combining USGS stream gauge data, upstream conditions, and FEMA flood zone context. Returns current river conditions, 72-hour outlook, and property guidance for owners, insurers, and emergency planners.

**Price:** $0.15 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.17 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "location": {
      "description": "City, county, or river — e.g. Nashville TN, Mississippi River Iowa",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "Two-letter US state code for USGS data — e.g. TN, IA, TX",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "location"
  ],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/gauge

$0.01 default

Description

Live USGS river-gauge tick, deterministic. Answers "what is the flow at this gauge right now", "is this river high or low vs this week". Returns the latest streamflow (discharge, cfs) and gage height (ft) for one USGS site plus the 7-day min/max range, reading count, site name and coordinates, straight from USGS instantaneous values. Unknown sites 404 before payment. No LLM, no key, public domain.

Documentation

River-gauge tick — deterministic USGS primitive

Live single-gauge tick, deterministic: the latest streamflow (discharge, cfs) and gage height (ft) for one USGS site plus the 7-day min/max range, reading count, site name and coordinates, straight from the USGS instantaneous-values service. Unknown sites return 404 before payment settles. No LLM, no key, public domain. The $0.05 /api/water/streamflow adds state-wide scans and a narrative read on top.

**Price:** $0.01 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.01 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "site": {
      "description": "USGS site number (8-15 digits) — e.g. 01646500 (Potomac River near Washington DC)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "site"
  ],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/global-stress

$0.17 default

Description

Global water stress intelligence for risk and investor agents. Covers freshwater availability, groundwater depletion, transboundary conflict risk, and investment and operational implications for any region.

Documentation

Global water stress by country/basin

Country and basin-level water stress intelligence. Covers freshwater availability, groundwater depletion, transboundary conflict risk, climate trajectory, and investment/operational implications for any region globally.

**Price:** $0.15 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.17 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "focus": {
      "default": "all",
      "description": "agriculture | municipal | industrial | conflict | investment | all",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Country, region, or river basin — e.g. India, Middle East, Nile Basin, Murray-Darling",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "region"
  ],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/groundwater

$0.09 default

Description

Real-time groundwater levels for water and hydrology agents. Returns depth-to-water, trend analysis, and drought risk context from USGS monitoring wells for any US state.

Documentation

Groundwater levels (USGS)

Real-time groundwater level readings from USGS monitoring wells. Returns depth-to-water, trend, and drought risk context for any US state. No API key required.

**Price:** $0.08 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.09 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "limit": {
      "default": 10,
      "description": "Number of monitoring sites (5, 10, or 20)",
      "required": false,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "Two-letter US state code — e.g. CA, TX, AZ, FL, KS",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "state"
  ],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/quality

$0.09 default

Description

Water quality intelligence for water and utility agents. Returns contaminant levels, pH, dissolved oxygen, temperature, and drinking-water compliance from EPA Water Quality Portal and USGS.

Documentation

Water quality (EPA WQP + USGS)

Water quality parameters from EPA Water Quality Portal and USGS. Returns contaminant levels versus EPA MCLs with health context and recommended action.

**Price:** $0.08 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.09 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "parameter": {
      "default": "nitrates",
      "description": "nitrates | phosphorus | ph | lead | arsenic | bacteria | pfas | turbidity",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "Two-letter US state code — e.g. MI, OH, PA",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "state"
  ],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/streamflow

$0.06 default

Description

Real-time streamflow for water and hydrology agents. Returns current flow conditions, flood-stage context, and low-flow drought signals from USGS gauge stations.

Documentation

Streamflow — river discharge (USGS)

Real-time river and stream discharge from USGS gauge stations. Returns flow conditions, flood stage context, and low-flow drought signals. No API key required.

**Price:** $0.05 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.06 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "limit": {
      "default": 10,
      "required": false,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "site": {
      "description": "USGS site number — e.g. 09380000 (Colorado River at Lees Ferry)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "Two-letter US state code — e.g. CO, OR, TN",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/supply-brief

$0.57 default

Description

Water supply intelligence for utility and investor agents. Covers reservoir storage, utility supply outlook, infrastructure investment, rate trajectory, drought restrictions, and a 5-year risk rating for any US city or region.

Documentation

Municipal water supply brief

Comprehensive water supply intelligence for any US city — reservoir storage, utility outlook, rate trajectory, infrastructure investment, and 5-year risk rating. Replaces a $2,000 water risk consulting report.

**Price:** $0.5 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.57 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "lang": {
      "default": "en",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "location": {
      "description": "City or metro — e.g. Phoenix AZ, Las Vegas NV, Atlanta GA, Denver CO",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "Two-letter state code for data enrichment",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "location"
  ],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/water/supply-snapshot

$0.29 default

Description

Deterministic water-supply numbers snapshot for a US state — latest USGS groundwater well readings (depth-to-water) and current US Drought Monitor D0-D4 breakdown. No LLM, no web search. The $0.50 /api/water/supply-brief adds reservoir storage, utility outlook, restrictions, rate trajectory, and a synthesized 5-year risk rating.

Documentation

Water supply numbers snapshot — deterministic preview

**Price:** $0.25 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.29 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "location": {
      "description": "City or metro area — e.g. Phoenix AZ, Las Vegas NV, Atlanta GA, Denver CO (label only; data is state-level)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "state": {
      "description": "Two-letter US state code for USGS/drought data — e.g. AZ | NV | GA | CO",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [],
  "type": "object"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/openapi.json

Free default

Description

Returns this OpenAPI specification. Free endpoint — no payment required.

Documentation

OpenAPI specification

Returns this OpenAPI specification. Free endpoint — no payment required.

**Price:** Free per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

Free default

Authentication

Free PulseNetwork route; no API key, wallet or payment required.

Links

External documentation ↗OpenAPI / Swagger ↗