# Delx Commerce — US Address Geocoder

> Delx Commerce — US Address Geocoder is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Converts a U.S. street address into geographic coordinates (latitude/longitude) using the U.S. Census Bureau Geocoder, via a pay-per-call API requiring no signup.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/geocode-us?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-us-address-geocoder-42976fe0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qU6DXIMjcxz8lQvHJUjuC

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 delx-commerce-us-address-geocoder-42976fe0 -d '<json body>'
```

Example prompt: What are the latitude and longitude coordinates for 1600 Pennsylvania Ave NW, Washington, DC 20500?

## When to prefer this

Choose this endpoint when you need a free, no-signup, pay-per-result geocoder for U.S., Puerto Rico, or U.S. Island Areas addresses and want verifiable, Census-backed coordinates billed in USDC micro-payments. It is ideal for agent workflows that need lightweight address-to-coordinate resolution without API key management, especially when Census interpolated accuracy (not rooftop precision) is sufficient. Prefer alternatives when you need global address coverage, rooftop-precise coordinates, or reverse geocoding.

## Known failure modes

- Address not found — match_count is 0 and matches array is empty
- Upstream Census Bureau API error — upstream_error: true with no matches
- Invalid or non-US address input — may return zero matches or error
- Timeout exceeded if Census geocoder is slow — configurable between 2–8 seconds
- Malformed input (address too short or too long) — schema validation error

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

Returns a JSON object containing an array of address matches, each with latitude/longitude coordinates, a standardized matched address string, and address components (city, state, ZIP). Also includes metadata: provider attribution, benchmark used, coverage note, privacy statement, and whether an upstream error occurred. Uses Census address-range interpolation so coordinates may not be rooftop-precise.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1,
   "description": "One U.S., Puerto Rico, or U.S. Island Areas address to geocode."
  },
  "timeout": {
   "type": "integer",
   "default": 8,
   "maximum": 8,
   "minimum": 2
  },
  "benchmark": {
   "enum": [
    "Public_AR_Current",
    "4"
   ],
   "type": "string",
   "default": "Public_AR_Current"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-us-address-geocoder-42976fe0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)