# MLB Venue Weather

> MLB Venue Weather is a paid API for AI agents from fanfare-api.fly.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns real-time weather conditions (temperature, feels-like, wind speed, precipitation, humidity) at a specific MLB ballpark by venue ID.

## Facts

- Endpoint: GET https://fanfare-api.fly.dev/mlb/venue-weather
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fanfare-api-fly-dev-4e2949df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aQjFZinnx6WiqNm8T1Yax

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 fanfare-api-fly-dev-4e2949df
```

Example prompt: What's the current weather at Fenway Park — MLB venue ID 3 — including temperature, wind speed, and precipitation?

## When to prefer this

Use this endpoint when you need live, current weather conditions specifically at an MLB ballpark by its official venue ID. Prefer this over general weather APIs when you need MLB-specific venue coverage and game-day context such as feels-like temperature and humidity alongside wind and precipitation.

## Known failure modes

- Invalid or missing venueId returns a 400 or validation error
- Unknown venueId (non-existent MLB venue) may return 404 or empty result
- Weather data provider outage may result in 503 or stale data
- Payment not provided returns 402 Payment Required

## How this service works

Real-time weather at any MLB ballpark — temperature, feels-like, wind speed, precipitation, and humidity. Essential for outdoor game-day planning.

## Output

Returns real-time weather data for the specified MLB ballpark, including temperature, feels-like temperature, wind speed, precipitation level, and humidity, sourced live at query time.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "venueId": 3
  }
 }
}
```

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "venueId"
     ],
     "properties": {
      "venueId": {
       "type": "integer",
       "description": "MLB venue ID"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data",
  "sport",
  "errors",
  "league",
  "warnings",
  "request_id",
  "retrieved_at"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "current",
    "latitude",
    "timezone",
    "venue_id",
    "longitude",
    "venue_name"
   ],
   "properties": {
    "current": {
     "type": "object",
     "required": [
      "condition",
      "feels_like_c",
      "temperature_c",
      "wind_speed_kmh",
      "humidity_percent",
      "precipitation_mm"
     ],
     "properties": {
      "condition": {
       "type": "string"
      },
      "feels_like_c": {
       "type": "number"
      },
      "temperature_c": {
       "type": "number"
      },
      "wind_speed_kmh": {
       "type": "number"
      },
      "humidity_percent": {
       "type": "number"
      },
      "precipitation_mm": {
       "type": "number"
      }
     }
    },
    "latitude": {
     "type": "number"
    },
    "timezone": {
     "type": "string"
    },
    "venue_id": {
     "type": "string"
    },
    "longitude": {
     "type": "number"
    },
    "venue_name": {
     "type": "string"
    }
   }
  },
  "sport": {
   "type": "string"
  },
  "errors": {
   "type": "array",
   "items": {
    "type": "unknown"
   }
  },
  "league": {
   "type": "string"
  },
  "warnings": {
   "type": "array",
   "items": {
    "type": "unknown"
   }
  },
  "request_id": {
   "type": "string"
  },
  "retrieved_at": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fanfare-api-fly-dev-4e2949df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fanfare-api.fly.dev](https://www.zero.xyz/host/fanfare-api.fly.dev/llms.txt)