# Sports Game Brief API (NBA, NFL, MLB, EPL)

> Sports Game Brief API (NBA, NFL, MLB, EPL) is a paid API for AI agents from x402-trends-server.onrender.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns normalized schedules, live/recent scores, matchup status, team info, venue, and a concise game brief for NBA, NFL, MLB, and EPL games filtered by league, date, and optional team.

## Facts

- Endpoint: GET https://x402-trends-server.onrender.com/api/sports-game-brief
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sports-game-brief-api-nba-nfl-mlb-epl-277a22e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VsXcqHr8c0txs2C6UN_Vs

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 sports-game-brief-api-nba-nfl-mlb-epl-277a22e3
```

Example prompt: What are today's NBA games — scores, venues, and a quick summary for each matchup?

## When to prefer this

Choose this endpoint when you need structured, normalized sports game data across NBA, NFL, MLB, or EPL with a built-in natural-language game brief — ideal for AI agents that need both machine-readable scores and a human-friendly summary in one call. Prefer it over raw stats APIs when you want a concise matchup narrative without post-processing. It supports team-level filtering and multi-league coverage in a single endpoint.

## Known failure modes

- Missing required 'league' parameter returns validation error
- Invalid league value (not NBA/NFL/MLB/EPL) returns enum validation error
- Date outside available data range returns empty games array
- Unknown team name/abbreviation may return no filtered results
- Limit exceeding 20 is clamped or rejected
- Service on render.com free tier may cold-start with slow initial response
- Payment not processed (x402) results in 402 Payment Required response

## How this service works

Get normalized sports schedules, live or recent scores, matchup status, teams, venue and a concise game brief for NBA, NFL, MLB and English Premier League (EPL). Filter by league, date and optional team name or abbreviation. Use for NBA scores, NFL games, MLB scores, EPL fixtures, today's games, schedules and AI sports research.

## Output

A JSON object containing a list of games for the requested league and date, each with home team, away team, scores, game status, venue, period/clock info, and a concise natural-language game summary. Also includes metadata like total game count, cache status, and retrieval timestamp.

## 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",
     "required": [
      "league"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "Game date in YYYY-MM-DD. Defaults to today's UTC date."
      },
      "team": {
       "type": "string",
       "description": "Optional team name or abbreviation filter, such as LAL, Lakers, KC, Chiefs, LAD, Dodgers, Arsenal, or ARS."
      },
      "limit": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1,
       "description": "Maximum games returned. Defaults to 10 and cannot exceed 20."
      },
      "league": {
       "enum": [
        "NBA",
        "NFL",
        "MLB",
        "EPL"
       ],
       "type": "string",
       "description": "Sports league: NBA basketball, NFL football, MLB baseball, or EPL English Premier League soccer."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "status",
      "source",
      "league",
      "date",
      "teamFilter",
      "count",
      "cached",
      "stale",
      "retrievedAt",
      "games"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "games": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "league",
         "date",
         "status",
         "homeTeam",
         "awayTeam",
         "homeScore",
         "awayScore",
         "venue",
         "summary"
        ],
        "properties": {
         "id": {
          "type": [
           "integer",
           "string"
          ]
         },
         "date": {
          "type": "string"
         },
         "clock": {
          "type": [
           "string",
           "null"
          ]
         },
         "venue": {
          "type": [
           "string",
           "null"
          ]
       
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sports-game-brief-api-nba-nfl-mlb-epl-277a22e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-trends-server.onrender.com](https://www.zero.xyz/host/x402-trends-server.onrender.com/llms.txt)
