Api Endpoint

opendata402

Latest US river and stream readings from the USGS water data API (15-minute data): discharge (cubic feet per second), gage height (feet) or water temperature for a USGS monitoring site. Use it for flood watching, paddling and fishing conditions, and water-dependent operations. Site number e.g. 01646500 (Potomac River near Washington DC). Data are provisional.

Open interactive test console

Offering

Provider
opendata402.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Weather And Environment
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://opendata402.com/v1/rivers/us
MIME type
application/json
First seen
2026-10-16T01:50:24.663Z
Last seen
Tags
rivers, streamflow, usgs, water, floods

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.001 USDC
Atomic price: 1000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.001 USDC
Atomic price: 1000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 3
0.001 USDC
Atomic price: 1000 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "payTo": "0x295AA6c5a3460A0f8755823C8eE7bBC7CAf79fb1"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "1000",
    "payTo": "0x295AA6c5a3460A0f8755823C8eE7bBC7CAf79fb1"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "1000",
    "payTo": "0x295AA6c5a3460A0f8755823C8eE7bBC7CAf79fb1"
  }
]

Observed health

Status
Healthy
Latest latency
73 ms
Average latency
1011 ms
HTTP status
402
Last checked
Reachability
100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "site": {
          "type": "string",
          "pattern": "^\\d{8,15}$",
          "description": "USGS site number."
        },
        "parameter": {
          "type": "string",
          "enum": [
            "discharge",
            "gage_height",
            "water_temp"
          ],
          "description": "discharge (default), gage_height or water_temp."
        }
      },
      "required": [
        "site"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "parameter": {
              "description": "discharge (default), gage_height or water_temp.",
              "enum": [
                "discharge",
                "gage_height",
                "water_temp"
              ],
              "type": "string"
            },
            "site": {
              "description": "USGS site number.",
              "pattern": "^\\d{8,15}$",
              "type": "string"
            }
          },
          "required": [
            "site"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}