# x402-farm Reverse Geocoding (BAN/Nominatim)

> x402-farm Reverse Geocoding (BAN/Nominatim) is a paid API for AI agents from api.x-402.online, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-01).

Converts latitude/longitude coordinates into the nearest postal address using BAN for France (with INSEE code) and Nominatim/OpenStreetMap elsewhere.

## Facts

- Endpoint: GET https://api.x-402.online/v1/geo/reverse?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-farm-reverse-geocoding-ban-nominatim-0612cdc4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XK5jELSBVlMiliXN7S-TU

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 x402-farm-reverse-geocoding-ban-nominatim-0612cdc4
```

Example prompt: What's the postal address at coordinates 48.8698 latitude and 2.3310 longitude — give me the full street address including postcode.

## When to prefer this

Choose this endpoint when you need pay-per-call reverse geocoding with no account or subscription required, especially for French addresses where BAN data provides authoritative INSEE codes. Ideal for AI agents using the x402 protocol on Base with USDC microtransactions, where per-call billing is preferred over monthly API plans. Best for lightweight, sporadic lookups rather than bulk batch geocoding.

## Known failure modes

- Coordinates in the middle of the ocean or uninhabited areas may return no address or a low-confidence nearest match
- Missing or malformed lat/lon query parameters will return a 400 error
- Coordinates outside supported regions may return incomplete address data from Nominatim
- Payment failure or insufficient USDC balance will return a 402 Payment Required response

## How this service works

Turn coordinates into the nearest postal address: BAN in France, OpenStreetMap elsewhere. Coordinates to the nearest address: BAN in France (with INSEE code), Nominatim elsewhere. Query: ?lat=48.8698&lon=2.3310

## Output

A structured address object including street number, street name, city/municipality, postcode, and country. For French coordinates, also includes the INSEE commune code sourced from the Base Adresse Nationale (BAN). For all other locations, address data comes from Nominatim/OpenStreetMap.

## 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",
     "properties": {}
    }
   },
   "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/x402-farm-reverse-geocoding-ban-nominatim-0612cdc4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x-402.online](https://www.zero.xyz/host/api.x-402.online/llms.txt)