# NBA Venue Weather

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

Returns real-time weather conditions (temperature, wind, precipitation) near any NBA arena by team ID

## Facts

- Endpoint: GET https://fanfare-api.fly.dev/nba/venue-weather
- Price: $0.001000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fanfare-api-fly-dev-f951ed4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2kIcJ7scYTa7pTr9iAPIx

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-f951ed4a
```

Example prompt: What's the current weather near the Golden State Warriors arena — temperature, wind, and conditions right now?

## When to prefer this

Use this endpoint when you need live weather conditions specifically tied to an NBA team's home arena location, identified by NBA team ID. Prefer this over generic weather APIs when you want pre-mapped arena geolocation without having to look up stadium coordinates manually.

## Known failure modes

- Invalid or missing teamId returns an error response
- Unknown team ID not recognized by the API returns a 400 or 404 error
- Upstream weather data provider unavailable causes a 503 or timeout
- Network issues with the fly.dev host causing intermittent failures

## How this service works

Real-time weather near any NBA arena — temperature, wind, and conditions. Useful for travel planning around game day.

## Output

Returns real-time weather data near the specified NBA team's arena, including temperature, wind speed, and current conditions (e.g. clear, rainy, cloudy). Useful for game-day travel and attendance planning.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "teamId": "1"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "teamId"
     ],
     "properties": {
      "teamId": {
       "type": "string",
       "description": "Numeric NBA team/venue ID (e.g. '1' for Atlanta Hawks / State Farm Arena)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "request_id",
  "sport",
  "league",
  "retrieved_at",
  "data",
  "warnings",
  "errors"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "venue_id",
    "venue_name",
    "latitude",
    "longitude",
    "timezone",
    "current"
   ],
   "properties": {
    "current": {
     "type": "object",
     "required": [
      "temperature_c",
      "feels_like_c",
      "condition",
      "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-f951ed4a/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)