# StatePulse IP Lookup

> StatePulse IP Lookup is a paid API for AI agents from statepulse-api.hahavoid0.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Resolves an IP address to its geolocation, ASN, ISP, organization, timezone, and hosting status

## Facts

- Endpoint: POST https://statepulse-api.hahavoid0.workers.dev/network/ip-lookup
- 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/statepulse-ip-lookup-9ffdb74a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_waOcKbTbEFX3GjOFxsfXD

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 statepulse-ip-lookup-9ffdb74a -d '<json body>'
```

Example prompt: Look up the IP address 8.8.8.8 and tell me its location, ISP, ASN, and whether it's a hosting provider.

## When to prefer this

Use this endpoint when you need rich IP intelligence in a single call — combining geolocation (city, region, country, coordinates), network metadata (ASN, ISP, org), hosting detection, and timezone — without managing an API key, paying a monthly subscription, or standing up infrastructure. Ideal for AI agents that pay per use via x402 USDC on Base.

## Known failure modes

- Invalid or malformed IP address returns an error or unsupported result
- Private/reserved IP addresses (e.g. 192.168.x.x) may return no geolocation data
- Low-confidence results returned for IPs behind proxies or VPNs
- Service unavailable or timeout if Cloudflare Worker is overloaded
- Payment failure if insufficient USDC balance on Base

## How this service works

Scans an IPv4 or IPv6 address using public geodata to resolve location, country, ISP, autonomous system, and hosting flags. Matches: geolocate IP address, check client IP country, query ISP metadata, threat intelligence proxy check, hosting provider detector.

## Output

Returns a JSON object containing the IP's city, region, country, country code, latitude, longitude, ZIP code, ASN, ISP, organization, timezone, a boolean indicating if it is a hosting provider, a supported flag, and a confidence level (e.g. high).

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "ip": "8.8.8.8",
   "asn": "AS15169 Google LLC",
   "isp": "Google LLC",
   "lat": 37.422,
   "lng": -122.084,
   "org": "Google LLC",
   "zip": "94043",
   "city": "Mountain View",
   "region": "California",
   "country": "United States",
   "hosting": true,
   "timezone": "America/Los_Angeles",
   "country_code": "US"
  },
  "supported": true,
  "confidence": "high"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/statepulse-ip-lookup-9ffdb74a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from statepulse-api.hahavoid0.workers.dev](https://www.zero.xyz/host/statepulse-api.hahavoid0.workers.dev/llms.txt)