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

> HALOWERK Southern Land – Spain 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 (% by volume) for the 0–5 cm soil layer at a given coordinate, validated against Spain's Natural Earth boundary.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/es-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-spain-soil-coarse-fragment-volume-0-5-cm-488e9a43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__5PXApakMaW4UozwuoiWv

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

Example prompt: What's the mean coarse-fragment volume in the top 5 cm of soil at latitude 40.416, longitude -3.703 in Spain? I need it for a land suitability assessment.

## When to prefer this

Choose this endpoint when you need point-level coarse-fragment volume data for the surface soil layer (0–5 cm) specifically within Spain, with built-in boundary validation so out-of-country coordinates are rejected before billing. Prefer it over generic SoilGrids API calls when you want a pay-per-query microservice with automatic Spain-boundary enforcement. Use sibling endpoints on the same host for sand fraction, CEC, or texture class at the same coordinate.

## Known failure modes

- Coordinate outside Spain's Natural Earth boundary — request rejected, no charge
- Latitude or longitude out of the published European coverage range (lat 34–72.5, lon -31.5–40.5) — validation error
- Missing required latitude or longitude parameter — schema validation error
- Payment failure or insufficient USDC balance — transaction not completed
- Temporary upstream SoilGrids data unavailability — service error

## 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 Spain; results outside it are rejected before payment.

## Output

A numeric value representing the mean coarse-fragment volume (percentage by volume) in the 0–5 cm topsoil layer at the requested coordinate, sourced from SoilGrids. Coordinates outside Spain's Natural Earth boundary 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-spain-soil-coarse-fragment-volume-0-5-cm-488e9a43/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)