# TokenGuard IP Geolocation Lookup

> TokenGuard IP Geolocation Lookup is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns geolocation and ISP information for the caller's public IP address including city, country, coordinates, and timezone

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/ip
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-ip-geolocation-lookup-51b3f86d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ToHKiGgXLy032hPspsMGk

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 tokenguard-ip-geolocation-lookup-51b3f86d -d '<json body>'
```

Example prompt: What is my current public IP address, and where is it geolocated — can you tell me the city, country, ISP, and coordinates?

## When to prefer this

Use this endpoint when you need a quick, low-cost ($0.005) IP geolocation lookup with ISP and timezone data for the caller's own IP, especially within a crypto/DeFi agent workflow already using the TokenGuard API suite on Base network micropayments.

## Known failure modes

- Request originates from an unresolvable or private IP — may return incomplete location data
- ISP or location data not available for certain IP ranges (e.g. Tor exit nodes, VPNs) — fields may be null or inaccurate
- Payment failure via x402 micropayment — returns 402 Payment Required
- Rate limiting or service unavailability on the HuggingFace Space — returns 5xx error

## How this service works

IP geolocation via ipwho.is (free, no API key). Returns country, region, city, lat/lon, timezone, ASN, ISP. Pass empty string to geolocate caller IP.

## Output

A JSON object containing the caller's public IP address, ISP name, city, country, country code (e.g. 'US'), IP type (IPv4/IPv6), latitude, longitude, and timezone string (e.g. 'America/Los_Angeles').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ip": {
   "type": "string",
   "description": "IPv4 or IPv6 address; empty string or 'self' to geolocate caller"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ip": "8.8.8.8",
  "isp": "Google LLC",
  "city": "Mountain View",
  "type": "IPv4",
  "country": "United States",
  "latitude": 37.386,
  "timezone": "America/Los_Angeles",
  "longitude": -122.0838,
  "country_code": "US"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-ip-geolocation-lookup-51b3f86d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)