# AgentToll IP Geolocation (OSINT)

> AgentToll IP Geolocation (OSINT) is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Looks up geographic location and metadata for a given IPv4 or IPv6 address, paid per-call in USDC via x402.

## Facts

- Endpoint: POST https://agenttoll.dev/paid/osint/ip-geo
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-ip-geolocation-osint-1b9fd2e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tSh9Tfdd3By6FPRLJwLde

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 agenttoll-ip-geolocation-osint-1b9fd2e3 -d '<json body>'
```

Example prompt: Can you geolocate the IP address 203.0.113.42 for me — I want to know what country, city, and ISP it's associated with?

## When to prefer this

Choose this endpoint when you need pay-per-call IP geolocation without a subscription commitment, particularly in agentic or automated workflows using the x402 micropayment protocol on Base. Ideal for OSINT investigations, log enrichment, and fraud detection where you need geographic and ISP context for arbitrary IPv4 or IPv6 addresses.

## Known failure modes

- Invalid or malformed IP address format returns an error
- 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
- Geolocation data may be approximate or unavailable for some IP ranges

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns a JSON object containing geographic and network metadata for the queried IP address, typically including country, region, city, latitude/longitude, ISP or organization name, ASN, and timezone.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ip": {
   "type": "string",
   "description": "string IPv4 or IPv6 address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-ip-geolocation-osint-1b9fd2e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)