{
  "x402Version": 2,
  "id": 4400,
  "slug": "4400",
  "resource": "https://api.truthbear.co/gauge/ruler",
  "description": "Add-on, the official ruler: the band and threshold ladder published by the source agency, its classification, and distance-to-action. NOT every line has an official ruler - pure market quotes do not. When it does not, you get 422 with no_charge:true and reason:no-ruler-for-this-line and you are NOT billed. Never a bag of nulls you paid for. Every record carries an offline-recomputable record_hash. $0.0050 per call.",
  "type": "http",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x2d16a243ba9facc6ac85519d5efad2149dc4c6c3",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "5000",
      "maxTimeoutSeconds": 300
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "8qEn3Y3GPXdQ28LHshPa4UYeD8V38Lq9b4jCRirQAY3n",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "5000",
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "bazaar": {
      "discoverable": true,
      "info": {
        "input": {
          "example": {
            "entity": "07010000",
            "format": "thin",
            "signal_id": "hydrology.river-level"
          },
          "exampleRequest": "/gauge/ruler?signal_id=hydrology.river-level&entity=07010000&format=thin",
          "method": "GET",
          "queryParams": {
            "entity": "required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[",
            "signal_id": "required - signal id (genus.species); free list at GET /gauge/catalog (paged; ?all=1 for every line)"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "dim": "ruler",
            "entity": "03255000",
            "entity_name": "Ohio River at Cincinnati, OH",
            "grade": "screening-level, not decision-grade",
            "nature": "This API supplies data organisation and trend description only. It is not a recommendation to act; the decision is yours. Purely descriptive - no judgement, no prediction.Official source plus record_hash; verify with the free /gauge/verify.",
            "observed_at": "2026-08-25T04:00:00.000Z",
            "provenance": {
              "age_hours_now": 23,
              "freshness": "fresh",
              "freshness_basis": "cadence=daily; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"
            },
            "record_hash": "sha256:5969b8a147f438254edadf246ed1d7801a77c29babb5d725e17870320d620dd7",
            "record_hash_verifiable": {
              "mode": "via-endpoint",
              "note": "This response is a projected delivery (some core fields are omitted to control size). Cross-check record_hash with the free /gauge/verify, or buy /gauge to get the complete core for offline recomputation."
            },
            "ruler": {
              "band": "below_action",
              "distance_to_action": 9.31,
              "metric": "gauge_height_ft",
              "official_category": "no_flooding",
              "scale": "flood_stage",
              "source": "NOAA NWS/NWPS",
              "standard": "NWS flood category thresholds (official; not judged by this API)",
              "thresholds": {
                "action": 40,
                "major": 65,
                "minor": 52,
                "moderate": 56
              },
              "unit": "ft"
            },
            "scope": {
              "full": "https://api.truthbear.co/scope/v1",
              "intelligence_not_command": true,
              "monitoring_not_forecast": true,
              "verifiability": "via-endpoint"
            },
            "signal_id": "hydrology.river-level",
            "source_ref": "https://waterdata.usgs.gov/monitoring-location/03255000/"
          },
          "type": "json"
        }
      },
      "outputSchemaRef": "/manifest",
      "priceUsd": "$0.005",
      "priceUsdNumber": 0.005,
      "routeTemplate": "/gauge/ruler",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "additionalProperties": false,
                "properties": {
                  "entity": {
                    "description": "required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]",
                    "examples": [
                      "07010000"
                    ],
                    "type": "string"
                  },
                  "signal_id": {
                    "description": "required - signal id (genus.species); free list at GET /gauge/catalog (paged; ?all=1 for every line)",
                    "examples": [
                      "hydrology.river-level"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "signal_id",
                  "entity"
                ],
                "type": "object"
              },
              "type": {
                "const": "http"
              }
            },
            "required": [
              "type",
              "method",
              "queryParams"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {},
              "type": {
                "const": "json"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        }
      }
    }
  },
  "tags": [
    "bazaar"
  ],
  "sourceHost": "api.truthbear.co",
  "lastUpdated": "2026-09-07T08:52:22.207Z",
  "quality": {
    "calls30d": 55,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-09-07T08:52:21.869Z"
  },
  "liveness": {},
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.truthbear.co",
    "manifest_name": "api.truthbear.co",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-09-18T22:00:31.484Z"
  }
}