# Reverse Geocode Coordinates to Address (OpenStreetMap Nominatim)

> Reverse Geocode Coordinates to Address (OpenStreetMap Nominatim) is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Converts latitude/longitude coordinates into a human-readable nearest street address using OpenStreetMap Nominatim data.

## Facts

- Endpoint: POST https://twin.unykorn.org/reverse-geocode?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reverse-geocode-coordinates-to-address-openstreetmap-nominatim-c2f8bb74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aHUVDa-THhx1hydE7VQgP

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 reverse-geocode-coordinates-to-address-openstreetmap-nominatim-c2f8bb74 -d '<json body>'
```

Example prompt: What's the street address at latitude 48.8584, longitude 2.2945? Give me full detail — zoom level 18.

## When to prefer this

Choose this endpoint when you need a pay-per-call, no-key-required reverse geocoding service backed by OpenStreetMap Nominatim data, especially in autonomous agent pipelines that already use x402 micropayment rails. Suitable for occasional lookups without API key management overhead.

## Known failure modes

- Coordinates outside valid range (-90 to 90 lat, -180 to 180 lon) will be rejected
- Remote or uninhabited areas may return sparse or no address data
- Payment failure (402) if USDC balance is insufficient
- Nominatim rate limits or upstream outages may cause timeouts
- Very low zoom values may return only country or region-level results

## How this service works

Reverse-geocode coordinates to the nearest address (OpenStreetMap Nominatim) — Genesis402 / UnyKorn Operator Network

## Output

Returns a human-readable address corresponding to the provided coordinates, including components such as street name, house number, neighbourhood, city, postcode, and country, derived from OpenStreetMap Nominatim at the requested detail level.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "required": [
    "lat",
    "lon"
   ],
   "properties": {
    "lat": {
     "type": "number",
     "maximum": 90,
     "minimum": -90,
     "description": "latitude -90..90"
    },
    "lon": {
     "type": "number",
     "maximum": 180,
     "minimum": -180,
     "description": "longitude -180..180"
    },
    "zoom": {
     "type": "integer",
     "maximum": 18,
     "minimum": 0,
     "description": "detail level 0-18 (default 18)"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/reverse-geocode-coordinates-to-address-openstreetmap-nominatim-c2f8bb74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)