Data Lookup API

Real-time river and stream conditions at a USGS stream gauge — current streamflow/discharge (cubic feet per second) and gauge height/water level/stage (feet), i.e. how much water is flowing and how high it is right now. Data is provisional and subject to revision. Requires a USGS site number (e.g. 09380000 = Colorado River at Lees Ferry, AZ).

Resource: x402-seller.onrender.com/water/streamflow

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xbd61dfb01f81c91f02b0ccd51b0220e0c8918639

Payment methods: — · Last validation: 2026-09-14 16:39:51.022+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "queryParams": {
        "type": "object",
        "required": [
          "site"
        ],
        "properties": {
          "site": {
            "type": "string",
            "description": "USGS site number (e.g. 09380000)"
          }
        }
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object",
        "properties": {
          "lat": {
            "type": [
              "number",
              "null"
            ]
          },
          "lng": {
            "type": [
              "number",
              "null"
            ]
          },
          "site": {
            "type": "string"
          },
          "time": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "type": "string"
          },
          "siteName": {
            "type": [
              "string",
              "null"
            ]
          },
          "attribution": {
            "type": "string"
          },
          "provisional": {
            "type": "boolean"
          },
          "gaugeHeightFt": {
            "type": [
              "number",
              "null"
            ]
          },
          "streamflowCfs": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0xbd61dfb01f81c91f02b0ccd51b0220e0c8918639",
        "amount": "1000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0xbd61dfb01f81c91f02b0ccd51b0220e0c8918639",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "1000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.