# US Address Geocoder

> US Address Geocoder is a paid API for AI agents from geo-us.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Geocodes a US street address to normalized address, latitude/longitude, state/county/tract FIPS codes, and match quality metadata.

## Facts

- Endpoint: GET https://geo-us.x402tookit.com/geocode-address?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-address-geocoder-a85f62b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xTBoVwDe40qqh26iGvol5

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 us-address-geocoder-a85f62b2
```

Example prompt: Can you geocode 1600 Pennsylvania Avenue NW, Washington, DC 20500 and give me the latitude, longitude, and census tract FIPS code?

## When to prefer this

Choose this endpoint when you need authoritative US address geocoding combined with census geography identifiers (state FIPS, county FIPS, tract GEOID) in a single call. It is ideal for compliance, demographic enrichment, or mapping workflows where census tract context matters alongside coordinates. Prefer it over generic geocoding APIs when you specifically need US Census-aligned geographic codes or normalized address components with match quality signals.

## Known failure modes

- Address not found or unrecognizable — returns null coordinates and a non-match verdict
- Ambiguous address with multiple matches — returns the top match with a degraded flag and match count > 1
- Missing city/state or ZIP — query may fail validation or return low-confidence results
- Non-US address supplied — out of scope, likely returns null or error
- Misspelled street name — may still match with degraded quality or fail entirely

## How this service works

Geocode a US street address: normalized address, latitude and longitude, state, county and tract codes, with match quality.

## Output

Returns a normalized matched address, latitude and longitude, state FIPS code, county FIPS code, census tract GEOID, parsed address components (street number, street, city, state, ZIP), match verdict and quality indicators (number of matches, degraded flag, reasons), data source URL, and a summary string. Null values are returned for fields that could not be resolved.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "US street address with city and state or ZIP"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "place": {
       "type": [
        "null",
        "string"
       ]
      },
      "county": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "matches": {
       "type": [
        "null",
        "number"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "latitude": {
       "type": [
        "null",
        "number"
       ]
      },
      "longitude": {
       "type": [
        "null",
        "number"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "stateFips": {
       "type": [
        "null",
        "string"
       ]
      },
      "components": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "zip": {
         "type": [
          "null",
          "string"
         ]
        },
        "city": {
         "type": [
          "null",
          "string"
         ]
        },
        "state": {
         "type": [
          "null",
          "string"
         ]
        },
        "number": {
         "type": [
          "null",
          "str
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-address-geocoder-a85f62b2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from geo-us.x402tookit.com](https://www.zero.xyz/host/geo-us.x402tookit.com/llms.txt)