{"uid":"cap_CRqdF75SldDViVVsfrE1F","slug":"geo402-ip-geolocation-64b4f9ec","name":"geo402 IP Geolocation","description":"Pay-per-call geolocation utility for AI agents: geocoding, reverse geocoding, timezone lookup, and great-circle distance. No API key, no subscription — agents pay per request via x402 (Base/USDC) or MPP (Tempo/pathUSD).","url":"https://geo402.alogos.xyz/v1/ip","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"ip":{"type":"string","description":"IPv4 or IPv6 address. Defaults to the caller's IP if omitted."}}},"responseSchema":{"type":"object","properties":{"ip":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"timezone":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"}},"additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gzDQRfMrYJd17vzWhlc57","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up geolocation data (country, city, coordinates, timezone) for a given IPv4 or IPv6 address, or the caller's own IP if none is provided.","exampleAgentPrompt":"What city and country is the IP address 203.0.113.42 located in, and what timezone is it in?","exampleUseCases":null,"resultDescription":"Returns geolocation data for the queried IP address, including country, city, region, latitude/longitude coordinates, and timezone. If no IP is provided, defaults to geolocating the caller's own IP address.","failureModes":["Invalid IP format returns an error response","Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no geolocation data or limited results","Payment failure via x402/MPP results in 402 Payment Required response before data is returned","IPv6 addresses may have lower geolocation accuracy than IPv4"],"whenToPreferThis":"Use this endpoint when you need pay-per-call IP geolocation with no API key or subscription required, especially in agent workflows where payment is handled via x402 (Base/USDC) or MPP (Tempo/pathUSD). Ideal for one-off lookups or agentic pipelines where per-request billing is preferable to a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:15.334Z","isFirstParty":false}