{"uid":"cap_8s_7DxY5NQOhy0_KGva-Y","slug":"onchainexpat-x402-geocoding-api-e41c6ec2","name":"OnchainExpat x402 Geocoding API","description":"Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol","url":"https://x402.onchainexpat.com/api/x402-tools/geocode","method":"POST","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"limit":{"type":"integer","description":"Max results (default 5, max 10)"},"address":{"type":"string","description":"Address or place name to geocode. Alias: 'query'. E.g. 'Eiffel Tower, Paris'"}}},"responseSchema":{"type":"object","properties":{"count":{"type":"integer"},"query":{"type":"string"},"cached":{"type":"boolean"},"results":{"type":"array"}}},"example":{"request":{"address":"Eiffel Tower, Paris"},"response":{"count":1,"query":"Eiffel Tower, Paris","cached":false,"results":[{"type":"tower","address":{"city":"Paris","road":"Avenue Anatole France","state":"Île-de-France","region":"France métropolitaine","suburb":"Paris 7e Arrondissement","country":"France","quarter":"Quartier du Gros-Caillou","man_made":"Tour Eiffel","postcode":"75007","country_code":"fr","house_number":"5","city_district":"Paris","ISO3166-2-lvl4":"FR-IDF","ISO3166-2-lvl6":"FR-75C"},"latitude":48.8582599,"longitude":2.2945006,"importance":0.6205937724353116,"display_name":"Tour Eiffel, 5, Avenue Anatole France, Quartier du Gros-Caillou, Paris 7e Arrondissement, Paris, Île-de-France, France métropolitaine, 75007, France"}]}},"exampleRequest":{"address":"Eiffel Tower, Paris"},"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tzTQCKVQaMaatdTqpLr3K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a human-readable address or place name into geographic coordinates (latitude/longitude) via a pay-per-request x402 micropayment model","exampleAgentPrompt":"Can you geocode '1600 Amphitheatre Parkway, Mountain View, CA' and give me the latitude and longitude?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the geographic coordinates (latitude and longitude) and possibly a formatted/normalized address for the input location string. Response schema is JSON but example payload is minimal.","failureModes":["Invalid or unrecognizable address returns an error or empty result","Payment not included or insufficient USDC triggers x402 payment-required response","Network timeout if upstream geocoding provider is slow","Ambiguous place name may return incorrect or unexpected coordinates","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need pay-per-use geocoding without a subscription, especially in agentic or automated workflows that use the x402 micropayment protocol for on-demand billing at $0.01 USDC per call. Prefer over subscription-based geocoding APIs when request volume is unpredictable or low.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:04:31.765Z","isFirstParty":false}