Saylor Innovations Agent Bazaar by Saylor Innovations
Connect an Agent
mirrored listing x402 eip155:8453

Postal code resolution for ~60 countries via Zippopotam

Postal code resolution for ~60 countries via Zippopotam.us (GeoNames data, CC BY 4.0). Forward: ?country=us&code=90210 -> place names, state, lat/lon. Reverse: ?country=us&state=ca&city=beverly hills -> matching postal codes with coordinates. Unknown codes return found=false (an explicit validation verdict). Cached 30 days.

Do you run data.greeneris.io? This listing was mirrored from Coinbase's public Bazaar. Claim it in 30 seconds — no account required — and it becomes verified, permanently overriding the mirrored copy.

Claim this listing
1000 (raw units)
price
2
calls / 30d
2
unique payers
2026-08-27
updated

Provider

data.greeneris.io · discovered, not yet claimed by its owner

Payment (x402 accepts[])

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x6ab8efe305cce67daa48c97bde29c04402822dff",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "maxTimeoutSeconds": 300
  }
]

Output schema

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "code": "90210",
          "country": "us"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "count": 1,
          "country": "United States",
          "country_code": "US",
          "found": true,
          "mode": "forward",
          "places": [
            {
              "latitude": 34.0901,
              "longitude": -118.4065,
              "name": "Beverly Hills",
              "state": "California",
              "state_code": "CA"
            }
          ],
          "postal_code": "90210",
          "source": "Zippopotam.us, data from GeoNames (CC BY 4.0, attribution required)"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET",
                "HEAD",
                "DELETE"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "city": {
                  "description": "City name (reverse mode, with state)",
                  "type": "string"
                },
                "code": {
                  "description": "Postal code to resolve (forward mode)",
                  "type": "string"
                },
                "country": {
                  "description": "2-letter ISO country code, e.g. us, fr, de",
                  "type": "string"
                },
                "state": {
                  "description": "State/region name or code (reverse mode, with city)",
                  "type": "string"
                }
              },
              "required": [
                "country"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

Use it

curl

curl "https://data.greeneris.io/v1/geo/postal"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

JavaScript

const res = await fetch("https://data.greeneris.io/v1/geo/postal");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

Python

import httpx
res = httpx.get("https://data.greeneris.io/v1/geo/postal")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Machine-readable

Everything on this page is also available as clean JSON at /resources/3927.json, and this resource appears in /discovery/resources and /discovery/search.