# Halowerk Geocoding API

> Halowerk Geocoding API is a paid API for AI agents from tools.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Performs forward and reverse geocoding with normalized address output (street, number, postcode, city, state, country) and result caching, requiring no API key or account.

## Facts

- Endpoint: POST https://tools.halowerk.com/v1/geocode
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-geocoding-api-b0250b22
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SLEm-xrBfLebvc8g3pZHT

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-geocoding-api-b0250b22 -d '<json body>'
```

Example prompt: Can you geocode 'Unter den Linden 77, 10117 Berlin, Germany' and give me the normalized address components plus the exact latitude and longitude?

## When to prefer this

Choose this endpoint when you need geocoding or reverse geocoding without signing up for an API key or account, especially for German or European addresses. It is well-suited for agents needing quick, normalized address components with caching benefits, and at a very low per-call cost of $0.001 USDC. Prefer this over alternatives when key-free access and address normalization (not just coordinates) are the priority.

## Known failure modes

- Address not found or ambiguous — returns empty result or low-confidence match
- Invalid or malformed input address — returns error or null result
- Coordinates outside supported regions — may return no result
- Network timeout — transient failure requiring retry
- Payment processing failure via x402 protocol — call not executed

## How this service works

Vorwärts- und Rückwärtsgeokodierung mit normalisierter Adresse (Straße, Hausnummer, PLZ, Ort, Bundesland, Land) und Ergebnis-Cache. Kein Schlüssel, kein Konto.

## Output

Returns a normalized address broken into discrete fields (street, house number, postcode, city, state, country) along with latitude and longitude coordinates. Results may be served from cache for repeated queries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  },
  "limit": {
   "type": "integer",
   "default": 3,
   "maximum": 10
  },
  "query": {
   "type": "string",
   "description": "Freitext-Adresse für Vorwärtssuche"
  },
  "country": {
   "type": "string",
   "description": "ISO-Code zur Einschränkung, z. B. de"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-geocoding-api-b0250b22/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.halowerk.com](https://www.zero.xyz/host/tools.halowerk.com/llms.txt)