# TBS Weather & Climate API – Historical Daily Weather

> TBS Weather & Climate API – Historical Daily Weather 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-10).

Returns historical daily weather data (temperature min/max, precipitation, conditions) for a specified date range and location (city name or lat/lon coordinates).

## Facts

- Endpoint: GET https://x402.tbs-digital.com/weather/historical?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-weather-climate-api-historical-daily-weather-2812a743
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ycHuASmKlDsgc4QX1K8IO

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-historical-daily-weather-2812a743
```

Example prompt: Can you pull up the historical daily weather for London from January 5th to January 12th, 2025 — I need the temperature highs and lows and precipitation for each day?

## When to prefer this

Choose this endpoint when you need historical (past) daily weather data — temperature ranges and precipitation — for a specific date range and location. Prefer it over current-weather endpoints when the query involves past dates rather than present or future conditions. It is ideal for retrospective analysis, verification tasks, climate research, or enriching datasets with past weather context. Use city name for convenience or lat/lon for precision.

## Known failure modes

- Invalid city name returns location resolution error
- Lat/lon out of valid range (-90..90, -180..180) returns validation error
- Future dates or unavailable archive dates may return empty or error
- Malformed date format (not YYYY-MM-DD) causes bad request
- Payment failure via x402 protocol returns 402 status
- Very large date ranges may time out or return partial data

## How this service works

Historical daily weather (archive): temperature min/max, precipitation, conditions for a past date range. City or lat/lon. start/end optional — defaults to last 7 complete UTC days.

## Output

Returns a structured JSON object with a daily array of weather records (temperature min/max, precipitation, conditions) for each date in the requested range, plus location metadata (name, country, lat/lon), timezone info, UTC offset, the data source, and a request ID. Defaults to the last 7 complete UTC days if no date range is specified.

## 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": {
      "end": {
       "type": "string",
       "description": "End date YYYY-MM-DD (optional, default: yesterday)"
      },
      "lat": {
       "type": "number",
       "description": "Latitude -90..90 (alternative to city)"
      },
      "lon": {
       "type": "number",
       "description": "Longitude -180..180 (alternative to city)"
      },
      "city": {
       "type": "string",
       "description": "City name (alternative to lat/lon)"
      },
      "start": {
       "type": "string",
       "description": "Start date YYYY-MM-DD (optional, default: 7 days ago)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "daily": {
       "type": "array"
      },
      "payer": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "nullable": true
        },
        "network": {
         "type": "string"
        }
       }
      },
      "range": {
       "type": "object",
       "properties": {
        "end": {
         "type": "string"
        },
        "start": {
         "type": "string"
        }
       }
      },
      "source": {
       "type": "string"
      },
      "location": {
       "type": "object",
       "properties": {
        "lat": {
         "type": "number"
        },
        "lon": {
         "type": "number"
        },
        "name": {
         "type": "string"
        },
        "country": {
         "type": "string"
        }
       }
      },
      "timezone": {
       "type": "string"
      },
      "request_id": {
       "type": "string"
      },
      "generated_at": {
       "type": "string"
      },
      "utc_offset_seconds": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "daily": [
   {
    "date": "2026-06-01",
    "temp_max_c": 24.1,
    "temp_min_c": 12.4,
    "precip_sum_mm": 0.2,
    "condition_code": "1"
   }
  ],
  "payer": {
   "address": "0x0000000000000000000000000000000000000000",
   "network": "base"
  },
  "range": {
   "end": "2026-06-07",
   "start": "2026-06-01"
  },
  "source": "open-meteo",
  "location": {
   "lat": 48.85,
   "lon": 2.35,
   "name": "Paris",
   "country": "FR"
  },
  "timezone": "Europe/Paris",
  "request_id": "0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55",
  "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-historical-daily-weather-2812a743/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)