{"uid":"cap_bri-jjd-rHWm1Vy0D7-fq","slug":"tokenguard-geocoding-api-37525347","name":"Tokenguard Geocoding API","description":"Place name to coordinates, or coordinates to address (OpenStreetMap Nominatim), with country and feature type","url":"https://eltociear-tokenguard.hf.space/data/geocode","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude for reverse geocoding"},"lon":{"type":"number","description":"Longitude for reverse geocoding"},"query":{"type":"string","description":"Place name or address"}}},"responseSchema":{"type":"json","example":{"count":1,"query":"Shibuya, Tokyo","results":[{"lat":35.66,"lon":139.7,"country":"Japan","country_code":"jp","display_name":"Shibuya, Tokyo, Japan"}]}},"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_UJbuEcJ2i_2oeymqIBJJT","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":"Geocodes a place name or address query into geographic coordinates (latitude, longitude) with country metadata","exampleAgentPrompt":"Can you geocode 'Shibuya, Tokyo' and give me the latitude, longitude, and country code for that location?","exampleUseCases":[{"title":"Map crypto exchange locations globally","prompt":"I need to find the geographic coordinates and country codes for all our crypto exchange office locations across different cities. Can you geocode each office address I give you and compile a list with their lat/lon and country metadata?"},{"title":"Regional DeFi risk assessment by location","prompt":"We're analyzing DeFi protocol usage by geographic region. Can you geocode these city names for our analytics pipeline so we can map which countries our users are in and assess regional regulatory risks?"},{"title":"Cross-border blockchain compliance tracking","prompt":"Help me build a location database for our blockchain compliance team. I'll give you city and neighborhood names where we operate, and I need you to geocode each one to get precise coordinates and confirm the country code for regulatory purposes."}],"resultDescription":"Returns a JSON object with a count of results and an array of matches, each containing latitude, longitude, country name, ISO country code, and a human-readable display name for the matched location.","failureModes":["Query string not recognized as a valid place — returns empty results array with count 0","Ambiguous place name matches multiple locations — returns multiple result entries requiring disambiguation","Network or service unavailability on HuggingFace Space — returns 5xx error","Malformed POST body or missing query field — returns 4xx validation error","Payment not included or insufficient — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to resolve a human-readable place name or address into geographic coordinates (lat/lon) and country metadata, particularly within a workflow already using the Tokenguard API platform on Base with x402 micropayments. Suitable for enriching location data in crypto/DeFi analytics contexts where user-supplied location strings need to be geocoded.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:56.146Z","isFirstParty":false}