{"uid":"cap_bAFQeJsPuK_vXp3j0KbiL","slug":"worlddata402-ip-geolocation-lookup-6e07e9a0","name":"WorldData402 IP Geolocation Lookup","description":"Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).","url":"https://worlddata402.worlddata402.workers.dev/v1/ip/%7Bip%7D?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c7fbblpuJMY2gEOvBocHm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up geolocation and contextual data for a given IP address, paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"Can you look up where the IP address 203.0.113.45 is located — I need the country, city, and ISP information for it.","exampleUseCases":[{"title":"Visitor origin detection for analytics","prompt":"We got a connection from IP 198.51.100.22 — can you tell me what country and city that IP is coming from, and who the ISP is?"},{"title":"Fraud screening by IP geography","prompt":"I have a transaction from IP 192.0.2.100 that looks suspicious — can you geolocate it and tell me what country and region it resolves to so I can check if it matches the billing address?"},{"title":"Access control by country","prompt":"Can you check the geolocation of IP 203.0.113.77 for me? I need to know if it's coming from a country we should be blocking based on our compliance policy."}],"resultDescription":"Returns geolocation and network metadata for the queried IP address, including country, region, city, latitude/longitude, ISP/ASN, and possibly timezone and other reference data attributes.","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 no geolocation data","Payment failure or insufficient USDC balance blocks the request","Rate limits or quota exhaustion may return 429 errors","IPv6 addresses may have limited data coverage"],"whenToPreferThis":"Choose this endpoint when you need pay-per-call IP geolocation with no subscription commitment, billed in USDC micropayments via x402. Ideal for AI agents that need occasional IP lookups without managing API keys or monthly plans. Best suited for agents already operating in the x402/Base ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T04:46:39.459Z","isFirstParty":false,"canonicalSlug":"worlddata402-ip-geolocation-lookup-6e07e9a0"}