# HALOWERK Eastern Land Bulgaria Soil Texture

> HALOWERK Eastern Land Bulgaria Soil Texture is a paid API for AI agents from ostland.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Returns the USDA soil texture class (e.g. clay loam, sandy loam) for a given coordinate in Bulgaria, derived from SoilGrids sand, silt, and clay fraction data.

## Facts

- Endpoint: POST https://ostland.halowerk.com/v1/bg-soil-texture
- 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-eastern-land-bulgaria-soil-texture-87dffd7a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FZZC4kQT42-jvC6zeOF51

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-eastern-land-bulgaria-soil-texture-87dffd7a -d '<json body>'
```

Example prompt: What USDA soil texture class is at latitude 42.698 and longitude 23.322 in Bulgaria — is it sandy, loamy, or clay-dominant?

## When to prefer this

Choose this endpoint when you need USDA soil texture classification specifically for a location within Bulgaria, backed by SoilGrids sand/silt/clay fraction data. It is ideal for agricultural planning, land assessments, or environmental studies in Bulgaria. The built-in geographic boundary validation ensures you only pay for valid Bulgarian coordinates. Prefer this over generic soil APIs when you need structured USDA classification rather than raw fraction values, and when your use case is Bulgaria-specific.

## Known failure modes

- Coordinate outside Bulgaria boundary — rejected with a geographic validation error before payment
- Latitude or longitude out of European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Invalid or missing latitude/longitude fields — request rejected with input validation error
- SoilGrids data unavailable or sparse for the queried location — may return null or error response

## 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 Bulgaria; results outside it are rejected before payment.

## Output

Returns the USDA texture class label (e.g. 'sandy clay loam', 'silty clay') derived from SoilGrids sand, silt, and clay weight fractions for the queried coordinate within Bulgaria. Coordinates outside Bulgaria's boundaries are rejected before any processing or payment.

## 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-eastern-land-bulgaria-soil-texture-87dffd7a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ostland.halowerk.com](https://www.zero.xyz/host/ostland.halowerk.com/llms.txt)