Lightning-fast API access to live and historical sports data. Built for developers, powered by AI, trusted by thousands.
Select a league to view pricing:
Everything you need to build sports applications that scale. Clean APIs, comprehensive data, and tools that just work.
Sub-100ms response times with 99.9% uptime. Built on scalable infrastructure that handles millions of requests daily.
Clean JSON responses, intuitive endpoints, and comprehensive docs. Start building in minutes.
Live stats, historical analytics, and deep insights across NBA, NFL, MLB, NHL, EPL, WNBA, NCAAF, and NCAAB.
First-class TypeScript and Python libraries. Type-safe, well-documented, and battle-tested.
Built-in MCP server for seamless AI integration. Natural language queries out of the box.
Free tier with no credit card required. Scale up as you grow with flexible pricing.
Trusted by teams building
We provide libraries for JavaScript and Python to make it easy to interact with our API.
import { BalldontlieAPI } from "@balldontlie/sdk";
const api = new BalldontlieAPI({ apiKey: "your-api-key" });
// Get NBA stats
await api.nba.getStats({ dates: ["2024-11-13", "2024-11-14"] });
// Get NFL stats
await api.nfl.getStats({ seasons: [2024] });
// Get MLB stats
await api.mlb.getStats({ player_ids: [208] });
// Get EPL stats
await api.epl.getPlayerStatsLeaders({
season: 2024,
type: "goals",
});
// Many more endpoints available!from balldontlie import BalldontlieAPI
api = BalldontlieAPI(api_key="your-api-key")
# Get NBA stats
api.nba.stats.list(dates=["2024-11-13", "2024-11-14"])
# Get NFL stats
api.nfl.stats.list(seasons=[2024])
# Get MLB stats
api.mlb.stats.list(player_ids=[208])
# Get EPL stats
api.epl.leaders.players.list(
season=2024,
type="goals",
)
# Many more endpoints available!Connect to any MCP-compatible AI assistant through our open-source MCP server for natural language sports data queries.
Built from the ground up for AI workflows. No complex integrations or custom code required.
Ask your AI assistant "What are today's NBA games?" and get instant, accurate results.
Connect to our hosted MCP server at
mcp.balldontlie.io in seconds. Works with all MCP
clients.
{
"mcpServers": {
"balldontlie-api": {
"url": "https://mcp.balldontlie.io/mcp",
"transport": "http",
"headers": {
"Authorization": "YOUR_API_KEY"
}
}
}
}Compatible with Claude Desktop, any MCP client, or self-host using our open-source MCP server.
Download our complete OpenAPI specification for AI agents, developer tools, and automated integrations.
Let AI assistants automatically understand and interact with our API
Generate client SDKs in any language with OpenAPI tools
Use with Postman, Insomnia, Swagger UI, and more
Full endpoint definitions, schemas, and authentication details
Access the most affordable and comprehensive sports API on the market.