{"openapi":"3.1.0","info":{"title":"IP Lookup","version":"1.0.0","description":"Geolocation, ASN, proxy and threat intelligence for any IP address.","x-guidance":"Pay-per-call IP intelligence. POST /v1/ip with {\"ip\": \"8.8.8.8\"} to resolve geolocation, ISP, ASN, timezone and proxy/VPN status for an address — useful for fraud screening, geo-routing and abuse detection. Every call is priced in USDC and settled over x402 on Base or Solana; no API key or account is needed. Requests may also be sent as GET with query parameters. A failed lookup returns a 4xx or 5xx and is never charged.","contact":{"email":"support@ipx402.com"}},"servers":[{"url":"https://ipx402.com"}],"paths":{"/v1/ip":{"post":{"operationId":"lookupIp","summary":"IP lookup - resolve geolocation, ASN, ISP and proxy status for an IP address","tags":["IP"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string","minLength":3,"description":"IPv4 or IPv6 address to look up, e.g. \"8.8.8.8\"."}},"required":["ip"]}}}},"responses":{"200":{"description":"Successful lookup","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the lookup succeeded."},"code":{"type":"integer","description":"Upstream status code."},"IP":{"type":"object","description":"Geolocation, network and threat metadata for the address.","properties":{"IP":{"type":"string"},"ip_version":{"type":"integer"},"valid":{"type":"boolean"},"alpha2":{"type":"string","description":"ISO country code."},"country":{"type":"string"},"region":{"type":"string"},"city":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"},"zip_code":{"type":"string"},"time_zone":{"type":"string"},"is_proxy":{"type":"boolean","description":"True when the address is a known proxy or VPN."},"isp":{"type":"string"},"asn":{"type":"string"},"proxy":{"type":"object","description":"Present when the address is a known proxy.","properties":{"type":{"type":"string"},"isp":{"type":"string"},"domain":{"type":"string"},"country_name":{"type":"string"},"city_name":{"type":"string"}}}},"required":["IP","valid"]}},"required":["success","IP"]}}}},"400":{"description":"Invalid or missing parameters. Not charged."},"402":{"description":"Payment Required"},"502":{"description":"Upstream provider failed. Not charged."}}}}}}