Delx US Geocode · Geocode US

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.delx.ai/api/v1/x402/geocode-us", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "address": "1600 Pennsylvania Ave NW, Washington, DC 20500"
  }),
});
const data = await res.json();

curl -X POST \
  "https://api.delx.ai/api/v1/x402/geocode-us" \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Pennsylvania Ave NW, Washington, DC 20500"}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "result": {
    "attribution": "This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.",
    "benchmark": "Public_AR_Current",
    "coverage": "US, Puerto Rico and U.S. Island Areas",
    "data_note": "Coordinates are based on Census address ranges and may be interpolated; this is not a precise rooftop or navigation service.",
    "match_count": 1,
    "matches": [
      {
        "address_components": {
          "city": "WASHINGTON",
          "state": "DC",
          "zip": "20500"
        },
        "coordinates": {
          "latitude": 38.8977,
          "longitude": -77.0365
        },
        "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500"
      }
    ],
    "privacy": "Delx does not retain the submitted address or include it in request logs.",
    "provider": "U.S. Census Bureau Geocoder",
    "provider_url": "https://www.census.gov/data/developers/data-sets/Geocoding-services.html",
    "schema": "delx/us-geocode/v1",
    "terms_url": "https://www.census.gov/data/developers/about/terms-of-service.html",
    "upstream_error": false
  },
  "tool_name": "geocode_us_address"
}