# ADH Geocode — Address to Coordinates Lookup

> ADH Geocode — Address to Coordinates Lookup is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Converts a location name or address into structured geocoded data including latitude, longitude, county, municipality, and full address components.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/ee-geocode
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adh-geocode-address-to-coordinates-lookup-c18b5726
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZshkP6tgvG-fW-yKY7nX7

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 adh-geocode-address-to-coordinates-lookup-c18b5726
```

Example prompt: Can you geocode 'Tallinn, Estonia' for me and get back the latitude, longitude, county, and full structured address?

## When to prefer this

Choose this endpoint when you need structured geocoding with entity-resolved address components (county, municipality, settlement) and provenance metadata (source, collected_at timestamp) injected into an AI agent context. Prefer it over generic geocoding APIs when operating within the x402 micropayment ecosystem or when you need the ADH data layer's entity resolution and time-synchronization guarantees alongside coordinates.

## Known failure modes

- Ambiguous or misspelled location name may return multiple or incorrect results
- Unknown or very remote locations may return empty data array
- Missing or malformed 'input' query parameter returns a validation error
- Payment failure via x402 protocol blocks the request
- Rate limiting may occur under high query volume

## How this service works

ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。

## Output

Returns a JSON object with an array of geocoded results, each containing latitude, longitude, county, municipality, settlement, street, house number, zip code, apartment, and full address string. Also includes a success flag, data source identifier, data type label, and a collection timestamp.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "data": [
    {
     "county": "Harju maakond",
     "street": "",
     "latitude": 59.432438,
     "zip_code": "",
     "apartment": "",
     "longitude": 24.744066,
     "settlement": "",
     "full_address": "Harju maakond, Tallinn",
     "house_number": "",
     "municipality": "Tallinn"
    },
    {
     "county": "Harju maakond",
     "street": "",
     "latitude": 59.432438,
     "zip_code": "",
     "apartment": "",
     "longitude": 24.744066,
     "settlement": "",
     "full_address": "Harju maakond, Tallinn",
     "house_number": "",
     "municipality": "Tallinn"
    }
   ],
   "success": true
  },
  "source": "generic_json",
  "data_type": "地理",
  "collected_at": "2026-08-09T18:16:23Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adh-geocode-address-to-coordinates-lookup-c18b5726/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)