# WorldData402 IP Geolocation Lookup

> WorldData402 IP Geolocation Lookup is a paid API for AI agents from worlddata402.worlddata402.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-22).

Looks up geolocation and contextual data for a given IP address, paid per-call via x402 USDC micropayment.

## Facts

- Endpoint: POST https://worlddata402.worlddata402.workers.dev/v1/ip/%7Bip%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/worlddata402-ip-geolocation-lookup-6e07e9a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bAFQeJsPuK_vXp3j0KbiL

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 worlddata402-ip-geolocation-lookup-6e07e9a0 -d '<json body>'
```

Example prompt: Can you look up where the IP address 203.0.113.45 is located — I need the country, city, and ISP information for it.

## When to prefer this

Choose this endpoint when you need pay-per-call IP geolocation with no subscription commitment, billed in USDC micropayments via x402. Ideal for AI agents that need occasional IP lookups without managing API keys or monthly plans. Best suited for agents already operating in the x402/Base ecosystem.

## 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 no geolocation data
- Payment failure or insufficient USDC balance blocks the request
- Rate limits or quota exhaustion may return 429 errors
- IPv6 addresses may have limited data coverage

## How this service works

Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).

## Output

Returns geolocation and network metadata for the queried IP address, including country, region, city, latitude/longitude, ISP/ASN, and possibly timezone and other reference data attributes.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/worlddata402-ip-geolocation-lookup-6e07e9a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from worlddata402.worlddata402.workers.dev](https://www.zero.xyz/host/worlddata402.worlddata402.workers.dev/llms.txt)