# Global Weather API

Current conditions and forecasts by coordinates.

| Field | Value |
| --- | --- |
| Provider | APIStead Labs |
| Category | Weather & Geospatial |
| Networks | Base |
| Price | $0.001-$0.002 per call |
| Base URL | https://apistead.qd.je/api/v1 |
| Verification | verified (2/2 routes) |
| Last verified | 2026-11-13T13:52:10.060Z |
| Receipt | https://basescan.org/tx/0x8a3a1b940900f2a67a7c29aa5dfb9aec316b728a64bb9bb97ac992fb9d9afe85 |
| JSON | https://x402.apistead.qd.je/api/apis/global-weather-api |
| Markdown | https://x402.apistead.qd.je/api/apis/global-weather-api/md |
| MCP | https://apistead.qd.je/mcp |
| API reference | https://x402.apistead.qd.je/api |
| OpenAPI | https://x402.apistead.qd.je/openapi.json |

## For AI agents

Get current weather conditions or a daily forecast for a latitude and longitude.

## Scope

Weather only. Does not provide road conditions, air quality, alerts or historical climate data.

## Agent intents

- get the current weather
- get a weather forecast for coordinates
- check conditions before a delivery
- add weather context to a travel workflow

Weather is a classic agent utility: delivery planning, event operations, travel, agriculture and insurance. This API returns current conditions and a short forecast without a dashboard or an API key.

The preview uses Open-Meteo, a free open weather API, and normalizes the response into a small shape with units and a `generated_at` timestamp.

## Endpoints

### GET /weather/current?lat={lat}&lon={lon}

Current conditions for a coordinate.

- URL: https://apistead.qd.je/api/v1/weather/current?lat={lat}&lon={lon}
- Price: $0.001 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.558Z
- Latency: 3 ms
- Uptime (30d): 84.85%

Example request:

```http
GET https://apistead.qd.je/api/v1/weather/current?lat=51.5074&lon=-0.1278
```

Example response:

```json
{
  "source": "open-meteo",
  "location": {
    "lat": 51.5074,
    "lon": -0.1278,
    "timezone": "Europe/London"
  },
  "wind_kph": 14,
  "condition": "partly_cloudy",
  "generated_at": "2026-11-09T20:00:00Z",
  "temperature_c": 11.4
}
```

### GET /weather/forecast?lat={lat}&lon={lon}&days={days}

Daily forecast for up to 7 days.

- URL: https://apistead.qd.je/api/v1/weather/forecast?lat={lat}&lon={lon}&days={days}
- Price: $0.002 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.565Z
- Latency: 4 ms
- Uptime (30d): 84.85%

Example request:

```http
GET https://apistead.qd.je/api/v1/weather/forecast?lat=51.5074&lon=-0.1278&days=3
```

Example response:

```json
{
  "days": [
    {
      "date": "2026-11-10",
      "low_c": 7,
      "high_c": 13,
      "condition": "rain"
    },
    {
      "date": "2026-11-11",
      "low_c": 6,
      "high_c": 12,
      "condition": "cloudy"
    }
  ],
  "source": "open-meteo"
}
```

## Payment

Every paid route uses x402 over HTTP. Call the route without payment to receive a 402 challenge, then pay the quoted USDC amount and retry. The 402 challenge is the authoritative source for price, asset, network and pay-to address. Reading this record and the discovery API is free.

- Protocol: x402 v2
- Asset: USDC
- Networks: Base
- Price: $0.001-$0.002 per call

## Verification

- State: verified
- Routes verified: 2/2
- Last verified: 2026-11-13T13:52:10.060Z
- Receipt: https://basescan.org/tx/0x8a3a1b940900f2a67a7c29aa5dfb9aec316b728a64bb9bb97ac992fb9d9afe85

## Agent links

- JSON: https://x402.apistead.qd.je/api/apis/global-weather-api
- Markdown: https://x402.apistead.qd.je/api/apis/global-weather-api/md
- Routes: https://x402.apistead.qd.je/agent/routes?id=global-weather-api
- Receipts: https://x402.apistead.qd.je/agent/receipts?id=global-weather-api
- API reference: https://x402.apistead.qd.je/api
- MCP guide: https://x402.apistead.qd.je/mcp-docs
- Agent skill: https://x402.apistead.qd.je/skill
- OpenAPI: https://x402.apistead.qd.je/openapi.json
- MCP: https://apistead.qd.je/mcp
- Docs: https://apistead.qd.je/api


## Changelog

### 1.0.0 - Initial verified release

The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.

release · 2026-11-11 · APIStead Labs