# Sports Schedule API (agentstools.dev)

> Sports Schedule API (agentstools.dev) is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns upcoming and current game schedules for a major sports league (MLB, NHL, NFL, NBA, or EPL), including both teams, start time, and venue, normalized to a single JSON response.

## Facts

- Endpoint: GET https://api.agentstools.dev/sports/schedule
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sports-schedule-api-agentstools-dev-c231f98b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jWtEVu7F2dNJN4XQBY-d2

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-schedule-api-agentstools-dev-c231f98b
```

Example prompt: What NBA games are scheduled for November 15th? Give me both teams, tip-off time, and venue for each game.

## When to prefer this

Use this endpoint when an agent needs a cheap, normalized single-call lookup of upcoming or current game schedules across major North American sports leagues or the English Premier League. Ideal for planning workflows around the sports calendar, surfacing game times to users, or triggering downstream logic based on upcoming matchups. Prefer this over scraping league websites or using heavier sports data APIs when you only need schedule/fixture data without advanced stats.

## Known failure modes

- Invalid league key returns an error — must be one of: mlb, nhl, nfl, nba, epl
- Malformed ISO date in the date parameter causes a validation error
- No games found for the given date returns an empty list
- Exceeding the limit maximum of 100 returns a validation error
- Payment not provided or insufficient USDC results in a 402 Payment Required response

## How this service works

Upcoming fixtures and the game schedule for a major sports league, normalized to one cited JSON. Give a league such as mlb, nhl, nfl, nba or epl and an optional date, and get each scheduled game with both teams, start time and venue. A cheap way for an agent to plan around the sports calendar.

## Output

A normalized JSON array of scheduled games for the requested league, each entry containing both competing teams, the game start time, and the venue. Optionally filtered by a specific date and capped at a configurable limit (default 50, max 100).

## 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": [
      "league"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "Optional day filter as an ISO date such as 2025-10-01. Omit for live and current games."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Max records to return, default 50"
      },
      "league": {
       "enum": [
        "mlb",
        "nhl",
        "nfl",
        "nba",
        "epl"
       ],
       "type": "string",
       "description": "League key. One of the supported major leagues."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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