# Delx US Geocode

> Delx US Geocode is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-17).

Geocodes a single U.S., Puerto Rico, or U.S. Island Areas address to approximate latitude/longitude coordinates via the public Census Geocoder for $0.001 USDC.

## Facts

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

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-us-geocode-762ce827 -d '<json body>'
```

Example prompt: Can you geocode the address 1600 Pennsylvania Ave NW, Washington DC 20500 and give me its latitude and longitude?

## When to prefer this

Choose this endpoint when you need low-cost ($0.001 USDC), single-address geocoding strictly within the United States, Puerto Rico, or U.S. Island Areas and can accept approximate coordinates with Census attribution. Prefer this over commercial geocoding APIs when cost sensitivity is high, global coverage is not needed, and address retention is not required.

## Known failure modes

- Address not found or ambiguous — Census Geocoder returns no match
- Timeout exceeded (max 8 seconds) — returns timeout error
- Non-US address submitted — not supported, returns error
- Malformed address string — returns validation error
- Census Geocoder upstream unavailable — returns service error

## How this service works

Address geocoding API for agents: geocode one U.S., Puerto Rico, or U.S. Island Areas address for $0.001 USDC through the public Census Geocoder. Returns approximate coordinates with required Census attribution—no global maps, navigation, or address retention.

## Output

Returns approximate latitude and longitude coordinates for the submitted address along with the matched address string and required U.S. Census Bureau attribution. Does not store addresses or support navigation routing.

## 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-us-geocode-762ce827/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)