# TBS Weather & Climate API – Current Conditions (Now)

> TBS Weather & Climate API – Current Conditions (Now) is a paid API for AI agents from x402.tbs-digital.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Returns real-time weather conditions (temperature, humidity, wind, pressure, UV, precipitation, day/night) plus a live AQI/PM2.5 air quality snapshot and today's high/low for a city or lat/lon.

## Facts

- Endpoint: GET https://x402.tbs-digital.com/weather/now?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-weather-climate-api-current-conditions-now-2fcf167d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5nHsH_IIRzSASysMylrUt

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 tbs-weather-climate-api-current-conditions-now-2fcf167d
```

Example prompt: What's the weather right now in San Francisco — temperature, feels-like, humidity, wind, and air quality?

## When to prefer this

Choose this endpoint when you need a single low-cost ($0.001) real-time snapshot of current weather and air quality together — temperature, humidity, wind, UV, AQI, and PM2.5 in one call. Prefer this over the full bundle endpoint when you only need current conditions (not forecasts or soil data) and want the cheapest possible call. Use the lat/lon parameters for precision or city name for convenience.

## Known failure modes

- Unknown city name returns an error or null location — use lat/lon instead
- Missing both city and lat/lon parameters causes a validation error
- lon provided without lat (or vice versa) causes a parameter error
- AQI/air_quality field may be null if no air quality data is available for the location
- Extreme or invalid lat/lon values (outside -90..90 or -180..180) cause a validation error
- Temporary upstream data unavailability may return stale or partial data

## How this service works

Current weather right now, cheap: temperature, feels-like, humidity, wind speed and direction, pressure, cloud cover, precipitation, UV, day/night — plus a live air-quality snapshot (AQI, PM2.5) and today’s high/low. City or lat/lon. The budget "weather now" call.

## Output

A JSON object containing current weather conditions (temperature, feels-like, humidity, wind speed/direction, atmospheric pressure, cloud cover, precipitation, UV index, day/night indicator), today's high/low temperatures, a live air quality snapshot (AQI and PM2.5), and location metadata (name, country, lat/lon, timezone, UTC offset). Also includes a request ID, generation timestamp, and payer address.

## 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",
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude -90..90 (requires lon)"
      },
      "lon": {
       "type": "number",
       "description": "Longitude -180..180 (requires lat)"
      },
      "city": {
       "type": "string",
       "description": "City name (alternative to lat/lon)"
      },
      "timezone": {
       "type": "string",
       "description": "Optional IANA timezone"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "payer": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "nullable": true
        },
        "network": {
         "type": "string"
        }
       }
      },
      "today": {
       "type": "object",
       "nullable": true
      },
      "source": {
       "type": "string"
      },
      "current": {
       "type": "object"
      },
      "location": {
       "type": "object",
       "properties": {
        "lat": {
         "type": "number"
        },
        "lon": {
         "type": "number"
        },
        "name": {
         "type": "string"
        },
        "country": {
         "type": "string"
        }
       }
      },
      "timezone": {
       "type": "string"
      },
      "request_id": {
       "type": "string"
      },
      "air_quality": {
       "type": "object",
       "nullable": true
      },
      "generated_at": {
       "type": "string"
      },
      "utc_offset_seconds": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "payer": {
   "address": "0x0000000000000000000000000000000000000000",
   "network": "base"
  },
  "today": {
   "date": "2026-08-09",
   "temp_max_c": 25,
   "temp_min_c": 15
  },
  "source": "open-meteo",
  "current": {
   "is_day": true,
   "temp_c": 21.3,
   "wind_kmh": 12,
   "condition": "Clear sky",
   "observed_at": "2026-08-09T11:00:00Z",
   "feels_like_c": 20.1,
   "humidity_pct": 55,
   "condition_code": "0"
  },
  "location": {
   "lat": 48.85,
   "lon": 2.35,
   "name": "Paris",
   "country": "FR"
  },
  "timezone": "Europe/Paris",
  "request_id": "0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55",
  "air_quality": {
   "pm2_5": 5.1,
   "aqi_european": 20
  },
  "generated_at": "2026-08-09T12:00:00.000Z",
  "utc_offset_seconds": 7200
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-weather-climate-api-current-conditions-now-2fcf167d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tbs-digital.com](https://www.zero.xyz/host/x402.tbs-digital.com/llms.txt)