{"uid":"cap_hlfUhc3_6AvLry8ztKyCL","slug":"openweather-geocoding-via-locus-x402-b5927d02","name":"OpenWeather Geocoding via Locus x402","description":"Global weather data — current conditions, 5-day forecasts, hourly forecasts, air quality index with pollutants, geocoding, and One Call 3.0 with full weather suite and government alerts.","url":"https://openweather.x402.paywithlocus.com/openweather/geocode","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string"},"limit":{"type":"number"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"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_tdIZCNz1ZiwFLFU3u7u8u","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":"Converts city names (optionally with state/country codes) into geographic coordinates and location metadata using OpenWeather's geocoding API, billed per-call via x402 micropayment.","exampleAgentPrompt":"Can you find the geographic coordinates for Austin, Texas — I need the lat/lon to pass into a weather lookup?","exampleUseCases":[{"title":"Coordinate lookup before weather fetch","prompt":"What are the latitude and longitude for London, UK? I need the coordinates so I can pull a weather forecast for it."},{"title":"Disambiguating cities with same name","prompt":"I need the coordinates for Springfield — can you look it up for the US and give me up to 3 results so I can pick the right one?"},{"title":"International city geocoding","prompt":"Can you geocode Paris, France and give me back the exact coordinates and any other location details?"}],"resultDescription":"Returns a JSON object containing an array of matching location results (up to the specified limit), each including city name, country, state, latitude, and longitude. Also includes x402 payment settlement details (USDC amount settled and authorized) and a request tracking ID with status URL.","failureModes":["Unrecognized city name returns empty results array","Missing or malformed country/state code may return ambiguous matches","Exceeding limit parameter bounds (outside 1–5) may cause validation error","Payment failure via x402 protocol prevents request from being processed","Network timeout to upstream OpenWeatherMap API"],"whenToPreferThis":"Use this endpoint when you need to resolve a human-readable city name into geographic coordinates before making downstream weather or geospatial API calls, especially when already using the OpenWeather via Locus x402 suite for weather data. Prefer this over generic geocoding services when you want a single x402-billed, micropayment-friendly pipeline that stays within the same provider ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:01.088Z","isFirstParty":false}