$ man reverse-geocode
/reverse-geocode(1)
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
localeCATEGORY
utilities
STATUS
● live
NAME
reverse-geocode — reverse geocoder / lat-lng-to-address
SYNOPSIS
POST https://x402.org/v1/reverse-geocode
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Reverse geocoder / lat-lng-to-address. Coords → structured address (road, city, state, postcode, country). Powered by OpenStreetMap Nominatim.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| latitude | number | Latitude in decimal degrees. Range -90 to 90. | required |
| longitude | number | Longitude in decimal degrees. Range -180 to 180. | required |
| zoom | number | 3 (country) → 18 (building). Default 17. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| latitude | number | Echoed latitude of the queried point in decimal degrees. |
| longitude | number | Echoed longitude of the queried point in decimal degrees. |
| zoom | number | Nominatim zoom level controlling address granularity (3=country, 18=building). |
| display_name | string | Full human-readable address string joined from the address components. |
| address | object | Structured address parts: road, house_number, city, state, postcode, country, country_code. |
| name | string | Local name of the matched place, when Nominatim has one distinct from the full address. |
| type | string | OSM feature type of the match (e.g. residential, city, house, restaurant). |
| class | string | OSM feature class of the match (e.g. highway, place, building, amenity). |
| importance | number | Nominatim importance score from 0 to 1 ranking the match's prominence. |
| bounding_box | array | [south, north, west, east] lat/lng bounds of the matched feature. |
| osm_id | number | OpenStreetMap object ID of the matched feature. |
| place_id | number | Nominatim internal place identifier for the matched feature. |
| source | string | Upstream data source for the lookup, here "nominatim" (OpenStreetMap). |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/reverse-geocode \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the reverse-geocode tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- geocodereverselocationmapsosm
- methods
- POST
- cluster
- locale
- price
- $0.02 USDC per call
ADJACENT — other endpoints in locale
| endpoint | description | price |
|---|---|---|
| address-geocode | Geocoder / address-to-lat-lng / location resolver. | $0.02 |
| airport-delays | FAA NAS Status — current US airport delays, ground stops, ground delay programs, weather-driven program changes. | $0.02 |
| bin-lookup | Credit card BIN / IIN lookup. | $0.02 |
| card-bin-lookup | Credit card BIN lookup / IIN lookup / card-issuer lookup. | $0.02 |
| satellite-bbox | Bounding-box satellite composite / Sentinel-2 cloud-free mosaic / region satellite snapshot / arbitrary bbox to imagery. | $0.02 |
| building-permits | Building permits multi-city open-data lookup. | $0.03 |
| flight-status | Flight status / live aircraft position / flight tracker / ICAO24 lookup / callsign lookup / aircraft bounding-box / OpenSky Network state… | $0.01 |
| property-tax | Property tax lookup. | $0.01 |
SEE ALSO