82trust / 100

Geocode

by Geocode address in Weather & location

x402 APIPassing, checked 45 min ago

Resolve a free-form address or place name to coordinates: lat/lon, display name, bounding box, place type. OpenStreetMap/Nominatim, no key.

GET https://agent402.tools/api/geocode

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
201 ms typical, 201 ms slowest 5%
Last check
45 min ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://agent402.tools/api/geocode?limit=1&q=1600+Pennsylvania+Ave+NW%2C+Washington%2C+DC"
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fagent402.tools%2Fapi%2Fgeocode
const res = await pay("https://agent402.tools/api/geocode?limit=1&q=1600+Pennsylvania+Ave+NW%2C+Washington%2C+DC");
console.log(await res.json());

Example input

{
  "limit": 1,
  "q": "1600 Pennsylvania Ave NW, Washington, DC"
}

Example output

{
  "count": 1,
  "query": "1600 Pennsylvania Ave NW, Washington, DC",
  "results": [
    {
      "boundingBox": {
        "east": -77.0362519,
        "north": 38.897829,
        "south": 38.8974908,
        "west": -77.0368537
      },
      "class": "tourism",
      "displayName": "White House, 1600, Pennsylvania Avenue Northwest, Washington, District of Columbia, 20500, United States",
      "importance": 0.78,
      "lat": 38.8976633,
      "lon": -77.0365739,
      "osm": "way/238241022",
      "type": "attraction"
    }
  ],
  "source": "nominatim.openstreetmap.org (ODbL)"
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
45 min agoPassed402189 ms$0.001
4 h agoPassed402202 ms$0.001
9 h agoPassed402201 ms$0.001