{"uid":"cap_KLZ0r65mQhagVAAOWzB6F","slug":"hars-zero-signal-api-geocode-dabcb70a","name":"HARS-Zero Signal API — Geocode","description":"Utility API for AI agents — fetch URLs, extract structured HTML,\nsummarize text, get live FX rates, and geocode addresses. Pay per call\nin USDC on Base or Solana via x402. No API keys, no subscriptions.\nSub-cent pricing optimized for high-volume agent loops.","url":"https://hars.cryptotavern.xyz/paid/geocode","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["as_of","query","count","results"],"properties":{"as_of":{"type":"string","format":"date-time","description":"RFC3339 timestamp"},"count":{"type":"integer"},"query":{"type":"string"},"risks":{"type":"array","items":{"type":"string"}},"product":{"type":"string"},"results":{"type":"array","items":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"type":{"type":"string"},"importance":{"type":"number"},"bounding_box":{"type":"array"},"display_name":{"type":"string"}}}},"evidence":{"type":"array","items":{"type":"string","format":"uri"},"description":"Polymarket order book / event / reference URLs"},"confidence":{"type":"number","maximum":1,"minimum":0,"description":"Model confidence 0.0-1.0"},"market_ids":{"type":"array","items":{"type":"string"},"description":"Polymarket slugs or ids referenced in this response"},"next_best_action":{"type":"object","properties":{"why":{"type":"string"},"endpoint":{"type":"string"},"price_usd":{"type":"number"},"product_id":{"type":"string"}}}},"description":"Free-text address -> lat/lng via OSM Nominatim."},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["as_of","query","count","results"],"properties":{"as_of":{"type":"string","format":"date-time","description":"RFC3339 timestamp"},"count":{"type":"integer"},"query":{"type":"string"},"risks":{"type":"array","items":{"type":"string"}},"product":{"type":"string"},"results":{"type":"array","items":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"type":{"type":"string"},"importance":{"type":"number"},"bounding_box":{"type":"array"},"display_name":{"type":"string"}}}},"evidence":{"type":"array","items":{"type":"string","format":"uri"},"description":"Polymarket order book / event / reference URLs"},"confidence":{"type":"number","maximum":1,"minimum":0,"description":"Model confidence 0.0-1.0"},"market_ids":{"type":"array","items":{"type":"string"},"description":"Polymarket slugs or ids referenced in this response"},"next_best_action":{"type":"object","properties":{"why":{"type":"string"},"endpoint":{"type":"string"},"price_usd":{"type":"number"},"product_id":{"type":"string"}}}},"description":"Free-text address -> lat/lng via OSM Nominatim."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_afOtpQLIdq2RSzmXn_NsT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Convert a free-text address or place name into latitude/longitude coordinates using OSM Nominatim, paying per call in USDC via x402.","exampleAgentPrompt":"Can you geocode '1600 Pennsylvania Avenue NW, Washington, DC' and give me the latitude and longitude?","exampleUseCases":[{"title":"Geocode a delivery address","prompt":"I need the coordinates for '221B Baker Street, London, UK' so I can plot it on a map — can you look up the lat and lon for me?"},{"title":"Resolve a city name to coordinates","prompt":"What are the latitude and longitude of Tokyo, Japan? I need the coordinates for a mapping calculation."},{"title":"Batch address enrichment for logistics","prompt":"I have this warehouse address — '500 West Madison Street, Chicago, IL 60661' — can you geocode it and give me back the lat, lon, and full display name?"}],"resultDescription":"Returns a JSON object with a timestamp, the original query string, a count of results, and an array of result objects each containing lat, lon, display_name, type, importance score, and bounding_box coordinates.","failureModes":["Address not found — results array is empty with count 0","Ambiguous query returns multiple low-confidence results with varying importance scores","OSM Nominatim rate limit or downtime causes upstream failure","Malformed query string yields no parseable location","Payment not processed via x402 — request rejected before geocode is attempted"],"whenToPreferThis":"Choose this endpoint when you need pay-per-call geocoding with no API key or subscription, especially in high-volume agent loops where sub-cent USDC micropayments on Base or Solana are acceptable. It is well-suited for agents that only occasionally need geocoding and want to avoid managing API credentials. Use it when OSM Nominatim coverage is sufficient (global coverage, strong for cities and well-known addresses).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:30.997Z","isFirstParty":false}