{"uid":"cap_jWtEVu7F2dNJN4XQBY-d2","slug":"sports-schedule-api-agentstools-dev-c231f98b","name":"Sports Schedule API (agentstools.dev)","description":"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.","url":"https://api.agentstools.dev/sports/schedule","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A3yi28rWfQiuelUPCDdRJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"What NBA games are scheduled for November 15th? Give me both teams, tip-off time, and venue for each game.","exampleUseCases":[{"title":"Tonight's NHL games finder","prompt":"What NHL games are on tonight? I want to know which teams are playing, what time the pucks drop, and where each game is being held."},{"title":"Weekend EPL fixtures roundup","prompt":"Can you pull up all the Premier League fixtures for this weekend? I'd like to see the matchups, kickoff times, and stadiums for each game."},{"title":"Next Red Sox game lookup","prompt":"When do the Red Sox play next? Show me their upcoming MLB schedule with the opponent, start time, and venue so I can plan around it."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T08:20:15.699Z","isFirstParty":false}