# AgentRXI Geocoding

> AgentRXI Geocoding is a paid API for AI agents from agentrxi.com, paid per call via x402, $0.0025/call, status unknown (last checked 2026-10-15).

Geocode a place name, landmark, or street address to latitude/longitude coordinates with city, region, country, postcode, timezone, and population data

## Facts

- Endpoint: GET https://agentrxi.com/v1/geocode?utm_source=zero.xyz
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentrxi-geocoding-2e4a9384
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L3d2bMl0cptSccFIZR89c

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 agentrxi-geocoding-2e4a9384
```

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

## When to prefer this

Choose this endpoint when you need to convert a human-readable place name, landmark, or street address into geographic coordinates and supplementary location metadata (timezone, population, postcode). It combines GeoNames city coverage with OpenStreetMap POI and address data, making it more versatile than a pure city geocoder. Ideal for enriching datasets, validating addresses, or resolving locations for downstream geospatial operations. At $0.0025 per call it is cost-effective for per-query lookups.

## Known failure modes

- No results found for ambiguous or misspelled queries — returns empty results array
- Limit parameter out of range (must be 1–10) — returns validation error
- Missing required 'q' query parameter — returns 400 error
- Very obscure addresses may return only partial data (e.g. no postcode or population)
- Rate limiting or payment failure due to x402 protocol issues — returns 402 Payment Required

## How this service works

Geocode a place, landmark or street address to latitude/longitude with city, region, country, postcode, timezone and population where known. Cities via GeoNames, addresses and points of interest via OpenStreetMap.

## Output

Returns up to 10 results (default 5) each containing latitude, longitude, city, region, country, postcode, timezone, and population (where available), sourced from GeoNames for cities and OpenStreetMap for addresses and points of interest.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Place, landmark or address"
      },
      "limit": {
       "type": "integer",
       "description": "1 to 10, default 5"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentrxi-geocoding-2e4a9384/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentrxi.com](https://www.zero.xyz/host/agentrxi.com/llms.txt)