# HALOWERK Baltic Land – Surface Aspect (Poland)

> HALOWERK Baltic Land – Surface Aspect (Poland) is a paid API for AI agents from baltikum.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns the circular direction of the dominant surface gradient (aspect, clockwise from north) for a given coordinate within Poland's boundary.

## Facts

- Endpoint: POST https://baltikum.halowerk.com/v1/pl-aspect
- 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-baltic-land-surface-aspect-poland-4673bb8e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rKKZif6pdc6SmHRHQz6b0

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-baltic-land-surface-aspect-poland-4673bb8e -d '<json body>'
```

Example prompt: What direction does the dominant slope face at latitude 52.23, longitude 21.01 in Poland — give me the aspect clockwise from north?

## When to prefer this

Choose this endpoint when you need terrain aspect data specifically for locations in Poland and want pre-validated boundary checking (so out-of-bounds requests don't incur charges). Prefer it over general-purpose DEM APIs when working within the HALOWERK Baltic Land suite for consistent spatial resolution and payment-gated access.

## Known failure modes

- Coordinate outside Poland boundary — request rejected before payment, returns error indicating location is out of coverage
- Latitude or longitude outside the published European range (lat 34–72.5, lon -31.5–40.5) — schema validation failure
- Missing or malformed coordinate fields — returns 400-level error
- No data available for the exact cell — rare edge cases at border regions or data voids

## How this service works

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

## Output

A numeric value representing the circular direction (in degrees, clockwise from north) of the dominant surface gradient at the queried point. Coordinates outside Poland's Natural Earth boundary are rejected before any payment is charged.

## 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-baltic-land-surface-aspect-poland-4673bb8e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from baltikum.halowerk.com](https://www.zero.xyz/host/baltikum.halowerk.com/llms.txt)