# HALOWERK Southern Land – Portugal Surface Clay Fraction (0-5 cm)

> HALOWERK Southern Land – Portugal Surface Clay Fraction (0-5 cm) is a paid API for AI agents from suedland.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Returns the mean SoilGrids clay fraction for the 0–5 cm soil layer at a given coordinate within Portugal, validated against Natural Earth boundaries.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/pt-soil-clay
- Price: $0.004/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-surface-clay-fraction-0-5-cm-9f73f162
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mub7tG5VfCzv-MUrhPmzb

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-surface-clay-fraction-0-5-cm-9f73f162 -d '<json body>'
```

Example prompt: What's the mean clay fraction in the top 5 cm of soil at latitude 38.72 and longitude -9.14 in Portugal?

## When to prefer this

Choose this endpoint when you specifically need surface clay fraction data (0–5 cm depth) for a location within Portugal, especially when you need boundary-validated results and are comfortable with micropayment-per-call pricing. It is ideal for precision agriculture, land assessment, environmental research, or construction planning workflows that require authoritative SoilGrids-sourced clay data. Prefer it over generic soil APIs when Portugal-specific boundary enforcement and per-call pay-as-you-go pricing are desirable.

## Known failure modes

- Coordinate outside Portugal boundary — request rejected before payment, returns boundary validation error
- Latitude or longitude out of accepted European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation failure
- Malformed or missing coordinate fields — input validation error
- SoilGrids data unavailable for remote or coastal edge coordinates — may return null or no-data response
- Network or provider timeout — transient error, retry recommended

## How this service works

Mean SoilGrids clay fraction for the 0-5 cm layer. The coordinate is validated against the Natural Earth boundary for Portugal; results outside it are rejected before payment.

## Output

Returns the mean clay fraction (as a proportion or percentage) of the 0–5 cm soil layer derived from SoilGrids data for the specified coordinate. Coordinates outside the Portugal boundary (validated against Natural Earth) are rejected before payment is processed.

## 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-surface-clay-fraction-0-5-cm-9f73f162/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)