# IP Geolocation Lookup

> IP Geolocation Lookup is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Geolocates an IP address and returns country, city, coordinates, timezone, and ISP information as JSON

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/ip-geolocation
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ip-geolocation-lookup-0603e3bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z9Txi5UjnyrZBfzPGP0SS

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 ip-geolocation-lookup-0603e3bc -d '<json body>'
```

Example prompt: Can you geolocate the IP address 203.0.113.42 and tell me what country, city, timezone, and ISP it belongs to?

## When to prefer this

Use this endpoint when you need to quickly resolve a single IP address to its physical location metadata including country, city, coordinates, timezone, and ISP. Prefer this over manual WHOIS lookups or building your own geolocation pipeline. Ideal for enriching logs, personalizing content by region, or identifying the origin of network traffic.

## Known failure modes

- Invalid or malformed IP address returns an error response
- Private/reserved IP addresses (e.g. 192.168.x.x, 10.x.x.x) may not return meaningful geolocation data
- IPv6 addresses may not be supported or may return partial data
- Payment failure (402) if USDC balance is insufficient
- Rate limiting or timeout if the service is overloaded

## How this service works

GEO: geolocate an IP address (?ip=8.8.8.8) → country, city, coordinates, timezone, ISP. Returns JSON.

## Output

A JSON object containing the IP address's resolved country, city, latitude/longitude coordinates, timezone, and ISP name.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ip-geolocation-lookup-0603e3bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)