# HALOWERK Southern Land – Portugal Soil Texture Classifier

> HALOWERK Southern Land – Portugal Soil Texture Classifier 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-13).

Returns the USDA soil texture class (e.g. sandy loam, clay) for a given WGS84 coordinate within Portugal, derived from SoilGrids sand, silt, and clay fractions.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/pt-soil-texture
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-southern-land-portugal-soil-texture-classifier-f5287e2d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kxg94jDnuCrO_lkJ3CnpE

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-texture-classifier-f5287e2d -d '<json body>'
```

Example prompt: What's the USDA soil texture class for the land at 38.716°N, 9.139°W in Portugal? I need to know if it's sandy, loamy, or clayey for a farming suitability assessment.

## When to prefer this

Use this endpoint when you need a USDA-standard soil texture classification specifically for a coordinate within Portugal, backed by SoilGrids fractional data. Prefer it over generic soil APIs when you need USDA texture class labels (not raw fractions) and when Portugal-scoped geographic validation is desired to avoid erroneous lookups. Pair with sibling HALOWERK endpoints (sand fraction, CEC, land cover) for a complete soil and land-use profile.

## Known failure modes

- Coordinate outside Portugal boundary — request rejected before payment with a geographic validation error
- Latitude or longitude outside the declared WGS84 range (34–72.5°N, -31.5–40.5°E) — schema validation error
- SoilGrids data unavailable for the exact pixel — may return null or no-data response
- Malformed JSON body — HTTP 400 bad request
- Payment failure via x402 protocol — request not processed

## How this service works

USDA texture class calculated from SoilGrids sand, silt and clay fractions. The coordinate is validated against the Natural Earth boundary for Portugal; results outside it are rejected before payment.

## Output

A USDA soil texture class label (e.g. 'Sandy Loam', 'Clay Loam', 'Silty Clay') for the queried coordinate, derived from SoilGrids sand, silt, and clay fraction data for the 0–5 cm layer. Coordinates outside the Portugal boundary are rejected with an error before any charge is applied.

## 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-texture-classifier-f5287e2d/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)