# HALOWERK Southern Land – Portugal Grassland Share

> HALOWERK Southern Land – Portugal Grassland Share is a paid API for AI agents from suedland.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Returns the share of ESA WorldCover 2021 pixels classified as grassland for a given coordinate within Portugal.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/pt-grassland-share
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-southern-land-portugal-grassland-share-19609306
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p30J0tDKZ2BYzm_3GfG69

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-southern-land-portugal-grassland-share-19609306 -d '<json body>'
```

Example prompt: What share of the land around latitude 38.7, longitude -9.1 in Portugal is classified as grassland according to ESA WorldCover 2021?

## When to prefer this

Use this endpoint when you specifically need the ESA WorldCover 2021 grassland pixel share for a point location within Portugal. It is best suited for land cover analysis, agricultural assessments, ecological surveys, and carbon project screening within Portuguese territory. Prefer this over general land cover endpoints when you need the grassland class specifically, or over broader European coverage endpoints when your coordinate is confirmed to be in Portugal.

## Known failure modes

- Coordinate outside Portugal boundary — rejected before payment with a validation error
- Latitude or longitude outside the published European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation failure
- Malformed or missing input fields — 400-level error
- Network or service timeout — no result returned
- Coordinate in Portugal but over sea or non-land area — may return zero or error

## How this service works

Share of ESA WorldCover 2021 pixels classified as grassland. The coordinate is validated against the Natural Earth boundary for Portugal; results outside it are rejected before payment.

## Output

A numeric value representing the share (fraction or percentage) of ESA WorldCover 2021 pixels in the analysis area classified as grassland for the queried coordinate within Portugal.

## 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-southern-land-portugal-grassland-share-19609306/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from suedland.halowerk.com](https://www.zero.xyz/host/suedland.halowerk.com/llms.txt)