# IP Intelligence Lookup (x402 Micro-Pay)

> IP Intelligence Lookup (x402 Micro-Pay) is a paid API for AI agents from x402-micro-pay.com, paid per call via x402, $0.0033/call, status unknown (last checked 2026-11-20).

Returns geolocation, network routing, ASN, and registry metadata for a given IPv4 or IPv6 address or CIDR block, with optional bulk membership testing.

## Facts

- Endpoint: POST https://x402-micro-pay.com/api/skills/ip-intel?utm_source=zero.xyz
- Price: $0.0033/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ip-intelligence-lookup-x402-micro-pay-04cf2701
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PhDNcyfsPb7HNf-NIirKc

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 ip-intelligence-lookup-x402-micro-pay-04cf2701 -d '<json body>'
```

Example prompt: Look up the full IP intelligence for 8.8.8.8 — I need its country, ASN, organization name, routed prefix, and the abuse contact email from the registry.

## When to prefer this

Choose this endpoint when you need comprehensive, multi-source IP intelligence in a single call — combining geolocation (DB-IP), routing (RIPEstat), and registry (RDAP/ARIN) data. Prefer it over single-purpose geo APIs when you also need ASN, abuse contact, or CIDR registry details. The x402 micropayment model makes it ideal for agents that need pay-per-use access with no account setup.

## Known failure modes

- Invalid or non-routable IP returns an error or empty routing/registry fields
- Private/RFC-1918 addresses may return no geolocation or registry data
- CIDR too large may be rejected or return partial results
- HTTP 402 returned if payment not included (x402 protocol required)
- Geolocation country may differ from registry country due to DB-IP Lite limitations
- Rate or size limits: maximum 50 IPs in the check array

## How this service works

41 pay-per-call JSON APIs for AI agents. No account or API key: an unpaid POST returns HTTP 402, pay in USDC on Base with x402 v2, retry. Prices from $0.001 per call.

## Output

A JSON object containing: geo (country, dataset, attribution), network (first/last address, prefix, version, is_global, reverse_pointer), routing (ASNs, AS holder, routed prefix), registry (name, type, CIDRs, holder, registered date, abuse email, start/end address), a plain-text summary, confidence score, data sources with fetch timestamps, and optional warnings about data quality.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "check": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 45
   },
   "maxItems": 50,
   "description": "IPs to test for membership in the network"
  },
  "query": {
   "type": "string",
   "maxLength": 64,
   "minLength": 2,
   "description": "IPv4/IPv6 address or CIDR"
  },
  "request_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9._:-]+$",
   "maxLength": 64,
   "minLength": 1,
   "description": "Optional idempotency key. Echoed back; a credit-pack redemption with the same request_id and body is charged once."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "geo": {
    "country": "US",
    "dataset": "DB-IP IP-to-Country Lite 2026-10",
    "attribution": {
     "url": "https://db-ip.com",
     "text": "IP Geolocation by DB-IP",
     "license": "CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)"
    },
    "countries_at_edges": [
     "US"
    ]
   },
   "network": {
    "last": "8.8.8.8",
    "first": "8.8.8.8",
    "query": "8.8.8.8",
    "network": "8.8.8.8/32",
    "version": 4,
    "is_global": true,
    "num_addresses": "1",
    "prefix_length": 32,
    "reverse_pointer": "8.8.8.8.in-addr.arpa",
    "is_single_address": true
   },
   "routing": {
    "asns": [
     15169
    ],
    "as_holder": "GOOGLE - Google LLC",
    "routed_prefix": "8.8.8.0/24"
   },
   "registry": {
    "name": "GOGL",
    "type": "DIRECT ALLOCATION",
    "cidrs": [
     "8.8.8.0/24"
    ],
    "handle": "NET-8-8-8-0-2",
    "holder": "Google LLC",
    "registered": "2023-12-28T17:24:33-05:00",
    "abuse_email": "network-abuse@google.com",
    "end_address": "8.8.8.255",
    "last_changed": "2023-12-28T17:24:56-05:00",
    "start_address": "8.8.8.0",
    "registry_country": null,
    "origin_asns_registered": null
   }
  },
  "next": [
   "email_check"
  ],
  "skill": "ip_intel",
  "charged": true,
  "service": "ip_intel",
  "sources": [
   {
    "url": "https://rdap.arin.net/registry/ip/8.8.8.8",
    "name": "RIR RDAP (via rdap.org bootstrap)",
    "fetched_at": "2026-10-17T11:12:56Z"
   },
   {
    "url": "https://stat.ripe.net/data/network-info/data.json?resource=8.8.8.8",
    "name": "RIPEstat network-info / as-overview",
    "fetched_at": "2026-10-17T11:12:56Z"
   },
   {
    "url": "https://db-ip.com",
    "name": "IP Geolocation by DB-IP",
    "license": "CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)",
    "fetched_at": "2026-10-17T11:12:56Z",
    "dataset_month": "2026-10"
   }
  ],
  "summary": "8.8.8.8/32: AS15169 GOOGLE - Google LLC, Google LLC, US",
  "version": "1.0.0",
  "warnings": [
   "country is DB-IP Lite geolocation (country-level, monthly); it can differ from the registry country"
  ],
  "confidence": 0.9,
  "data_as_of": "2026-10-17T11:12:56Z",
  "attribution": {
   "url": "https://db-ip.com",
   "text": "IP Geolocation by DB-IP",
   "license": "CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)"
  },
  "generated_at": "2026-10-17T11:12:56Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ip-intelligence-lookup-x402-micro-pay-04cf2701/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-micro-pay.com](https://www.zero.xyz/host/x402-micro-pay.com/llms.txt)
