# HALOWERK Central Land – CZ Soil Clay Fraction (0-5 cm)

> HALOWERK Central Land – CZ Soil Clay Fraction (0-5 cm) is a paid API for AI agents from mitteleuropa.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 topsoil layer at a given coordinate within Czechia.

## Facts

- Endpoint: POST https://mitteleuropa.halowerk.com/v1/cz-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-central-land-cz-soil-clay-fraction-0-5-cm-4a8df8a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DkTdw0C_HOE6RBkGj_qkv

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-central-land-cz-soil-clay-fraction-0-5-cm-4a8df8a4 -d '<json body>'
```

Example prompt: What's the mean clay fraction in the top 5 cm of soil at latitude 50.08 and longitude 14.44 in Czechia?

## When to prefer this

Use this endpoint when you need precise, point-level topsoil clay fraction data specifically for locations within Czechia, backed by SoilGrids global soil data. Prefer it over generic soil APIs when you need the 0–5 cm depth layer specifically and want boundary-validated results to avoid erroneous out-of-region lookups. It pairs well with sibling endpoints on the same platform for silt, pH, and CEC to build a complete soil texture profile.

## Known failure modes

- Coordinate outside Czechia boundary — rejected before payment with an error indicating the point is not within the validated region
- Latitude or longitude out of the published European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Malformed request body or missing required fields — 400-level error
- Payment failure or insufficient USDC balance — x402 payment required error
- Service unavailability or upstream SoilGrids data issue — 5xx error

## How this service works

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

## Output

A numeric value representing the mean clay fraction (likely as a percentage or volumetric fraction) for the 0–5 cm topsoil layer at the queried coordinate, derived from SoilGrids data, validated to fall within the Natural Earth boundary of Czechia.

## 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-central-land-cz-soil-clay-fraction-0-5-cm-4a8df8a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mitteleuropa.halowerk.com](https://www.zero.xyz/host/mitteleuropa.halowerk.com/llms.txt)