# HALOWERK Southern Land Portugal Soil Sand Fraction

> HALOWERK Southern Land Portugal Soil Sand 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 sand fraction 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-sand
- 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-sand-fraction-343ad838
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v2PDDA5ffHFVoPS0lZsfx

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-sand-fraction-343ad838 -d '<json body>'
```

Example prompt: What's the topsoil sand fraction at latitude 38.72, longitude -9.14 in Portugal? I need the SoilGrids mean sand content for the 0-5 cm layer.

## When to prefer this

Choose this endpoint when you specifically need SoilGrids topsoil sand fraction data for a point location within Portugal and require boundary validation to ensure geographic integrity. It is ideal for agricultural, viticultural, or environmental workflows that need reliable soil texture data for Portuguese land parcels. Use sibling endpoints on the same platform for complementary soil attributes (clay, silt, CEC, USDA texture class) or land cover metrics.

## Known failure modes

- Coordinate outside Portugal boundary — request rejected before payment is processed
- Latitude or longitude out of the published European coverage range (lat 34–72.5, lon -31.5–40.5) — validation error
- Coordinate within European range but outside Portugal — boundary rejection
- Invalid or missing latitude/longitude fields — schema validation error
- Payment failure for $0.004 USDC via x402 protocol

## How this service works

Mean SoilGrids sand fraction 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 sand fraction (as a percentage or fraction) of the 0-5 cm soil layer at the requested coordinate, sourced from SoilGrids data and validated to fall within Portugal's Natural Earth boundary.

## 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-sand-fraction-343ad838/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)