# Locus Flood Gauges Property Scan

> Locus Flood Gauges Property Scan is a paid API for AI agents from api.locus.report, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Scans flood gauge data and local risk signals for a US property address or ZIP code to surface factors affecting property use, cost, and value.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-flood-gauges
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locus-flood-gauges-property-scan-e911b151
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xN8vdARPmCkREPDYxGAJf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability locus-flood-gauges-property-scan-e911b151 -d '<json body>'
```

Example prompt: Can you run a Locus flood gauge scan on 742 Evergreen Terrace, Springfield, IL 62704 and tell me what flood risks or local rule signals might affect that property?

## When to prefer this

Use this endpoint when you need early-stage flood gauge and risk signal data for a specific US property or ZIP code — particularly useful before purchasing, developing, or insuring real estate. Prefer this over general property lookup APIs when flood-specific gauge data and local parcel rule signals are the priority.

## Known failure modes

- Missing both address and zip fields returns a validation error
- Invalid or unrecognized US address may return empty records array
- Non-US addresses are not supported and will likely return no data
- Payment failure (x402) if USDC balance is insufficient
- Rate limiting or service unavailability returning 5xx errors

## How this service works

Nearby flood gauges with stage/flow observations. Perfect for: 'flood gauges near an address', 'USGS stream gauges nearby', 'river water levels near a property', 'NWS flood thresholds for an area'. Returns USGS stream/river gauges with latest stage/flow observations and NOAA/NWS threshold metadata within the search radius. National. Hydrologic context only - not a flood prediction or insurance determination. Charge-free when the gauge lookup fails.

## Output

Returns a structured JSON report with an ID, generation timestamp, caveat notices, and records containing flood gauge readings, local parcel rules, and environmental risk signals relevant to the queried address or ZIP code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 200,
   "minLength": 5
  },
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  },
  "radiusMeters": {
   "type": "integer",
   "maximum": 50000,
   "minimum": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "locus_example",
  "caveats": [
   "Example artifact; not live data."
  ],
  "records": [],
  "generatedAt": "2026-01-01T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/locus-flood-gauges-property-scan-e911b151/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.locus.report](https://www.zero.xyz/host/api.locus.report/llms.txt)