# HALOWERK Nordic Land – Finland Surface Clay Fraction (SoilGrids 0-5 cm)

> HALOWERK Nordic Land – Finland Surface Clay Fraction (SoilGrids 0-5 cm) is a paid API for AI agents from nordland.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Returns the mean clay fraction (%) for the 0–5 cm soil layer at a given coordinate, validated to fall within Finland's boundary, sourced from SoilGrids data.

## Facts

- Endpoint: POST https://nordland.halowerk.com/v1/fi-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-nordic-land-finland-surface-clay-fraction-soilgrids-0-5-cm-351a0efe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lwuGXbu7OHacW5PlOzVnf

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-nordic-land-finland-surface-clay-fraction-soilgrids-0-5-cm-351a0efe -d '<json body>'
```

Example prompt: What's the mean clay fraction in the top 5 cm of soil at latitude 60.45, longitude 22.27 in Finland?

## When to prefer this

Use this endpoint when you specifically need SoilGrids-derived mean clay fraction for the topsoil (0–5 cm) at a point location within Finland. It is ideal for agricultural site assessment, environmental modeling, land use planning, or construction soil surveys in Finland. Prefer this over generic soil APIs when Finland-boundary validation is required and pay-per-call economics suit your workflow. Pair with sibling endpoints for sand fraction, pH, organic carbon, or USDA texture class for a complete soil profile.

## Known failure modes

- Coordinate outside Finland boundary – request rejected before payment, error indicating location not covered
- Coordinate within broad European input range but outside Finland polygon – validation failure
- Missing or invalid latitude/longitude – schema validation error
- Coordinate at sea or on a lake with no valid soil data – may return null or error
- Latitude/longitude outside the stated European input range (34–72.5°N, -31.5–40.5°E) – rejected by schema validation

## How this service works

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

## Output

Returns the mean clay fraction (as a percentage or volume fraction) for the 0–5 cm soil depth at the requested coordinate, derived from SoilGrids global soil data. Coordinates outside Finland's Natural Earth boundary are rejected 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-nordic-land-finland-surface-clay-fraction-soilgrids-0-5-cm-351a0efe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nordland.halowerk.com](https://www.zero.xyz/host/nordland.halowerk.com/llms.txt)