# HALOWERK Eastern Land – Bulgaria Soil Sand Fraction (0-5 cm)

> HALOWERK Eastern Land – Bulgaria Soil Sand Fraction (0-5 cm) 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 mean SoilGrids sand fraction for the 0–5 cm soil layer at a given coordinate within Bulgaria, validated against the Natural Earth boundary.

## Facts

- Endpoint: POST https://ostland.halowerk.com/v1/bg-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-eastern-land-bulgaria-soil-sand-fraction-0-5-cm-cdb6c3b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OJuzsu_EPrsIs8q7Dp5mn

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-sand-fraction-0-5-cm-cdb6c3b0 -d '<json body>'
```

Example prompt: What is the mean sand fraction in the top 0–5 cm of soil at latitude 42.15, longitude 24.75 in Bulgaria?

## When to prefer this

Use this endpoint when you need a point-level SoilGrids sand fraction value specifically within Bulgaria. It is ideal for agricultural feasibility studies, soil texture classification, land suitability analysis, or environmental data enrichment where topsoil sand content at the 0–5 cm depth is required. Prefer this over generic soil APIs when you need cost-effective micropayment access ($0.004/call) with boundary validation guaranteeing the coordinate is within Bulgaria.

## Known failure modes

- Coordinate falls outside Bulgaria's Natural Earth boundary — request rejected with no charge
- Latitude or longitude out of the European coverage range (lat 34–72.5, lon -31.5–40.5) — validation error
- Malformed or missing coordinate fields — input schema error
- Payment failure via x402 protocol — transaction not processed

## How this service works

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

## Output

A numeric mean sand fraction value (from SoilGrids) for the 0–5 cm topsoil layer at the queried coordinate. Coordinates outside Bulgaria 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-eastern-land-bulgaria-soil-sand-fraction-0-5-cm-cdb6c3b0/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)