# AgentTools IP Geolocation Lookup

> AgentTools IP Geolocation Lookup is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Geolocates any IPv4 or IPv6 address (or the caller's own IP) returning country, region, city, coordinates, timezone, ASN, network owner, and currency via ipwho.is

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/live/ip-lookup?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttools-ip-geolocation-lookup-1fc762be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wblRUExmUm-j2Ftzcrxg5

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 agenttools-ip-geolocation-lookup-1fc762be
```

Example prompt: Can you look up where the IP address 203.0.113.45 is located — I need the country, city, timezone, and who owns that network?

## When to prefer this

Choose this endpoint when an agent needs a quick, single-call IP geolocation that bundles country, city, coordinates, timezone, ASN, and currency in one response. It is ideal for enriching log data, personalizing content, detecting fraud patterns, or scheduling across time zones. The 24-hour cache makes it cost-efficient for repeated lookups of the same IP. Prefer alternatives if you need real-time ISP data without caching, bulk batch processing, or highly detailed threat intelligence beyond basic geolocation.

## Known failure modes

- Invalid IP format returns a validation error
- Private or reserved IP ranges (e.g. 192.168.x.x) may return no geolocation data
- Newly allocated IPs not yet in the ipwho.is database may return incomplete results
- Rate limits or upstream ipwho.is outages may result in 503 or timeout responses
- Payment failure (x402) blocks the request before execution

## How this service works

Geolocate any IPv4/IPv6 address (or the caller's own IP when omitted) via ipwho.is: country, region, city, coordinates, timezone, ASN/network owner and currency. Cached 24 hours per IP. Use this when an agent needs to where is an IP address? Country, city, ASN, timezone.

## Output

A JSON object containing the IP address's geographic location (country, country code, region, city, latitude, longitude), timezone identifier, ASN number, network/ISP name, and the local currency — sourced from ipwho.is and cached for 24 hours per IP.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "ip": {
       "type": "string",
       "description": "Leave empty to look up the caller's IP"
      }
     }
    }
   },
   "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/agenttools-ip-geolocation-lookup-1fc762be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)