# Address to Coordinates (US)

> Address to Coordinates (US) is a paid API for AI agents from data.tollkit.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Geocodes a US street address to latitude/longitude coordinates and returns detailed location metadata via the U.S. Census Bureau Geocoder

## Facts

- Endpoint: POST https://data.tollkit.dev/geocode?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/address-to-coordinates-us-8ae8d292
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B__jq39O3drdLgi8I_ZSM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability address-to-coordinates-us-8ae8d292 -d '<json body>'
```

Example prompt: Can you geocode 1600 Pennsylvania Ave NW, Washington, DC 20500 and get me the latitude, longitude, ZIP code, and county?

## When to prefer this

Choose this endpoint when you need free, authoritative US address geocoding backed by Census Bureau data, especially when you also need census tract, county FIPS, or normalized address output. Prefer it over commercial geocoders when cost matters ($0.002/call) and US-only coverage is sufficient. Ideal for enriching address data with official government geographic identifiers.

## Known failure modes

- No match found if address is outside the US or not in Census Bureau data
- Partial or ambiguous address may return multiple candidates or zero matches
- Non-US addresses will fail since the endpoint only covers US geography
- Malformed input without a house number may return no results
- Rural or very new addresses may not be in the Census benchmark data

## How this service works

SEC filings and financials, IP lookup, US weather, airport delays, address geocoding and exchange rates. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://chain.tollkit.dev/openapi.json.

## Output

Returns a JSON object with the best-matched address including latitude, longitude, ZIP code, city, state, county name, county FIPS code, census tract, and the normalized matched address string. Also includes the full list of all matched candidates and the original input string. Backed by the U.S. Census Bureau Geocoder.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 200,
   "description": "US street address with a house number."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "best": {
   "lat": 38.898703,
   "lon": -77.035189,
   "zip": "20500",
   "city": "WASHINGTON",
   "state": "DC",
   "county": "District of Columbia",
   "street": "PENNSYLVANIA AVE NW",
   "state_name": "District of Columbia",
   "county_fips": "11001",
   "census_tract": "11001980000",
   "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500"
  },
  "input": "1600 Pennsylvania Ave NW, Washington, DC 20500",
  "notice": "This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.",
  "source": "U.S. Census Bureau Geocoder (geocoding.geo.census.gov), Public_AR_Current benchmark",
  "matches": [
   {
    "lat": 38.898703,
    "lon": -77.035189,
    "zip": "20500",
    "city": "WASHINGTON",
    "state": "DC",
    "county": "District of Columbia",
    "street": "PENNSYLVANIA AVE NW",
    "state_name": "District of Columbia",
    "county_fips": "11001",
    "census_tract": "11001980000",
    "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500"
   }
  ],
  "match_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/address-to-coordinates-us-8ae8d292/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.tollkit.dev](https://www.zero.xyz/host/data.tollkit.dev/llms.txt)