# IPinfo via Locus x402 — IP Lookup

> IPinfo via Locus x402 — IP Lookup is a paid API for AI agents from ipinfo.x402.paywithlocus.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-13).

Looks up geolocation, ASN, privacy detection, carrier data, and hosting identification for a given IP address using IPinfo data, paid via x402 micropayment.

## Facts

- Endpoint: POST https://ipinfo.x402.paywithlocus.com/ipinfo/ip-lookup?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ipinfo-via-locus-x402-ip-lookup-01461f0e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6vPd3VFmBLQ_cjn00fpaP

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 ipinfo-via-locus-x402-ip-lookup-01461f0e -d '<json body>'
```

Example prompt: Can you look up the geolocation, ASN, and privacy flags for IP address 203.0.113.42 — I want to know what country it's in, who the ISP is, and whether it's flagged as a VPN or hosting provider?

## When to prefer this

Choose this endpoint when you need reliable IPinfo-quality intelligence (industry-standard geolocation, ASN, and privacy detection) and want to pay per-call via x402 micropayment without a subscription API key. Ideal for agents that need occasional IP lookups without managing credentials, or for workflows that need privacy/VPN detection alongside geolocation in a single call.

## Known failure modes

- Invalid IP format — malformed IP string returns an error
- Private or reserved IP ranges may return no geolocation data
- Rate limiting or payment failure could prevent response
- Unknown or newly allocated IPs may have incomplete data
- IPv6 addresses may have less detailed geolocation than IPv4

## How this service works

IP intelligence — geolocation, ASN, privacy detection, carrier data, and hosting identification.

## Output

A JSON object containing IP intelligence data including geolocation (city, region, country, coordinates), ASN and ISP details, privacy detection flags (VPN, proxy, Tor, hosting), and carrier information. Also includes payment confirmation metadata showing settled USDC amount and a request tracking ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ip": {
   "type": "string",
   "description": "IPv4 address, IPv6 address, or \"me\" for the caller's IP"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ipinfo-via-locus-x402-ip-lookup-01461f0e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ipinfo.x402.paywithlocus.com](https://www.zero.xyz/host/ipinfo.x402.paywithlocus.com/llms.txt)