# x402 Utilities Hub – IP Lookup

> x402 Utilities Hub – IP Lookup is a paid API for AI agents from x402-utils-hub.dimkaplay666.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-20).

Returns geolocation and metadata for the caller's or a specified IP address, charged per call in USDC on Base via x402.

## Facts

- Endpoint: POST https://x402-utils-hub.dimkaplay666.workers.dev/v1/ip?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-utilities-hub-ip-lookup-0b8bf36a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_88bF-Y8kXYVrz7vp302Co

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 x402-utilities-hub-ip-lookup-0b8bf36a -d '<json body>'
```

Example prompt: Look up the geolocation and network details for IP address 8.8.8.8 — I need to know what country and city it's in.

## When to prefer this

Choose this endpoint when you need a pay-per-call IP geolocation lookup billed in USDC on Base with no subscription required. Ideal for AI agents that occasionally need IP metadata without committing to a monthly API plan, or when operating in a crypto-native payment context using the x402 protocol.

## Known failure modes

- Invalid or malformed IP address returns an error response
- Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return null or limited data
- Payment failure via x402 protocol returns HTTP 402 and blocks the lookup
- Missing or malformed queryParams causes a 400-level error
- Cloudflare Worker cold-start or service unavailability returns 503

## How this service works

Pay-per-call utilities for AI agents and developers. Paid in USDC on Base via x402 v2.

## Output

Returns a JSON object containing geolocation metadata for the queried IP address, likely including country, region, city, ISP/ASN, timezone, and possibly coordinates. Exact fields depend on the underlying data source used by the worker.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "queryParams"
   ],
   "properties": {
    "queryParams": {
     "type": "object"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "example": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-utilities-hub-ip-lookup-0b8bf36a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-utils-hub.dimkaplay666.workers.dev](https://www.zero.xyz/host/x402-utils-hub.dimkaplay666.workers.dev/llms.txt)