# Synapse Geocoding API

> Synapse Geocoding API is a paid API for AI agents from anibalb.duckdns.org, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Converts a place name or address into geographic coordinates (latitude and longitude) along with a structured display name

## Facts

- Endpoint: GET https://anibalb.duckdns.org/x402/geocoding?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synapse-geocoding-api-b1e03442
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CSzBOBXdBI0w6SH1ndR_m

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 synapse-geocoding-api-b1e03442
```

Example prompt: Can you look up the latitude and longitude for Paris, France so I can use the coordinates in my mapping app?

## When to prefer this

Choose this endpoint when you need to convert a human-readable place name or address into geographic coordinates without needing an API key or account setup. It is priced per call in USDC via x402, making it suitable for lightweight, pay-as-you-go geocoding in agent workflows.

## Known failure modes

- Missing or empty query parameter returns an error or empty results array
- Ambiguous place name may return multiple results requiring disambiguation
- Unknown or misspelled location returns an empty results array
- Network or upstream provider outage returns a 5xx error
- Payment failure via x402 returns a 402 Payment Required response

## How this service works

Public data and utility APIs paid per call in USDC on Base (x402). No accounts, no API keys. 174 routes: crypto/equity data, onchain reads, DNS/email/security intel, geo/weather, x402 payment diagnostics, dev utilities and more.

## Output

Returns a JSON array of matching location results, each containing latitude, longitude, a short place name, and a full display name with region and country context (e.g. {lat: '48.8588897', lon: '2.3200410', name: 'Paris', display_name: 'Paris, Ile-de-France, France'}).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "lat": "48.8588897",
    "lon": "2.3200410",
    "name": "Paris",
    "display_name": "Paris, Ile-de-France, France"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synapse-geocoding-api-b1e03442/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from anibalb.duckdns.org](https://www.zero.xyz/host/anibalb.duckdns.org/llms.txt)