# HALOWERK Southern Land – Portugal Soil Coarse-Fragment Volume (0–5 cm)

> HALOWERK Southern Land – Portugal Soil Coarse-Fragment Volume (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 coarse-fragment volume (%) 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-coarse-fragments
- 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-soil-coarse-fragment-volume-0-5-cm-1b13232e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hoNKb6GCYLslpOKl8fNw_

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-soil-coarse-fragment-volume-0-5-cm-1b13232e -d '<json body>'
```

Example prompt: What's the mean coarse-fragment volume in the top 5 cm of soil at latitude 38.716, longitude -9.139 in Portugal? I need the SoilGrids figure for that surface layer.

## When to prefer this

Choose this endpoint when you need point-level SoilGrids coarse-fragment volume data specifically within Portugal and want boundary validation built in. It is ideal for agricultural planning, land suitability analysis, environmental research, or construction surveys in Portugal where knowing the rockiness of the surface soil layer (0–5 cm) is critical. Prefer it over generic SoilGrids API access when you want a simple, pay-per-call microservice with geographic guardrails already enforced.

## Known failure modes

- Coordinate outside Portugal boundary: request rejected before payment is processed
- Latitude or longitude out of allowed European coverage range (lat 34–72.5, lon -31.5–40.5): validation error
- Malformed or missing coordinate fields: schema validation error
- SoilGrids upstream data unavailable: service error response
- Payment failure via x402 protocol: request not fulfilled

## How this service works

Mean SoilGrids coarse-fragment volume 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

A numeric value representing the mean volumetric coarse-fragment content (stones, gravel, rock fragments larger than 2 mm) as a percentage of the total soil volume in the 0–5 cm surface layer at the queried coordinate, sourced from SoilGrids. The coordinate is verified to fall within Portugal's Natural Earth boundary before the result is returned; queries 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-soil-coarse-fragment-volume-0-5-cm-1b13232e/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)