# Forward Geocode Address to Coordinates (OpenStreetMap Nominatim)

> Forward Geocode Address to Coordinates (OpenStreetMap Nominatim) is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Converts a free-text address string into latitude/longitude coordinates, address components, bounding box, and place type using OpenStreetMap Nominatim.

## Facts

- Endpoint: GET https://api.x402node.dev/maps/forward
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-x402node-dev-5b1d3006
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vsgH3sQ3BB0P9nZytb-xL

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 api-x402node-dev-5b1d3006
```

Example prompt: What are the latitude and longitude coordinates for 1600 Pennsylvania Ave, Washington DC? Give me up to 3 results.

## When to prefer this

Use this endpoint when an AI agent needs to resolve a human-readable address or place name into geographic coordinates for use in delivery routing, map rendering, logistics planning, or any geospatial computation. Prefer this over reverse geocoding endpoints when you have an address and need coordinates (not the other way around). This is well-suited for agent workflows involving delivery addresses, store locators, or any scenario requiring lat/lng from user-supplied location text.

## Known failure modes

- Address not found or too ambiguous — returns empty results array
- Invalid or malformed query string — returns error response
- Rate limiting or payment failure — returns 402 Payment Required
- Nominatim upstream unavailable — returns 5xx error

## How this service works

Forward geocode an address to lat/lng using OpenStreetMap Nominatim. Returns coordinates, address components, bounding box, place type. Use ?q=1600+Pennsylvania+Ave+Washington+DC plus optional and limit=5. Built for AI agents handling delivery, logistics, and map UIs. Accepts payment on Base or Solana — either network works.

## Output

Returns one or more geocoding results, each containing latitude and longitude coordinates, structured address components (street, city, country, etc.), a bounding box for the location, and a place type classification (e.g. building, city, road).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search query (required)"
      },
      "limit": {
       "type": "string",
       "description": "Max results (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-x402node-dev-5b1d3006/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)