{"uid":"cap_1NTqTMBgaxVEOP179o1pr","slug":"x402-data-api-ip-geolocation-db5f5741","name":"x402 Data API – IP Geolocation","description":"IP geolocation: country, region, city, coordinates, and timezone for any IPv4 or IPv6 address. Fast in-memory lookup for analytics, fraud, and personalization agents.","url":"https://x402-data-api.onrender.com/api/geo","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"ip":{"type":"string","description":"IPv4 or IPv6 address to locate. Omit to geolocate the caller."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ip":{"type":"string"},"ll":{"type":"array"},"city":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"timezone":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Fda5wr-J63Dtq23lGfSt1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves an IPv4 or IPv6 address to its country, region, city, coordinates, and timezone via fast in-memory lookup.","exampleAgentPrompt":"What country, city, and timezone is the IP address 203.0.113.42 located in?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the queried IP address, city name, region, country code, latitude/longitude pair (ll array), and timezone string — all derived from fast in-memory geolocation data.","failureModes":["Invalid or malformed IP address returns an error or empty result","Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no meaningful geolocation","Payment failure (402) if USDC balance is insufficient or x402 auth is missing","Service cold-start latency on Render free tier may cause occasional timeouts","IPv6 addresses may have lower geolocation accuracy than IPv4"],"whenToPreferThis":"Choose this endpoint when you need lightweight, low-latency IP-to-location resolution for a single address, especially in analytics pipelines, fraud scoring, or personalization flows where country, region, city, and timezone are sufficient. Prefer it over heavyweight geolocation databases when you want a pay-per-call model at $0.001 USDC with no subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-07-16T22:44:12.013Z","lastSuccessfullyRanAt":"2026-07-16T22:44:12.013Z","lastHealthCheckAt":"2026-09-14T18:38:32.772Z","isFirstParty":false}