# Vibes-Coded US Geocoding API

> Vibes-Coded US Geocoding API is a paid API for AI agents from vibes-coded.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Geocodes a US address string to latitude/longitude coordinates and returns a normalized matched address.

## Facts

- Endpoint: POST https://vibes-coded.com/api/v1/outcomes/geocode-us
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibes-coded-us-geocoding-api-674c5a4b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C5LQ3rsr7vQ50sIof0SVU

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 vibes-coded-us-geocoding-api-674c5a4b -d '<json body>'
```

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

## When to prefer this

Choose this endpoint when you need pay-per-call US address geocoding billed in USDC via the x402 protocol with no subscription required. It is well-suited for AI agents that need on-demand, single-address geocoding at low per-call cost without API key management overhead.

## Known failure modes

- Address not found in US geocoding database — returns ok: false or match_count: 0
- Non-US addresses will fail or return no match
- Ambiguous address with multiple potential matches may return partial results
- Malformed or incomplete address string may yield no result
- HTTP 402 returned if USDC payment header is missing or invalid

## How this service works

Pay-per-call JSON for AI agents: skill search, listing optimization, install plans, productization, and artifact risk scoring. HTTP 402 → USDC. Full skill marketplace on-site.

## Output

Returns a JSON object with ok: true, latitude and longitude as floats, the original address echo, match_count indicating how many matches were found, and a normalized matched_address string in USPS format.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "lat": 38.8987,
  "lon": -77.0352,
  "address": "1600 Pennsylvania Ave NW, Washington, DC",
  "match_count": 1,
  "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibes-coded-us-geocoding-api-674c5a4b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vibes-coded.com](https://www.zero.xyz/host/vibes-coded.com/llms.txt)