# AgentsTools Sports Scores

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

Returns live and recent game scores for MLB, NHL, NFL, NBA, or EPL, including both teams, score, game state, period/inning, and start time, sourced from official league APIs and ESPN.

## Facts

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

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 agentstools-sports-scores-48b5366e
```

Example prompt: What are the live NBA scores right now? Show me all games with current score, period, and game state.

## When to prefer this

Use this endpoint when you need normalized, multi-source sports scores across MLB, NHL, NFL, NBA, or EPL in a single call. Prefer it over building your own scraper or calling multiple league APIs separately — it handles source normalization and tagging automatically. Best for real-time game tracking, score monitoring, or surfacing recent results to a user on demand.

## Known failure modes

- Unsupported league key returns a validation error
- Invalid ISO date format returns a 400 bad request
- No games available for the given date returns an empty result set
- Network timeout or upstream API outage from league or ESPN may cause 500 errors
- limit parameter out of range (below 1 or above 100) returns a validation error

## How this service works

Live and recent game scores for a major sports league, normalized to one cited JSON. Give a league such as mlb, nhl, nfl, nba or epl and get each game with both teams, the score, the game state, the period or inning and the start time. Sourced from official league APIs and ESPN, each record tagged with its source.

## Output

A normalized JSON array of game records, each containing both team names, current score, game state (e.g. live, final, scheduled), the current period or inning, the game start time, and a source tag indicating whether data came from the official league API or ESPN.

## 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/agentstools-sports-scores-48b5366e/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)