# Suverse Photon Geocoder

> Suverse Photon Geocoder is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-13).

Geocodes a place name or address to geographic coordinates using Photon (OpenStreetMap-backed), returning ranked GeoJSON results with name, country, city, postcode, and OSM IDs.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-photon-geocode
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-photon-geocoder-9f2f2c68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j1VSU3PukrcDtPGg9I5y0

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 suverse-photon-geocoder-9f2f2c68 -d '<json body>'
```

Example prompt: Can you geocode '10 Downing Street, London' and give me the latitude, longitude, postcode, and OSM ID from the top result?

## When to prefer this

Choose this endpoint when you need keyless, OpenStreetMap-backed geocoding with GeoJSON output that includes OSM IDs, postcode, city, and country — especially in agent workflows that avoid managing API keys or when OSM coverage and licensing is preferred over commercial geocoders like Google Maps or Mapbox.

## Known failure modes

- Ambiguous place name returns unrelated or low-confidence results
- Non-existent or misspelled address returns empty feature list
- Network timeout or upstream Photon service unavailability returns error
- Malformed POST body causes 400 bad request
- x402 payment failure prevents call from completing

## How this service works

Geocode a place name or address to coordinates via Photon, the OpenStreetMap-backed geocoder. Returns ranked GeoJSON with name, country, city, postcode and OSM ids. Keyless.

## Output

A ranked list of GeoJSON Feature objects, each containing geometry (type and coordinates), and properties such as name, country, city, postcode, and OSM IDs. Results are ordered by relevance to the input query.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/suverse-photon-geocoder-9f2f2c68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)