{"uid":"cap_vsgH3sQ3BB0P9nZytb-xL","slug":"api-x402node-dev-5b1d3006","name":"Forward Geocode Address to Coordinates (OpenStreetMap Nominatim)","description":"Forward geocode an address to lat/lng using OpenStreetMap Nominatim. Returns coordinates, address components, bounding box, place type. Use ?q=1600+Pennsylvania+Ave+Washington+DC plus optional and limit=5. Built for AI agents handling delivery, logistics, and map UIs. Accepts payment on Base or Solana — either network works.","url":"https://api.x402node.dev/maps/forward","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Search query (required)"},"limit":{"type":"string","description":"Max results (optional)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M8J1FMALjSigoK-8tsoE2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a free-text address string into latitude/longitude coordinates, address components, bounding box, and place type using OpenStreetMap Nominatim.","exampleAgentPrompt":"What are the latitude and longitude coordinates for 1600 Pennsylvania Ave, Washington DC? Give me up to 3 results.","exampleUseCases":[{"title":"Delivery address coordinate lookup","prompt":"I need to send a package to 221B Baker Street, London. Can you get the latitude and longitude for that address so I can plug it into our routing system?"},{"title":"Store locator map pinning","prompt":"We have a new store opening at 1 Infinite Loop, Cupertino, CA. Can you find the coordinates and bounding box for that address so we can pin it on our store locator map?"},{"title":"Logistics routing for multiple stops","prompt":"I have three warehouse addresses I need to route deliveries through: 500 W Madison St Chicago IL, 350 5th Ave New York NY, and 1 Market St San Francisco CA. Can you get the lat/lng for each of them?"}],"resultDescription":"Returns one or more geocoding results, each containing latitude and longitude coordinates, structured address components (street, city, country, etc.), a bounding box for the location, and a place type classification (e.g. building, city, road).","failureModes":["Address not found or too ambiguous — returns empty results array","Invalid or malformed query string — returns error response","Rate limiting or payment failure — returns 402 Payment Required","Nominatim upstream unavailable — returns 5xx error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to resolve a human-readable address or place name into geographic coordinates for use in delivery routing, map rendering, logistics planning, or any geospatial computation. Prefer this over reverse geocoding endpoints when you have an address and need coordinates (not the other way around). This is well-suited for agent workflows involving delivery addresses, store locators, or any scenario requiring lat/lng from user-supplied location text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:07:28.907Z","isFirstParty":false}