{"success":true,"data":{"id":"svc_geocode_18","slug":"geocode","name":"Geocoding","description":"Geocoding and reverse geocoding from GeoNames: city, town or postal code to lat/lon, and lat/lon to the nearest place and postal code. Covers 170,000 places with 1000+ inhabitants and 1.8 million postal codes worldwide, answered from our own database in milliseconds. Not street level: house numbers and streets are skipped and reported in ignored_parts. Provide address (e.g. 'Paris, Texas', '10115 Berlin') or lat + lon.","category":"utility","endpoint":"https://agentsvc.io/api/v1/proxy/geocode","price_usdc":0.003,"latency_p99_ms":300,"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":"Place to geocode: city, 'city, region', 'city, country' or postal code (e.g. 'Zurich', 'Springfield, Illinois', '10115, Germany', 'SW1A')"},"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)"},"limit":{"type":"integer","default":1,"description":"Number of nearest places (default: 1, max: 5)"}}}]},"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":"Postal code (if matched), place, region, country"},"lat":{"type":"number","description":"Latitude"},"lon":{"type":"number","description":"Longitude"},"type":{"type":"string","enum":["city","postcode"],"description":"What the coordinates refer to"},"precision":{"type":"string","enum":["locality","postal_code"]},"address":{"type":"object","description":"Structured components","properties":{"city":{"type":"string"},"state":{"type":"string"},"postcode":{"type":["string","null"]},"country":{"type":"string"},"country_code":{"type":"string","description":"ISO 3166-1 alpha-2, lowercase (e.g. 'de', 'us')"}}},"population":{"type":["integer","null"]},"timezone":{"type":["string","null"],"description":"IANA timezone of the place"},"geonames_id":{"type":["integer","null"]},"distance_km":{"type":"number","description":"Reverse mode: distance from the given coordinates"}}}},"ignored_parts":{"type":"array","items":{"type":"string"},"description":"Parts of the address that are not places (e.g. street and house number)"},"source":{"type":"string","description":"Always: 'GeoNames'"},"attribution":{"type":"string"}},"example":{"mode":"forward","results":[{"display_name":"Paris, Île-de-France, France","lat":48.85341,"lon":2.3488,"type":"city","precision":"locality","address":{"city":"Paris","state":"Île-de-France","postcode":null,"country":"France","country_code":"fr"},"population":2138551,"timezone":"Europe/Paris","geonames_id":2988507}],"ignored_parts":["Avenue Anatole France 5"],"source":"GeoNames","attribution":"Place data from GeoNames (geonames.org), CC BY 4.0"}},"is_active":true,"provider":"agentsvc.io","tags":["geocoding","geolocation","postal-code","coordinates","lat","lon","places","geonames"],"method":"POST","example_input":{"address":"Brandenburger Tor, Berlin"},"price_atomic":"3000","price_display":"$0.003 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":21,"checked_at":"2026-11-21T04:01:52.515Z"}},"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://api.cdp.coinbase.com/platform/v2/x402","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.","also_accepted":[{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","network_v1":"solana","asset":"USDC","asset_mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","pay_to":"5JzPS5qpEwUM1vTC9GG7uqvwJdHzbEwfoPHf2Ki977tg","note":"Solana option is accepts[1] in the 402. The facilitator pays the transaction fee (extra.feePayer); the payer needs only USDC, no SOL."}]},"links":{"catalog":"https://agentsvc.io/api/v1/services","payment_requirements":"https://agentsvc.io/api/v1/payment-requirements","credits":"https://agentsvc.io/api/v1/credits","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"}}