# Geocode Address (OpenStreetMap Nominatim)

> Geocode Address (OpenStreetMap Nominatim) is a paid API for AI agents from 6xrkjcfa3yrzvefcpvanurzou4.srv.us, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Converts a free-text address or place name to latitude/longitude coordinates, or reverse-geocodes coordinates to an address, using OpenStreetMap Nominatim with no API key required.

## Facts

- Endpoint: GET https://6xrkjcfa3yrzvefcpvanurzou4.srv.us/api/geocode-address?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geocode-address-openstreetmap-nominatim-73e35089
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1jtw2yqvYeFyLxTEglVlF

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 geocode-address-openstreetmap-nominatim-73e35089
```

Example prompt: Can you geocode '1600 Pennsylvania Avenue NW, Washington, DC' to get its latitude and longitude, structured address components, and a confidence score on how well it resolved?

## When to prefer this

Choose this endpoint when you need keyless, no-signup geocoding powered by OpenStreetMap Nominatim, especially for free-tier or high-privacy use cases where you don't want to share data with Google or HERE. It's ideal when you need structured address decomposition, OSM entity metadata, bounding boxes, and a built-in quality score (geocode_score with letter grade and resolution status) in a single call. Prefer alternatives like Google Geocoding API when you need the most up-to-date commercial POI data or guaranteed SLA.

## Known failure modes

- Address not found in OSM: returns empty results array
- Ambiguous address: returns multiple candidates with AMBIGUOUS status and lower geocode_score
- Malformed or missing query parameter: returns error indicating required q, address, or query param
- Rate limiting from upstream Nominatim: may return 429 or timeout
- Very new or unmapped addresses absent from OSM data: no results or low-confidence match

## How this service works

Geocode address to coordinates - geocode an address or place name to latitude and longitude. Up to 10 matches: lat/lon, display name, structured address (road, city, state, postcode, country code), OSM type and id, importance and bounding box. GET ?q= OR ?address= OR ?query= OR ?lat=&lon= (reverse) OR ?sample=1|2|3 OR POST application/json with q|address|query. KEYLESS OpenStreetMap Nominatim - no key, no account, no signup. Returns a geocode_score 0-100 A-F with a RESOLVED / AMBIGUOUS /...

## Output

Returns up to 10 match candidates, each containing: latitude/longitude, display name, structured address fields (road, city, state, postcode, country code), OSM type and ID, importance score, and bounding box. Also includes a geocode_score from 0–100 with letter grade (A–F) and a resolution status label such as RESOLVED or AMBIGUOUS.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/geocode-address-openstreetmap-nominatim-73e35089/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 6xrkjcfa3yrzvefcpvanurzou4.srv.us](https://www.zero.xyz/host/6xrkjcfa3yrzvefcpvanurzou4.srv.us/llms.txt)