ToolVet
78trust / 100

Us Geocode

by Eckari in Weather & location

x402 APIPassing, checked 2 h ago

Convert a one-line US street address into coordinates using the US Census Bureau Geocoder. Returns the standardised matched address, latitude and longitude to 6 decimal places, the TIGER/Line segment and parsed address components. Coordinates are interpolated along street address ranges, not rooftop or parcel positions. No match is a normal answer, not an error. Use when: Convert this US street address to latitude and longitude.

GET https://api.eckari.com/v1/locations/us/geocode

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
605 ms typical, 753 ms slowest 5%
Last check
2 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://api.eckari.com/v1/locations/us/geocode?address=1600+Pennsylvania+Ave+NW%2C+Washington%2C+DC+20500&limit=1"
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%2Fapi.eckari.com%2Fv1%2Flocations%2Fus%2Fgeocode
const res = await pay("https://api.eckari.com/v1/locations/us/geocode?address=1600+Pennsylvania+Ave+NW%2C+Washington%2C+DC+20500&limit=1");
console.log(await res.json());

Example input

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

Example output

{
  "data": {
    "benchmark": "Public_AR_Current",
    "items": [
      {
        "address_components": {
          "city": "WASHINGTON",
          "from_address": "1600",
          "pre_direction": null,
          "pre_type": null,
          "state": "DC",
          "street_name": "PENNSYLVANIA",
          "suffix_direction": "NW",
          "suffix_type": "AVE",
          "to_address": "1648",
          "zip": "20500"
        },
        "lat": 38.898699,
        "lon": -77.035188,
        "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
        "precision": "tiger_interpolated",
        "side": "L",
        "tiger_line_id": "76225813"
      }
    ],
    "page": {
      "has_more": false,
      "limit": 1,
      "next_offset": null,
      "offset": 0,
      "returned": 1,
      "total": 1
    },
    "query": {
      "address": "1600 Pennsylvania Ave NW, Washington, DC 20500"
    }
  },
  "meta": {
    "capability": "location.us.geocode",
    "freshness": "live",
    "source": "census_geocoder",
    "version": "3.0.0"
  }
}

Security scan

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

Recent checks

WhenResultHTTPTimePrice
2 h agoPassed402397 ms$0.003
5 h agoPassed402576 ms$0.003
9 h agoPassed402724 ms$0.003
12 h agoPassed402802 ms$0.003
16 h agoPassed402539 ms$0.003
20 h agoPassed402670 ms$0.003
23 h agoPassed402753 ms$0.003
28 h agoPassed402569 ms$0.003
31 h agoPassed402605 ms$0.003
34 h agoPassed402469 ms$0.003
39 h agoPassed402690 ms$0.003