# HARS-Zero Signal API — Geocode

> HARS-Zero Signal API — Geocode is a paid API for AI agents from hars.cryptotavern.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Convert a free-text address or place name into latitude/longitude coordinates using OSM Nominatim, paying per call in USDC via x402.

## Facts

- Endpoint: GET https://hars.cryptotavern.xyz/paid/geocode
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hars-zero-signal-api-geocode-dabcb70a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KLZ0r65mQhagVAAOWzB6F

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 hars-zero-signal-api-geocode-dabcb70a
```

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

## When to prefer this

Choose this endpoint when you need pay-per-call geocoding with no API key or subscription, especially in high-volume agent loops where sub-cent USDC micropayments on Base or Solana are acceptable. It is well-suited for agents that only occasionally need geocoding and want to avoid managing API credentials. Use it when OSM Nominatim coverage is sufficient (global coverage, strong for cities and well-known addresses).

## Known failure modes

- Address not found — results array is empty with count 0
- Ambiguous query returns multiple low-confidence results with varying importance scores
- OSM Nominatim rate limit or downtime causes upstream failure
- Malformed query string yields no parseable location
- Payment not processed via x402 — request rejected before geocode is attempted

## How this service works

Utility API for AI agents — fetch URLs, extract structured HTML,
summarize text, get live FX rates, and geocode addresses. Pay per call
in USDC on Base or Solana via x402. No API keys, no subscriptions.
Sub-cent pricing optimized for high-volume agent loops.

## Output

Returns a JSON object with a timestamp, the original query string, a count of results, and an array of result objects each containing lat, lon, display_name, type, importance score, and bounding_box coordinates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "as_of",
  "query",
  "count",
  "results"
 ],
 "properties": {
  "as_of": {
   "type": "string",
   "format": "date-time",
   "description": "RFC3339 timestamp"
  },
  "count": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  },
  "risks": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "product": {
   "type": "string"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "lat",
     "lon"
    ],
    "properties": {
     "lat": {
      "type": "number"
     },
     "lon": {
      "type": "number"
     },
     "type": {
      "type": "string"
     },
     "importance": {
      "type": "number"
     },
     "bounding_box": {
      "type": "array"
     },
     "display_name": {
      "type": "string"
     }
    }
   }
  },
  "evidence": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uri"
   },
   "description": "Polymarket order book / event / reference URLs"
  },
  "confidence": {
   "type": "number",
   "maximum": 1,
   "minimum": 0,
   "description": "Model confidence 0.0-1.0"
  },
  "market_ids": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Polymarket slugs or ids referenced in this response"
  },
  "next_best_action": {
   "type": "object",
   "properties": {
    "why": {
     "type": "string"
    },
    "endpoint": {
     "type": "string"
    },
    "price_usd": {
     "type": "number"
    },
    "product_id": {
     "type": "string"
    }
   }
  }
 },
 "description": "Free-text address -> lat/lng via OSM Nominatim."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "as_of",
  "query",
  "count",
  "results"
 ],
 "properties": {
  "as_of": {
   "type": "string",
   "format": "date-time",
   "description": "RFC3339 timestamp"
  },
  "count": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  },
  "risks": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "product": {
   "type": "string"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "lat",
     "lon"
    ],
    "properties": {
     "lat": {
      "type": "number"
     },
     "lon": {
      "type": "number"
     },
     "type": {
      "type": "string"
     },
     "importance": {
      "type": "number"
     },
     "bounding_box": {
      "type": "array"
     },
     "display_name": {
      "type": "string"
     }
    }
   }
  },
  "evidence": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uri"
   },
   "description": "Polymarket order book / event / reference URLs"
  },
  "confidence": {
   "type": "number",
   "maximum": 1,
   "minimum": 0,
   "description": "Model confidence 0.0-1.0"
  },
  "market_ids": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Polymarket slugs or ids referenced in this response"
  },
  "next_best_action": {
   "type": "object",
   "properties": {
    "why": {
     "type": "string"
    },
    "endpoint": {
     "type": "string"
    },
    "price_usd": {
     "type": "number"
    },
    "product_id": {
     "type": "string"
    }
   }
  }
 },
 "description": "Free-text address -> lat/lng via OSM Nominatim."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hars-zero-signal-api-geocode-dabcb70a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hars.cryptotavern.xyz](https://www.zero.xyz/host/hars.cryptotavern.xyz/llms.txt)