{"uid":"cap_mHx846UY6iEkApAZEM38P","slug":"sports-schedule-api-397b0bb2","name":"Sports Schedule API","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://payai.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_5KzemvwfnFnpkyMr9R9vw","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 fixtures and game schedules for major sports leagues (MLB, NHL, NFL, NBA, EPL) with teams, start times, and venues, normalized into a single JSON response.","exampleAgentPrompt":"What NBA games are scheduled for December 15th? Give me all the matchups, tip-off times, and venues.","exampleUseCases":[{"title":"Plan viewing party around games","prompt":"What NFL games are on this Sunday, November 10th? I need the matchups and kickoff times so I can plan a watch party."},{"title":"Track EPL weekend fixtures","prompt":"Can you pull up all the Premier League matches scheduled for this Saturday? I want to know which teams are playing and where."},{"title":"Daily sports briefing for agent","prompt":"Give me today's full MLB schedule — every game, both teams, start times, and stadiums — so I can build my daily sports briefing."}],"resultDescription":"A normalized JSON array of scheduled games for the requested league, each entry including home team, away team, start time (with timezone), and venue name. Results are filtered by the optional date parameter and capped by the limit parameter (default 50, max 100).","failureModes":["Invalid league key (not one of mlb, nhl, nfl, nba, epl) returns an error","Malformed ISO date string causes a 400 bad request","No games scheduled for the requested date returns an empty array","Rate limiting or upstream sports data source unavailability may cause 5xx errors","Limit value outside 1-100 range returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need a quick, cheap ($0.004/call) normalized list of upcoming or same-day fixtures for a major sports league without building a custom sports data integration. It covers the five largest leagues (MLB, NHL, NFL, NBA, EPL) in a single consistent JSON format. Prefer this over scraping official league websites or subscribing to expensive sports data APIs when your use case is calendar planning, scheduling alerts, or populating a daily sports digest.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T08:20:20.331Z","isFirstParty":false}