# Realtime Sports API

> Realtime Sports API is a developer API for live scores, play-by-play, box scores, schedules, teams, athletes, injuries, news and betting odds, with push delivery over webhooks and WebSocket, under one schema and one API key. 29 leagues monitored live: NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions. Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.

Key facts:
- REST base URL: https://www.realtimesportsapi.com/api/v1 . Auth: `Authorization: Bearer <api key>` (or `X-API-Key`). Free key, no card: https://www.realtimesportsapi.com/signup
- Responses: `{ "success": true, "data": ..., "meta": { "rateLimit": { "limit", "remaining", "reset" } } }`; errors `{ "success": false, "error": { "code", "message" } }`.
- Plans: Free (125 calls/month), Starter $29, Growth $49, Pro $99, Scale $299 per month. HTTP 429 with Retry-After when a limit is hit.
- Not suitable for in-play betting that needs sub-second data. Odds come from a single source book.

## Docs

- [API documentation](https://www.realtimesportsapi.com/docs): REST endpoints, WebSocket and webhooks with examples
- [OpenAPI 3 spec](https://www.realtimesportsapi.com/openapi.json): every endpoint, parameter and response shape
- [Postman collection](https://www.realtimesportsapi.com/postman.json): generated from the spec
- [Interactive reference](https://www.realtimesportsapi.com/api-docs): Swagger UI
- [MCP server](https://www.realtimesportsapi.com/docs/mcp): hosted at https://www.realtimesportsapi.com/api/mcp for Claude, Cursor, ChatGPT
- [Full text for LLMs](https://www.realtimesportsapi.com/llms-full.txt): this file plus every endpoint and plan detail

## Product

- [Pricing](https://www.realtimesportsapi.com/pricing): plans, per-second limits, opt-in overage
- [Schedules](https://www.realtimesportsapi.com/schedules): NFL, college football, NBA and more, with JSON/CSV downloads
- [FAQ](https://www.realtimesportsapi.com/faq)
- [Terms](https://www.realtimesportsapi.com/terms)

## Optional

- [Blog](https://www.realtimesportsapi.com/blog): guides