# Novarithm US Address Geocoder

> Novarithm US Address Geocoder is a paid API for AI agents from api.novarithm.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-11).

Converts a US street address into geographic coordinates (lat/lon) and census-enriched geographies using the U.S. Census Bureau Geocoder.

## Facts

- Endpoint: GET https://api.novarithm.com/agents/v1/geo/us-address?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/novarithm-us-address-geocoder-d7c49693
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VfJJsXoLAhdJrzwlWhwYw

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 novarithm-us-address-geocoder-d7c49693
```

Example prompt: Can you geocode the address 350 5th Ave, New York, NY 10118 and give me the latitude, longitude, census tract, and congressional district?

## When to prefer this

Choose this endpoint when you need US address geocoding enriched with Census geographies (tract, block, district) at a very low cost per call ($0.003). Ideal for agents needing both coordinates and census metadata in a single call. Prefer this over Google Maps Geocoding API when Census-level administrative geographies are required, or when cost efficiency matters. Not suitable for non-US addresses, real-time GPS tracking, or rooftop-precision geocoding.

## Known failure modes

- Address not found or unmatched — matched: false returned with no coordinates
- Malformed address input (missing house number or state) — may return unmatched result
- Non-US addresses will not be geocoded — endpoint only supports US addresses
- Coordinates are interpolated from TIGER/Line ranges, not rooftop-precise — unsuitable for parcel-level accuracy
- Network or service errors returning HTTP 4xx/5xx

## How this service works

Novarithm installe l'IA dans votre entreprise : elle répond à vos clients, trouve de nouveaux clients et fait le répétitif. Payés sur vos résultats.

## Output

Returns a JSON object containing matched status, standardized matched address, latitude and longitude (interpolated from Census TIGER/Line ranges), address components (street, city, state, ZIP), and a full set of census geographies including tract, block, block group, county, metro area, urban area, ZCTA, school district, congressional district, and county subdivision. Also includes source attribution, precision note, and billing metadata.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "One-line US address with house number, e.g. 350 5th Ave, New York, NY 10118"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "lat": 40.747851,
   "lon": -73.985076,
   "input": "350 5th Ave, New York, NY 10118",
   "source": "U.S. Census Bureau Geocoder, benchmark Public_AR_Current / vintage Current_Cu...",
   "matched": true,
   "sources": [
    {}
   ],
   "precision": "interpolated on Census address ranges (TIGER), not a rooftop point",
   "price_usd": 0.003,
   "components": {
    "zip": "10118",
    "city": "NEW YORK",
    "state": "NY",
    "street": "5TH AVE",
    "house_range": "350-356"
   },
   "geographies": {
    "zcta": {},
    "block": {},
    "place": {},
    "state": {},
    "county": {},
    "metro_area": {},
    "urban_area": {},
    "block_group": {},
    "census_tract": {},
    "school_district": {},
    "county_subdivision": {},
    "congressional_district": {}
   },
   "billing_unit": "address",
   "generated_at": "2026-10-23T10:03:29Z",
   "matched_address": "350 5TH AVE, NEW YORK, NY, 10118",
   "other_candidates": 0
  },
  "service": "us_geocode"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/novarithm-us-address-geocoder-d7c49693/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.novarithm.com](https://www.zero.xyz/host/api.novarithm.com/llms.txt)
