# Suverse US Address Geocoder (Census Bureau)

> Suverse US Address Geocoder (Census Bureau) is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-16).

Geocodes a US street address using the Census Bureau geocoder, returning matched address, coordinates, and census geography — no API key required.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-us-address-geocode
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-us-address-geocoder-census-bureau-a22adf37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n6xgGCknIQN70cQerzaCV

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 suverse-us-address-geocoder-census-bureau-a22adf37 -d '<json body>'
```

Example prompt: Can you geocode this US address for me — 1600 Pennsylvania Avenue NW, Washington, DC 20500 — and give me the latitude, longitude, and census tract?

## When to prefer this

Choose this endpoint when you need to geocode US addresses without managing an API key, especially when census geography (tract, block, FIPS codes) is required alongside coordinates. Ideal for compliance, demographic analysis, or address standardization workflows where Census Bureau authoritative data is preferred over commercial geocoders. Best for US-only address datasets where cost-per-call ($0.002 USDC) is acceptable and keyless access is a priority.

## Known failure modes

- Address not found or unmatched — Census geocoder returns no match for ambiguous or non-existent addresses
- Non-US addresses will not be geocoded — endpoint is strictly US-only
- Malformed or incomplete address strings may return no results
- Payment failure via x402 protocol if USDC balance is insufficient
- Upstream Census Bureau geocoder outage may cause errors or timeouts

## How this service works

Geocode a US street address via the Census Bureau geocoder, no key. Returns matched address, coordinates, and census geography. For AI agents standardizing and geocoding US addresses.

## Output

Returns the matched/standardized address string, latitude and longitude coordinates, and US Census geographic identifiers including state, county, census tract, and census block FIPS codes.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-us-address-geocoder-census-bureau-a22adf37/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)
