# HALOWERK Eastern Land – Cyprus Aspect Direction

> HALOWERK Eastern Land – Cyprus Aspect Direction 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-16).

Returns the circular direction (degrees clockwise from north) of the dominant surface gradient at a given coordinate within Cyprus.

## Facts

- Endpoint: POST https://ostland.halowerk.com/v1/cy-aspect
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-eastern-land-cyprus-aspect-direction-e3daf982
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_usirVN9v438cyA-VnqkDB

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-aspect-direction-e3daf982 -d '<json body>'
```

Example prompt: What direction does the slope face at latitude 34.92, longitude 33.05 in Cyprus? I need the aspect angle clockwise from north.

## When to prefer this

Use this endpoint when you specifically need the dominant slope-facing direction (aspect) for a point location within Cyprus. It is ideal for solar energy siting, agricultural planning, hydrology, and environmental assessments where terrain orientation matters. Choose this over generic DEM APIs when you need Cyprus-bounded validation and pay-per-call pricing without subscription overhead.

## Known failure modes

- Coordinate outside Cyprus Natural Earth boundary — rejected before payment, returns validation error
- Latitude or longitude outside published European coverage bounds (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Missing required latitude or longitude parameter — request rejected
- Invalid numeric format for coordinates — parsing error
- Service unavailable or timeout — payment may not be charged

## How this service works

Circular direction of the dominant surface gradient, clockwise from north. The coordinate is validated against the Natural Earth boundary for Cyprus; results outside it are rejected before payment.

## Output

Returns the circular aspect direction in degrees (0–360, clockwise from north) representing the dominant surface gradient orientation at the specified coordinate. Coordinates outside the Cyprus 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-eastern-land-cyprus-aspect-direction-e3daf982/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)