# HALOWERK Southern Land – Portugal Local Relief

> HALOWERK Southern Land – Portugal Local Relief 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-13).

Returns the local relief (difference between maximum and minimum sampled surface elevation) for a coordinate point within Portugal.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/pt-local-relief
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-southern-land-portugal-local-relief-d5681dbe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9KsMsxFUnZFs8iAjgFq22

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-local-relief-d5681dbe -d '<json body>'
```

Example prompt: What's the local relief — the difference between the highest and lowest surface elevations — at latitude 38.7 and longitude -9.1 in Portugal?

## When to prefer this

Use this endpoint when you need a quick, cheap ($0.003/call) scalar measure of terrain variability at a specific point in Portugal. It is ideal for pre-screening land parcels, routing, or environmental analysis workflows where full DEM processing is unnecessary. Prefer this over general elevation APIs when you specifically need the elevation range (relief) rather than a single elevation value, and when the location is within Portugal.

## Known failure modes

- Coordinate outside Portugal's Natural Earth boundary — request rejected with validation error before payment
- Latitude or longitude out of the published European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation failure
- Malformed or missing latitude/longitude fields — 400-level error
- Payment failure via x402 protocol — no result returned
- Server-side elevation data unavailable for the requested point — potential 5xx error

## How this service works

Difference between maximum and minimum sampled surface elevation. The coordinate is validated against the Natural Earth boundary for Portugal; results outside it are rejected before payment.

## Output

A numeric value representing the local relief in meters — the difference between the maximum and minimum sampled surface elevations within the analysis area around the given coordinate. Coordinates outside Portugal's Natural Earth boundary are rejected before any charge is incurred.

## 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-local-relief-d5681dbe/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)
