{"success":true,"data":{"id":"svc_geocode_18","slug":"geocode","name":"Geocoding","description":"Forward geocoding: address string → lat/lon. Reverse geocoding: lat/lon → human-readable address. Powered by OpenStreetMap Nominatim. Returns results array with display_name, lat, lon, type, and structured address object. Provide address (string) for forward, or lat + lon (numbers) for reverse.","category":"utility","endpoint":"https://agentsvc.io/api/v1/proxy/geocode","price_usdc":0.002,"latency_p99_ms":600,"input_schema":{"type":"object","description":"Provide either 'address' for forward geocoding, or both 'lat' + 'lon' for reverse geocoding.","oneOf":[{"required":["address"],"properties":{"address":{"type":"string","description":"Address string to geocode (e.g. 'Eiffel Tower, Paris', '1600 Pennsylvania Ave NW, Washington DC', 'Marienplatz 1, Munich')"},"limit":{"type":"integer","default":1,"description":"Max number of results to return (default: 1, max: 5)"}}},{"required":["lat","lon"],"properties":{"lat":{"type":"number","description":"Latitude for reverse geocoding (e.g. 48.8566)"},"lon":{"type":"number","description":"Longitude for reverse geocoding (e.g. 2.3522)"}}}]},"output_schema":{"type":"object","required":["mode","results"],"properties":{"mode":{"type":"string","enum":["forward","reverse"],"description":"'forward' if address was geocoded, 'reverse' if coordinates were looked up"},"results":{"type":"array","items":{"type":"object","properties":{"display_name":{"type":"string","description":"Full formatted address string"},"lat":{"type":"number","description":"Latitude"},"lon":{"type":"number","description":"Longitude"},"type":{"type":"string","description":"OSM place type (e.g. 'city', 'house', 'tourism', 'highway')"},"address":{"type":"object","description":"Structured address components","properties":{"house_number":{"type":"string"},"road":{"type":"string"},"neighbourhood":{"type":"string"},"suburb":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"postcode":{"type":"string"},"country":{"type":"string"},"country_code":{"type":"string","description":"ISO 3166-1 alpha-2 (e.g. 'de', 'us', 'fr')"}}},"osm_type":{"type":"string","description":"OSM element type: 'node', 'way', 'relation'"},"place_id":{"type":"integer","description":"OpenStreetMap place ID"}}}},"source":{"type":"string","description":"Always: 'OpenStreetMap Nominatim'"}},"example":{"mode":"forward","results":[{"display_name":"Eiffel Tower, 5, Avenue Anatole France, Quartier du Gros-Caillou, Paris, Île-de-France, France","lat":48.8583736,"lon":2.2922926,"type":"tourism","address":{"road":"Avenue Anatole France","city":"Paris","state":"Île-de-France","postcode":"75007","country":"France","country_code":"fr"},"osm_type":"way","place_id":158515771}],"source":"OpenStreetMap Nominatim"}},"is_active":true,"provider":"agentsvc.io","tags":["geocoding","geolocation","address","coordinates","lat","lon","maps","openstreetmap"],"method":"POST","example_input":{"address":"Brandenburger Tor, Berlin"},"price_atomic":"2000","price_display":"$0.002 USDC","try_url":"https://agentsvc.io/api/v1/try/geocode","try_limit_per_day":3,"info_url":"https://agentsvc.io/api/v1/services/geocode","page_url":"https://agentsvc.io/services/geocode","curl_example":"curl -X POST https://agentsvc.io/api/v1/proxy/geocode -H \"Content-Type: application/json\" -d '{\"address\":\"Brandenburger Tor, Berlin\"}'","status":{"ok":true,"latency_ms":184,"checked_at":"2026-10-05T09:35:12.270Z"}},"payment":{"protocol":"x402","x402_versions_accepted":[1,2],"scheme":"exact","network":"eip155:8453","network_v1":"base","chain_id":8453,"asset":"USDC","asset_contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","asset_decimals":6,"eip712_domain":{"name":"USD Coin","version":"2","chainId":8453,"verifyingContract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"pay_to":"0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27","facilitator":"https://facilitator.payai.network","request_header_v2":"PAYMENT-SIGNATURE","request_header_v1":"X-PAYMENT","requirements_v2":"base64 JSON in the PAYMENT-REQUIRED response header of the 402","requirements_v1":"JSON body of the 402 (accepts[0])","receipt_header":"PAYMENT-RESPONSE (and X-PAYMENT-RESPONSE): base64 JSON with transaction hash","accounts_required":false,"api_keys_required":false,"settlement":"per call, on-chain, after the service succeeded. Failed calls are never charged."},"links":{"catalog":"https://agentsvc.io/api/v1/services","openapi":"https://agentsvc.io/openapi.json","llms_txt":"https://agentsvc.io/llms.txt","llms_full_txt":"https://agentsvc.io/llms-full.txt","agents_md":"https://agentsvc.io/AGENTS.md","skill_md":"https://agentsvc.io/SKILL.md","status":"https://agentsvc.io/api/v1/status","docs":"https://agentsvc.io/docs","mcp_server":"https://agentsvc.io/mcp-server.mjs","discovery":"https://agentsvc.io/.well-known/x402","agent_card":"https://agentsvc.io/.well-known/agent-card.json"}}