{"uid":"cap_gShXwoj0wl-O0iDPygt5O","slug":"bolt-geo-ip-lookup-1dc0125e","name":"Bolt Geo IP Lookup","description":"Utility toolkit for AI agents. 54 endpoints — tools, data, and AI processing. Pay per request in USDC via x402.","url":"https://bolt.orbonomy.xyz/api/geo","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ip":{"type":"string"}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object"},"success":{"type":"boolean"}}},"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_tZNn0IX76zXbOK2dCFKsx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up geolocation data for a given IP address, returning geographic and network information.","exampleAgentPrompt":"Can you look up the geolocation for the IP address 203.0.113.42 and tell me what country, city, and ISP it belongs to?","exampleUseCases":[{"title":"Fraud detection by IP location","prompt":"I've got a list of IP addresses from suspicious login attempts on our platform — can you geolocate each one and tell me what countries and ISPs they're coming from so I can flag any that look fraudulent?"},{"title":"Personalize content by visitor region","prompt":"When a new visitor hits our site, can you look up their IP address and figure out their country, city, and timezone so we can automatically show them localized content and the right business hours?"},{"title":"Enrich server logs with geography","prompt":"I have a batch of IP addresses pulled from our server logs — can you run geolocation on each one and give me the country, region, and ISP for every entry so I can build a map of where our traffic is coming from?"}],"resultDescription":"Returns a data object containing geographic details for the provided IP address, such as country, city, region, latitude/longitude, ISP, and timezone, along with a success boolean indicating whether the lookup succeeded.","failureModes":["Invalid or malformed IP address returns an error or empty data","Private/reserved IP ranges (e.g. 192.168.x.x, 127.0.0.1) may return no geolocation data","Payment failure (insufficient USDC balance) results in 402 response","Service unavailable or timeout results in a 5xx error","Missing IP field in request body may return a validation error"],"whenToPreferThis":"Choose this endpoint when you need lightweight, pay-per-use IP geolocation as part of an agentic workflow and want to pay in USDC via x402 without a subscription. Ideal for ad-hoc IP enrichment tasks in automated pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:13.609Z","isFirstParty":false}