# Superhighway Geocode

> Superhighway Geocode is a paid API for AI agents from superhighway.walls.sh, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Converts a human-readable address or place name to geographic coordinates (forward geocoding), or converts lat/lon coordinates to a human-readable address (reverse geocoding).

## Facts

- Endpoint: GET https://superhighway.walls.sh/geocode
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/superhighway-geocode-3d5e4962
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C48cjlG7MmHowSkSNK04w

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 superhighway-geocode-3d5e4962
```

Example prompt: What are the latitude and longitude coordinates for 1600 Amphitheatre Parkway, Mountain View, CA?

## When to prefer this

Use this endpoint when you need to geocode a single address to coordinates or reverse-geocode coordinates to an address, especially within an agentic workflow that already uses Superhighway's pay-per-call x402 model. Good for lightweight, on-demand location resolution without setting up a dedicated geocoding API key.

## Known failure modes

- Address not found or ambiguous — returns empty result or error
- Invalid lat/lon values — returns 400 or error
- Missing required parameter (neither q nor lat/lon provided) — returns 400
- Payment not provided or insufficient — returns 402
- Rate limit exceeded — returns 429
- Network timeout or upstream geocoding provider unavailable — returns 5xx

## How this service works

Web search built for AI agents. Search the live web, pull recent news, and read any page as clean markdown — pay per call, free tier to start.

## Output

Returns geographic coordinates (latitude and longitude) for a given address/place, or a human-readable address for given lat/lon coordinates. The response is likely a JSON object containing the resolved location data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Address/place to geocode (forward)."
  },
  "lat": {
   "type": "number",
   "description": "Latitude (reverse; pair with lon)."
  },
  "lon": {
   "type": "number",
   "description": "Longitude (reverse; pair with lat)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/superhighway-geocode-3d5e4962/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from superhighway.walls.sh](https://www.zero.xyz/host/superhighway.walls.sh/llms.txt)