# IPPulse — IP Intelligence for AI Agents
> https://ippulse.waltsoft.net

## What is IPPulse?
IP reputation, geolocation, and ASN lookup service designed for AI agents.
Returns geo (country, city, lat/lon, timezone), ASN, org, ISP, hostname,
plus extended reputation data (proxy/VPN/Tor detection, abuse score, open ports).

## Authentication
- x402 payment protocol (Base + Solana USDC) — preferred for AI agents
- API keys (Bearer ip_live_*) — for CI/CD and enterprise
- Free tier: 5 lookups/day from landing page

## Pricing
- /v1/lookup/{ip}: $0.005 per query
- /v1/bulk (POST): $0.02 per batch (up to 50 IPs)
- /v1/reputation/{ip}: $0.01 per query

## Endpoints
GET  /v1/lookup/{ip}      — Geolocation + ASN + ISP + hostname
POST /v1/bulk             — Batch lookup (max 50 IPs, body: {"ips": ["1.1.1.1", ...]})
GET  /v1/reputation/{ip}  — Extended: proxy/VPN/Tor, abuse score, open ports
GET  /health              — Service status
GET  /.well-known/x402    — Payment discovery
GET  /.well-known/agent.json — Agent capability descriptor

## Example
GET /v1/lookup/8.8.8.8 → {"ip":"8.8.8.8","geo":{"country":"United States","city":"Ashburn",...},"asn":{"number":"AS15169","org":"Google LLC",...}}