# HALOWERK Southern Land – Portugal Water & Wetland Share

> HALOWERK Southern Land – Portugal 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 at a given coordinate within Portugal, derived from ESA WorldCover 2021 data.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/pt-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-portugal-water-wetland-share-cec65f9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tk-GcSpbIjHhyHJXxbLOQ

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-portugal-water-wetland-share-cec65f9a -d '<json body>'
```

Example prompt: What share of land around latitude 38.72, longitude -9.14 in Portugal is classified as permanent water, wetland, or mangrove according to ESA WorldCover?

## When to prefer this

Choose this endpoint when you need ESA WorldCover 2021-based water and wetland land-cover fraction specifically for a point location within Portugal. It is ideal for geospatial enrichment workflows, environmental due diligence, agricultural site assessment, or conservation analysis where wetland and water exposure is a key variable and Portugal boundary validation is required. Prefer this over general land-cover APIs when you need the combined permanent-water + wetland + mangrove share as a single metric for Portuguese coordinates.

## Known failure modes

- Coordinate outside Portugal boundary: rejected before processing, returns an error indicating the point is outside the valid coverage area
- Latitude or longitude outside European coverage bounds (lat 34–72.5, lon −31.5–40.5): schema validation failure
- Malformed or missing coordinate fields: request rejected with input validation error
- Payment failure or insufficient USDC balance: x402 payment-required response before data is returned

## How this service works

Combined share of permanent water, herbaceous wetland and mangrove classes. The coordinate is validated against the Natural Earth boundary for Portugal; 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 in Portugal. The coordinate is validated against the Natural Earth Portugal boundary before the result is returned; coordinates outside Portugal are rejected.

## 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-portugal-water-wetland-share-cec65f9a/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)