# meld402 Geo Context — Postal Code Weather & Place Lookup

> meld402 Geo Context — Postal Code Weather & Place Lookup is a paid API for AI agents from meld402.vercel.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns place details (coordinates, region, country) and current weather conditions for a given country code and postal code, aggregated from Zippopotam and Open-Meteo.

## Facts

- Endpoint: POST https://meld402.vercel.app/api/geo/context
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meld402-geo-context-postal-code-weather-place-lookup-3104d622
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ivIYe_ikyJKLzq8mnVxDs

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 meld402-geo-context-postal-code-weather-place-lookup-3104d622 -d '<json body>'
```

Example prompt: What are the current weather conditions and location details for US postal code 94103? I need the temperature, humidity, wind speed, and what city and region it maps to.

## When to prefer this

Choose this endpoint when you need both place resolution and real-time weather in a single call for a postal code, without stitching together multiple APIs yourself. Ideal for agents that need location context from a postal code (coordinates, city, region) combined with current conditions (temperature, humidity, wind) in one stable schema paid per-call via USDC x402 — no API key management required.

## Known failure modes

- Invalid or unrecognized postal code returns an error or empty place data
- Country code not matching the postal code format causes lookup failure
- Postal code exists but weather data unavailable results in degraded response with partial data
- Malformed country code (not ISO alpha-2) causes validation error
- Network timeouts from upstream providers (Zippopotam, Open-Meteo) may cause degraded or failed response

## How this service works

14 paid data endpoints for autonomous agents and developers. Covers crypto intelligence (token, chain, Solana, gas), markets (FX, market pulse), location (weather), and research (news, brief). Each route aggregates multiple public sources into one stable schema with a single USDC payment over x402 on Base.

## Output

A JSON object with two sections: 'place' (city name, region, region code, country, country code, latitude, longitude, postal code) and 'weather' (temperature in Celsius, apparent temperature, conditions description, weather code, humidity percent, wind speed km/h, precipitation mm, daytime flag, timezone, UTC offset, local observation time), plus meta with data sources, attribution, and timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "type": "string",
   "maxLength": 2,
   "minLength": 2,
   "description": "ISO 3166-1 alpha-2 country code, e.g. \"US\", \"DE\", \"ID\"."
  },
  "postal_code": {
   "type": "string",
   "maxLength": 12,
   "minLength": 3,
   "description": "Postal code within that country, e.g. \"94103\"."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "place": {
    "region": "California",
    "country": "United States",
    "latitude": 37.7725,
    "longitude": -122.4147,
    "place_name": "San Francisco",
    "postal_code": "94103",
    "region_code": "CA",
    "country_code": "US"
   },
   "weather": {
    "timezone": "America/Los_Angeles",
    "conditions": "clear sky",
    "is_daytime": true,
    "weather_code": 0,
    "temperature_c": 24.9,
    "wind_speed_kmh": 15.5,
    "elevation_meters": 13,
    "humidity_percent": 55,
    "precipitation_mm": 0,
    "observed_at_local": "2026-08-23T14:00",
    "utc_offset_seconds": -25200,
    "apparent_temperature_c": 25.4
   }
  },
  "meta": {
   "as_of": "2026-08-24T00:00:00.000Z",
   "sources": [
    "zippopotam",
    "openmeteo"
   ],
   "degraded": [],
   "attribution": [
    "Postal code data by Zippopotam.us",
    "Weather data by Open-Meteo (open-meteo.com), CC BY 4.0"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meld402-geo-context-postal-code-weather-place-lookup-3104d622/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meld402.vercel.app](https://www.zero.xyz/host/meld402.vercel.app/llms.txt)