Postal Codes

Worldwide postal-code geocoding from Zippopotam: resolve a zip or postal code to places with coordinates, or a place name to its codes, across 60+ countries. Machine-payable per request.

Robinhood Chain

Offers

Offer	Endpoint	Price
Place to codes Postal codes for a place name. Append country, state, and city to the path, e.g. place/us/ca/beverly+hills.	`/m/zipcodes/place`	0.005 USDG
Code to places Places for one postal code with latitude and longitude. Append country and code to the path, e.g. zip/us/90210 or zip/de/10115.	`/m/zipcodes/zip`	0.005 USDG

Machine-readable: openapi.json with x-payment-info offers.

Try it live

Run the full MPP flow from your browser: catch the 402, sign the payment with your wallet, and watch it settle on-chain.

Pay with an agent

Any MPP or x402-compatible client works. With mppx, payment is automatic:

// x402 exact scheme (permit2) on Robinhood Chain
// 1. GET the endpoint, read the payment-required header (base64 JSON)
// 2. Sign PermitWitnessTransferFrom against Permit2 for the advertised offer
//    (spender = x402ExactPermit2Proxy, witness.to = merchant wallet)
// 3. Retry with the payment-signature header; settlement tx arrives
//    in the payment-response header
const res = await fetch('https://api.meshgateway.co/m/zipcodes/place', {
  headers: { 'payment-signature': signedPaymentPayload },
})

Or inspect the challenge yourself:

curl -i https://api.meshgateway.co/m/zipcodes/place
# HTTP/1.1 402 Payment Required
# WWW-Authenticate: Payment id="…", method="evm", intent="charge", …