# Shipp.ai Live Sports Events Feed

> Shipp.ai Live Sports Events Feed is a paid API for AI agents from api.shipp.ai, paid per call via x402, $0.01/call, status down (last checked 2026-10-13).

Retrieves a single live sports event record (NBA, NFL, NCAAFB, MLB, Soccer) with real-time scores, game clock, period, and team details, optionally filtered by timestamp or event ID.

## Facts

- Endpoint: POST https://api.shipp.ai/api/v1/connections/inline/1?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/shipp-ai-live-sports-events-feed-aec2214b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cGe-u-5pbZC1iWFlMqzeb

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 shipp-ai-live-sports-events-feed-aec2214b -d '<json body>'
```

Example prompt: What's the latest live event happening in the NBA right now — give me the current score, game clock, and period, filtering for basketball only.

## When to prefer this

Use this endpoint when you need a single real-time sports event with live score, game clock, and period data for NBA, NFL, NCAAFB, MLB, or Soccer. Prefer it over bulk sports data feeds when you only need the latest event and want low-cost per-call pricing at $0.01 USDC. Ideal for monitoring live game state or polling for score changes since a known event ID or timestamp.

## Known failure modes

- No events match the filter_instructions — returns empty data array
- Invalid since timestamp format returns a 400 Bad Request
- since_event_id not found may return empty results or error
- Payment failure (x402) if USDC balance insufficient
- Rate limiting or service unavailability returning 5xx errors

## How this service works

High-quality live data on Sports (NBA, NFL, NCAAFB, MLB, Soccer). Flat-fee endpoint that retrieves 1 events.

## Output

Returns a JSON array with one sports event object containing: event ID, description, sport code, game ID, home and away team names, current game clock, home and away point totals, current game period, and the game's wall-clock start time.

## Example request

```json
{
 "filter_instructions": "NBA games from the last 7 days"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "since": {
   "type": "string",
   "format": "date-time",
   "description": "Collect data since this timestamp (optional)"
  },
  "since_event_id": {
   "type": "string",
   "description": "Get events only after this ID, switches limit to asc mode. Filtered by since if event occurred before since (optional)"
  },
  "filter_instructions": {
   "type": "string",
   "description": "Natural language instructions describing what to filter for"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "01KGE0VFBBEX367CT75MPVW1D9",
    "desc": "Some event description",
    "sport": 1,
    "game_id": "01KFXTXKW5NDCMF58FKWJHCFCB",
    "away_name": "Team B",
    "home_name": "Team A",
    "game_clock": "12:34",
    "away_points": 51,
    "game_period": 2,
    "home_points": 54,
    "wall_clock_start": "2026-01-28T12:34:56Z"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/shipp-ai-live-sports-events-feed-aec2214b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.shipp.ai](https://www.zero.xyz/host/api.shipp.ai/llms.txt)