# HALOWERK Eastern Land – Cyprus Solar Orientation Index

> HALOWERK Eastern Land – Cyprus Solar Orientation Index is a paid API for AI agents from ostland.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns a south-facing slope orientation index (derived from aspect and slope) for a given coordinate within Cyprus, validated against the Natural Earth boundary.

## Facts

- Endpoint: POST https://ostland.halowerk.com/v1/cy-solar-orientation
- Price: $0.003/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-cyprus-solar-orientation-index-2d615646
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pUJEdFFngrFVw11wE8Iib

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-cyprus-solar-orientation-index-2d615646 -d '<json body>'
```

Example prompt: What's the south-facing slope orientation index for the location at latitude 34.92, longitude 33.04 in Cyprus — I need to know how well-oriented this slope is for solar exposure.

## When to prefer this

Choose this endpoint when you need a single, pre-computed south-facing solar orientation index for a specific point in Cyprus and do not want to run raw DEM aspect/slope calculations yourself. It is ideal for site-screening workflows, real estate assessments, agricultural suitability pipelines, or solar energy prospecting where Cyprus-specific boundary validation is a requirement. If you need broader European coverage or a different terrain metric (e.g. ruggedness, tree cover, soil properties), use sibling endpoints on the same host.

## Known failure modes

- Coordinate outside Cyprus Natural Earth boundary — request rejected before payment, validation error returned
- Latitude or longitude out of the published European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Malformed or missing coordinate fields — 400-level error
- Payment failure or insufficient USDC balance — request not processed

## How this service works

South-facing slope orientation index derived from aspect and slope. The coordinate is validated against the Natural Earth boundary for Cyprus; results outside it are rejected before payment.

## Output

A numeric south-facing slope orientation index derived from the site's terrain aspect and slope gradient, indicating how favourably the location faces the sun (southward). Coordinates outside the Cyprus Natural Earth boundary are rejected before any computation or payment is made.

## 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-cyprus-solar-orientation-index-2d615646/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)