# x402-toolbox IP Geolocation

> x402-toolbox IP Geolocation is a paid API for AI agents from x402-toolbox.shablony-pro.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-02).

Geolocates an IP address, returning geographic metadata such as country, city, and coordinates, paid per-call via x402/USDC with no API key required.

## Facts

- Endpoint: GET https://x402-toolbox.shablony-pro.workers.dev/geo/ip-geolocation?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-toolbox-ip-geolocation-d5133b7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_akYbtvbe_meC9-QrteGmt

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-toolbox-ip-geolocation-d5133b7b
```

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

## When to prefer this

Choose this endpoint when you need a pay-per-call IP geolocation lookup with no API key or signup required, authenticated purely via x402 USDC micropayment on Base. Ideal for AI agents operating autonomously that need to resolve IP addresses to geographic metadata on demand without managing credentials.

## Known failure modes

- Invalid or malformed IP address returns an error
- Private/reserved IP ranges (e.g. 192.168.x.x) may return no geolocation data
- Payment failure via x402 results in a 402 response and no data
- Missing or malformed schema parameter may cause unexpected behavior
- Rate limits or worker downtime on the Cloudflare Workers backend

## How this service works

309 deterministic pay-per-call tools for AI agents over x402 (USDC, Base). No signup, no API key: the payment is the identity.

## Output

Returns a JSON object with geolocation data for the given IP address, including fields such as country, region, city, latitude, longitude, timezone, and ISP. The response includes ok and paid status flags confirming successful payment and data retrieval.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "schema": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "paid": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-toolbox-ip-geolocation-d5133b7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-toolbox.shablony-pro.workers.dev](https://www.zero.xyz/host/x402-toolbox.shablony-pro.workers.dev/llms.txt)