# HALOWERK Southern Land – Italy Water & Wetland Share

> HALOWERK Southern Land – Italy Water & Wetland Share is a paid API for AI agents from suedland.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns the combined share of permanent water, herbaceous wetland, and mangrove land-cover classes for a given coordinate in Italy, derived from ESA WorldCover 2021 data.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/it-water-wetland-share
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-southern-land-italy-water-wetland-share-139f2943
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_475szYfr9d4d-8HnTkKve

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 halowerk-southern-land-italy-water-wetland-share-139f2943 -d '<json body>'
```

Example prompt: What's the combined share of permanent water, wetland, and mangrove land cover at latitude 40.85, longitude 14.27 in Italy? I need the ESA WorldCover water-wetland fraction for that point.

## When to prefer this

Use this endpoint when you need a precise, coordinate-level water and wetland land-cover fraction specifically for locations in Italy, backed by ESA WorldCover 2021 satellite data. Prefer it over generic GIS APIs when you need a cheap, low-latency single-point lookup with built-in boundary validation for Italy. It is especially useful for environmental assessments, agricultural suitability screening, or conservation planning workflows where aquatic land cover is a key signal.

## Known failure modes

- Coordinate outside Italy boundary — rejected before payment with a validation error
- Latitude or longitude outside the published European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation failure
- Malformed or missing latitude/longitude — input validation error
- Service unavailable or upstream ESA WorldCover data unreachable — 5xx error

## How this service works

Combined share of permanent water, herbaceous wetland and mangrove classes. The coordinate is validated against the Natural Earth boundary for Italy; results outside it are rejected before payment.

## Output

A numeric share (fraction or percentage) representing the combined proportion of ESA WorldCover 2021 pixels classified as permanent water, herbaceous wetland, or mangrove within the analysis area around the given coordinate. The coordinate is validated against the Natural Earth boundary for Italy; requests outside Italy are rejected before any payment is charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "number",
   "maximum": 72.5,
   "minimum": 34,
   "description": "WGS84 latitude inside the published European coverage."
  },
  "longitude": {
   "type": "number",
   "maximum": 40.5,
   "minimum": -31.5,
   "description": "WGS84 longitude inside the published European coverage."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-southern-land-italy-water-wetland-share-139f2943/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from suedland.halowerk.com](https://www.zero.xyz/host/suedland.halowerk.com/llms.txt)