# HALOWERK Nordic Land – Finland Solar Orientation Index

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

Returns a south-facing slope orientation index for a given coordinate inside Finland, derived from terrain aspect and slope data.

## Facts

- Endpoint: POST https://nordland.halowerk.com/v1/fi-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-nordic-land-finland-solar-orientation-index-3ace94fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wVcsurL-lRGlhbGFYDrd2

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-nordic-land-finland-solar-orientation-index-3ace94fa -d '<json body>'
```

Example prompt: What's the south-facing slope orientation index for the hillside at latitude 65.2 and longitude 25.6 in Finland? I want to know how well it faces south for solar potential.

## When to prefer this

Choose this endpoint when you need a terrain-based solar orientation score specifically for a coordinate inside Finland, particularly for land assessment, solar energy planning, or ecological analysis. It is distinct from raw aspect or slope endpoints because it synthesises both into a single south-facing index, and it pre-validates against Finland's boundary so invalid coordinates are rejected before payment.

## Known failure modes

- Coordinate outside Finland's Natural Earth boundary — request rejected with a geographic bounds error, no charge applied
- Latitude or longitude outside published European coverage range (lat 34–72.5, lon -31.5–40.5) — validation error
- Malformed or missing coordinate fields — input schema validation error
- Payment failure via x402 protocol — 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 Finland; results outside it are rejected before payment.

## Output

A numeric south-facing slope orientation index computed from terrain aspect and slope data for the queried Finnish coordinate. Coordinates outside the Finland boundary (validated against Natural Earth) 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-nordic-land-finland-solar-orientation-index-3ace94fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nordland.halowerk.com](https://www.zero.xyz/host/nordland.halowerk.com/llms.txt)