{"uid":"cap_88bF-Y8kXYVrz7vp302Co","slug":"x402-utilities-hub-ip-lookup-0b8bf36a","name":"x402 Utilities Hub – IP Lookup","description":"Pay-per-call utilities for AI agents and developers. Paid in USDC on Base via x402 v2.","url":"https://x402-utils-hub.dimkaplay666.workers.dev/v1/ip?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"properties":{"input":{"type":"object","required":["queryParams"],"properties":{"queryParams":{"type":"object"}}},"output":{"type":"object","properties":{"example":{"type":"object"}}}}},"responseSchema":{"type":"object","properties":{"example":{"type":"object"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a6CL00xivyJbQcKY0SDx1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns geolocation and metadata for the caller's or a specified IP address, charged per call in USDC on Base via x402.","exampleAgentPrompt":"Look up the geolocation and network details for IP address 8.8.8.8 — I need to know what country and city it's in.","exampleUseCases":[{"title":"Geolocate incoming user traffic","prompt":"What country and city is the IP address 203.0.113.42 coming from? I need to know if it's a domestic or foreign visitor."},{"title":"Identify ISP for suspicious login","prompt":"Can you look up who owns the IP 198.51.100.77? I want to see if it belongs to a VPN or residential ISP before I flag this login attempt."},{"title":"Timezone detection for scheduling","prompt":"Look up the timezone for IP address 192.0.2.15 so I can figure out what local time to schedule the notification for that user."}],"resultDescription":"Returns a JSON object containing geolocation metadata for the queried IP address, likely including country, region, city, ISP/ASN, timezone, and possibly coordinates. Exact fields depend on the underlying data source used by the worker.","failureModes":["Invalid or malformed IP address returns an error response","Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return null or limited data","Payment failure via x402 protocol returns HTTP 402 and blocks the lookup","Missing or malformed queryParams causes a 400-level error","Cloudflare Worker cold-start or service unavailability returns 503"],"whenToPreferThis":"Choose this endpoint when you need a pay-per-call IP geolocation lookup billed in USDC on Base with no subscription required. Ideal for AI agents that occasionally need IP metadata without committing to a monthly API plan, or when operating in a crypto-native payment context using the x402 protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:37:56.196Z","isFirstParty":false,"canonicalSlug":"x402-utilities-hub-ip-lookup-0b8bf36a"}