# OneShot Agent API – US Address Place Resolver

> OneShot Agent API – US Address Place Resolver is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-19).

Resolves a US street address to standardized geographic data including coordinates, census tract, county, city name, and matched postal address.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/resolve/place?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-us-address-place-resolver-09a0b5e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zetWHNO8wQRZLsOTt9eg8

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 oneshot-agent-api-us-address-place-resolver-09a0b5e0 -d '<json body>'
```

Example prompt: Can you resolve the address 1600 Pennsylvania Ave NW, Washington, DC and give me the coordinates, county, census tract, and matched postal address?

## When to prefer this

Choose this endpoint when you need to geocode, standardize, or enrich a US street address with census geography data (tract, block, county FIPS) in a single pay-per-call, no-API-key call over x402 with USDC. Prefer it over general geocoding APIs when you also need census-level identifiers (tract_id, block_id, county_id) alongside coordinates and do not want to manage API credentials.

## Known failure modes

- Address not found in database (found: false, candidates: 0)
- Ambiguous address returns multiple candidates with lower confidence
- Malformed or non-US address returns an error or found: false
- Missing city/state/ZIP causes resolution failure
- PO boxes or non-standard addresses may not resolve

## How this service works

Resolve a US street address to its coordinates and its state, county and census tract codes.

## Output

Returns a JSON object with found status, standardized street, city, state, postal code, matched address string, latitude, longitude, census tract ID, block ID, county ID and name, place name, state code, and candidate count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "A US street address on one line, with city and state or ZIP, for example 1600 Pennsylvania Ave NW, Washington, DC. 5 to 200 characters."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "city": "WASHINGTON",
  "found": true,
  "state": "DC",
  "street": "1600 PENNSYLVANIA AVE NW",
  "block_id": "110019800001034",
  "latitude": 38.898702605245,
  "tract_id": "11001980000",
  "county_id": "11001",
  "longitude": -77.035189204737,
  "candidates": 1,
  "place_name": "Washington city",
  "state_code": "11",
  "county_code": "001",
  "county_name": "District of Columbia",
  "postal_code": "20500",
  "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-us-address-place-resolver-09a0b5e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)