# Geocoding & Reverse Geocoding API

Address to coordinates, coordinates to address.

| Field | Value |
| --- | --- |
| Provider | APIStead Labs |
| Category | Weather & Geospatial |
| Networks | Base |
| Price | $0.001 per call |
| Base URL | https://apistead.qd.je/api/v1 |
| Verification | verified (2/2 routes) |
| Last verified | 2026-11-13T13:52:22.884Z |
| Receipt | https://basescan.org/tx/0x895d6612a320ee74cb276d1ecd31da3768f208d4d4919c4d21ea67b07e3b9cf0 |
| JSON | https://x402.apistead.qd.je/api/apis/geocoding-api |
| Markdown | https://x402.apistead.qd.je/api/apis/geocoding-api/md |
| MCP | https://apistead.qd.je/mcp |
| API reference | https://x402.apistead.qd.je/api |
| OpenAPI | https://x402.apistead.qd.je/openapi.json |

## For AI agents

Convert a free-text address or place into coordinates and a normalised address, or reverse geocode coordinates.

## Scope

Does not validate postal deliverability or rooftop accuracy. Uses OpenStreetMap data and is not a legal boundary source.

## Agent intents

- geocode an address
- turn coordinates into an address
- find latitude and longitude for a place
- normalise an address for an agent

Geocoding is a foundational agent tool. This API handles forward geocoding (address to coordinates) and reverse geocoding (coordinates to address), with a confidence score and normalized components.

It is designed for chaining: the response is small, stable and includes a `place_id` so an agent can refer to the same place across calls. The preview uses OpenStreetMap Nominatim with a proper user agent and caching. For production volume, swap in a commercial geocoder behind the same response shape.

## Endpoints

### GET /reverse?lat={lat}&lon={lon}

Reverse geocode a coordinate.

- URL: https://apistead.qd.je/api/v1/reverse?lat={lat}&lon={lon}
- Price: $0.001 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T04:35:10.452Z
- Latency: 5 ms
- Uptime (30d): 87%

Example request:

```http
GET https://apistead.qd.je/api/v1/reverse?lat=51.5034&lon=-0.1276
```

Example response:

```json
{
  "city": "London",
  "source": "openstreetmap",
  "country": "United Kingdom",
  "place_id": "osm:relation:1879842",
  "country_code": "gb",
  "formatted_address": "10 Downing Street, London, SW1A 2AA, United Kingdom"
}
```

### GET /geocode?address={address}

Forward geocode an address.

- URL: https://apistead.qd.je/api/v1/geocode?address={address}
- Price: $0.001 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T04:35:10.444Z
- Latency: 4 ms
- Uptime (30d): 87%

Example request:

```http
GET https://apistead.qd.je/api/v1/geocode?address=10%20Downing%20Street%20London
```

Example response:

```json
{
  "lat": 51.5034,
  "lon": -0.1276,
  "source": "openstreetmap",
  "place_id": "osm:relation:1879842",
  "confidence": 0.95,
  "formatted_address": "10 Downing Street, London, SW1A 2AA, United Kingdom"
}
```

## Payment

Every paid route uses x402 over HTTP. Call the route without payment to receive a 402 challenge, then pay the quoted USDC amount and retry. The 402 challenge is the authoritative source for price, asset, network and pay-to address. Reading this record and the discovery API is free.

- Protocol: x402 v2
- Asset: USDC
- Networks: Base
- Price: $0.001 per call

## Verification

- State: verified
- Routes verified: 2/2
- Last verified: 2026-11-13T13:52:22.884Z
- Receipt: https://basescan.org/tx/0x895d6612a320ee74cb276d1ecd31da3768f208d4d4919c4d21ea67b07e3b9cf0

## Agent links

- JSON: https://x402.apistead.qd.je/api/apis/geocoding-api
- Markdown: https://x402.apistead.qd.je/api/apis/geocoding-api/md
- Routes: https://x402.apistead.qd.je/agent/routes?id=geocoding-api
- Receipts: https://x402.apistead.qd.je/agent/receipts?id=geocoding-api
- API reference: https://x402.apistead.qd.je/api
- MCP guide: https://x402.apistead.qd.je/mcp-docs
- Agent skill: https://x402.apistead.qd.je/skill
- OpenAPI: https://x402.apistead.qd.je/openapi.json
- MCP: https://apistead.qd.je/mcp
- Docs: https://apistead.qd.je/api


## Changelog

### 1.0.0 - Initial verified release

The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.

release · 2026-11-11 · APIStead Labs