# HALOWERK Southern Land Italy Soil Clay Fraction

> HALOWERK Southern Land Italy Soil Clay Fraction 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 Italy, validated against Natural Earth boundaries.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/it-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-italy-soil-clay-fraction-b1a83e87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VAGxfT6_sw5Javl1LD04b

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-italy-soil-clay-fraction-b1a83e87 -d '<json body>'
```

Example prompt: What's the mean clay fraction in the top 5 cm of soil at latitude 41.9028 and longitude 12.4964 in Italy?

## When to prefer this

Choose this endpoint when you need the clay fraction specifically for the top 0-5 cm soil layer at a point location within Italy, sourced from SoilGrids global soil data. It is ideal for agricultural site assessment, land suitability scoring, or soil texture profiling workflows focused on Italian geography. Prefer it over generic soil APIs when Italy-specific boundary validation and topsoil clay content are the primary requirements, and when you are working alongside sibling endpoints (sand fraction, CEC, USDA texture class) from the same HALOWERK Southern Land suite for a composite soil analysis.

## Known failure modes

- Coordinate outside Italy boundary: request rejected before payment with an error indicating out-of-coverage area
- Coordinate within European schema bounds but outside Italy: rejected by Italian boundary validation
- Malformed or missing latitude/longitude fields: validation error returned
- Latitude or longitude outside the published European schema range (34–72.5°N, -31.5–40.5°E): schema validation failure
- Upstream SoilGrids data unavailable for remote or coastal edge pixels: may return null or partial result

## How this service works

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

## Output

Returns the mean SoilGrids clay fraction (as a proportion or percentage) for the 0-5 cm depth layer at the specified coordinate. The coordinate is first validated against the Natural Earth boundary for Italy; requests falling outside Italy are rejected without incurring a charge.

## 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-italy-soil-clay-fraction-b1a83e87/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)