{"uid":"cap_jfNQUxrv2hpU1DWy_97Tv","slug":"x402-deployer-x402-deployer-workers-dev-6c881702","name":"x402-deployer Address Geocoder (OSM Nominatim)","description":"Geocoder / forward geocoder / address to lat-lng / address-to-coordinates / postal-code lookup / place-name resolver / Nominatim geocoder / OpenStreetMap geocoding API. Converts a free-form address, postal code, place name, or POI into latitude/longitude plus a structured address breakdown (house number, road, city, county, state, postcode, country) and bounding box. Returns a ranked list of matches with importance scores. Backed by OSM Nominatim — global coverage, attribution required by ODbL.","url":"https://x402-deployer.x402-deployer.workers.dev/address-geocode","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"input":{"body":{"limit":5,"address":"1600 Pennsylvania Avenue NW, Washington DC 20500"},"type":"http","method":"POST","bodyType":"json"}},"response":{"query":"1600 Pennsylvania Avenue NW, Washington DC 20500","source":"OpenStreetMap Nominatim (free public API)","results":[{"type":"government","class":null,"osm_id":19761182,"address":{"city":"Washington","road":"Pennsylvania Avenue Northwest","state":"District of Columbia","county":null,"country":"United States","postcode":"20500","country_code":"US","house_number":"1600","neighbourhood":"Downtown"},"latitude":38.8976387,"place_id":349001929,"longitude":-77.0365528,"importance":0.6958339719610435,"bounding_box":[38.8974904,38.8977959,-77.0368541,-77.0362517],"display_name":"White House, 1600, Pennsylvania Avenue Northwest, Downtown, Ward 2, Washington, District of Columbia, 20500, United States"}],"best_match":{"type":"government","class":null,"osm_id":19761182,"address":{"city":"Washington","road":"Pennsylvania Avenue Northwest","state":"District of Columbia","county":null,"country":"United States","postcode":"20500","country_code":"US","house_number":"1600","neighbourhood":"Downtown"},"latitude":38.8976387,"place_id":349001929,"longitude":-77.0365528,"importance":0.6958339719610435,"bounding_box":[38.8974904,38.8977959,-77.0368541,-77.0362517],"display_name":"White House, 1600, Pennsylvania Avenue Northwest, Downtown, Ward 2, Washington, District of Columbia, 20500, United States"},"match_count":1}},"exampleRequest":{"limit":5,"address":"1600 Pennsylvania Avenue NW, Washington DC 20500"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_C9hezJjPvzFipSQvRIBsi","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":"Converts a free-form address, postal code, place name, or POI into latitude/longitude coordinates plus a structured address breakdown and bounding box, backed by OpenStreetMap Nominatim.","exampleAgentPrompt":"What are the latitude and longitude coordinates for 1600 Pennsylvania Avenue NW, Washington DC 20500? I also need the bounding box and a structured address breakdown.","exampleUseCases":null,"resultDescription":"A ranked list of geocoding matches, each containing latitude and longitude, a structured address object (house number, road, city, county, state, postcode, country), a bounding box, and an importance/relevance score. Global coverage via OSM Nominatim.","failureModes":["Address not found in OSM — returns empty results array","Ambiguous place name returns multiple low-confidence matches with similar importance scores","Non-standard or misspelled address reduces match quality","Rate limits or upstream Nominatim outages return 5xx errors","Missing or malformed input address returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to convert a free-form address, postal code, or place name into geographic coordinates (lat/lng) with a structured address breakdown. Prefer it over reverse geocoders when you have text input and need coordinates as output. Best for global coverage leveraging OSM data. Note ODbL attribution is required for displayed results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:48:05.753Z","isFirstParty":false}