Ballpark Weather

GET

https://api.playbook-api.com/v1/mlb/venue-weather

Last modified:2026-03-01 21:46:35

Retrieve real-time and historical weather conditions for MLB venues, along with betting-relevant impact analysis including projected run totals, over/under lean, and home run environment.

Examples:
Single team, list format:
https://api.playbook-api.com/v1/mlb/venue-weather?teamId=LAD&format=list&api_key=YOUR_API_KEY

All teams, today, list format:
https://api.playbook-api.com/v1/mlb/venue-weather?api_key=YOUR_API_KEY

Get venue weather for a Historical date::
https://api.playbook-api.com/v1/mlb/venue-weather?date=2025-07-04&api_key=YOUR_API_KEY

Single team, detail format:
https://api.playbook-api.com/v1/mlb/venue-weather?teamId=LAD&format=detail&api_key=YOUR_API_KEY

Force refresh:
https://api.playbook-api.com/v1/mlb/venue-weather?teamId=NYY&refresh=true

Usage & Credits
Requests are metered based on the format and number of teams returned:
credits = format_multiplier × (1 + row_count)

list uses a 1× multiplier
detail uses a 2× multiplier

Request

Query Params

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.playbook-api.com/v1/mlb/venue-weather?teamId=NYY&date=Today&format=list&refresh=false'

Response Example

{
    "teamId": "COL",
    "teamName": "Colorado Rockies",
    "venue": {
        "park": "Coors Field",
        "parkProfile": "HITTER",
        "roof": "OPEN_AIR",
        "altitudeFt": 5200,
        "parkFactor": 1.18
    },
    "conditions": {
        "summary": "High altitude, warm temperatures, and outgoing wind strongly favor hitters",
        "tempF": 78,
        "humidity": 32,
        "wind": {
            "dir": "SW",
            "mph": 14,
            "type": "OUT",
            "component": 11.2
        },
        "precipProb": 0.05,
        "isDay": false
    },
    "impact": {
        "projectedTotal": 11.4,
        "lean": "OVER",
        "strength": "STRONG",
        "confidence": "HIGH",
        "components": {
            "tempAdjustment": 0.3,
            "windAdjustment": 0.8,
            "humidityAdjustment": 0.2,
            "altitudeAdjustment": 1.4,
            "parkFactorAdjustment": 1.0,
            "dayNightAdjustment": -0.1
        }
    },
    "insights": {
        "hrEnv": "HIGH",
        "xbhEnv": "HIGH",
        "props": {
            "homeRuns": {
                "environment": "HIGH",
                "expectedTotal": 3.1
            },
            "extraBaseHits": {
                "environment": "HIGH",
                "expectedTotal": 7.4
            }
        }
    },
    "alerts": [
        {
            "type": "WIND",
            "severity": "HIGH",
            "message": "Strong outgoing wind (14 mph SW) at a hitter-friendly park"
        }
    ]
}

Modified at 2026-03-01 21:46:35

Starting Pitchers

Strikeout Predictor