# IP Geolocation Lookup via proxy.suverse.io

> IP Geolocation Lookup via proxy.suverse.io is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns country, region, city, timezone, ISP, and ASN information for the requesting IP address using ipwho.is

## Facts

- Endpoint: GET https://proxy.suverse.io/v1/data/ip-geolocation
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/proxy-suverse-io-16b33a38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_usQNFjZ4ISdhSD0sof4Pj

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 proxy-suverse-io-16b33a38
```

Example prompt: What country, city, and ISP is my current IP address associated with? I need the timezone and ASN too for localization purposes.

## When to prefer this

Use this endpoint when you need quick, keyless IP geolocation with ISP and ASN data for the requesting IP specifically — ideal for AI agents needing geographic context about who is calling them, fraud detection pipelines, or automatic localization without managing separate API keys. Prefer over direct ipwho.is calls when working within a paid x402 micropayment workflow on proxy.suverse.io.

## Known failure modes

- Rate limit exceeded (10k req/month/IP limit from underlying ipwho.is provider)
- Payment failure or insufficient USDC balance preventing x402 access
- Upstream ipwho.is service unavailable or returning errors
- Private/internal IP addresses may return incomplete or null geolocation data
- VPN or proxy IPs may return inaccurate or misleading geolocation data

## How this service works

IP geolocation lookup for the requesting IP. Returns country, region, city, timezone, ISP, ASN. Powered by ipwho.is. AI agent fraud detection, localization, geo-context API, IP-to-country, IP-to-city, pay-per-call USDC.

## Output

Returns a JSON object containing the requesting IP's country, region, city, timezone, ISP name, and ASN number — all derived from the ipwho.is service without requiring an API key.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/proxy-suverse-io-16b33a38/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)