--- type: "firecrawl-provider" description: "Sleeper fantasy football from its public, keyless read API: NFL state, public leagues (settings, managers, rosters with starters, weekly matchups and transactions), NFL players trimmed from the player map, trending adds and drops, and the NFL schedule. Every player comes with injury status, bye week and whether his game has kicked off (locked), on rosters, matchup starters, player lookups and trending lists, so agents can avoid starting injured or bye-week players and never suggest moving a player whose game has started." use_when: "Sleeper fantasy football from its public, keyless read API: NFL state, public leagues (settings, managers, rosters with starters, weekly matchups and transactions), NFL players trimmed from the player map, trending adds and drops, and the NFL schedule. Every player comes with injury status, bye week and whether his game has kicked off (locked), on rosters, matchup starters, player lookups and trending lists, so agents can avoid starting injured or bye-week players and never suggest moving a player whose game has started." categories: "Sports" capabilities: 9 credits_per_call: 5 --- # Sleeper on Firecrawl Alexandria Sleeper fantasy football from its public, keyless read API: NFL state, public leagues (settings, managers, rosters with starters, weekly matchups and transactions), NFL players trimmed from the player map, trending adds and drops, and the NFL schedule. Every player comes with injury status, bye week and whether his game has kicked off (locked), on rosters, matchup starters, player lookups and trending lists, so agents can avoid starting injured or bye-week players and never suggest moving a player whose game has started. - Categories: Sports - Category index: [Sports category](https://alexandria.firecrawl.dev/agents/categories/sports) - Provider key: `sleeper-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/sleeper-com) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/openapi.json) ## Capabilities - [League](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/league): One public Sleeper NFL league: name, season, status, team count, starting lineup slots (roster_positions), league settings (waivers, trade deadline, playoffs, reserve rules) and scoring settings. An unknown league is not_found. - [League rosters](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/league_rosters): Every roster in a Sleeper league (or one roster_id) with owner, record and every player: lineup slot (starter in slot order, bench, reserve, taxi), position, NFL team, injury_status and body part, bye week, this week's game and whether it has kicked off (locked), and flags summarising all of it. Before recommending a start, sit, add or drop, read flags: never start a player flagged out or bye, warn on injured, and never suggest adding, dropping, starting or benching a locked player (his game has started or finished). Weekly lineups come from Sleeper; starters reflect what the manager last set. An unknown league or roster_id is not_found. - [League users](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/league_users): Managers in a Sleeper league: user id, display name, team name and whether they are a commissioner. Join to league_rosters by owner_id. An unknown league is not_found. - [Matchups](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/matchups): Head-to-head matchups for one week of a Sleeper league: each roster's matchup_id (rosters sharing it play each other), points, every player's points, and starters in lineup order with points and the same injury status, bye week, game, lock and flags as players for that week. Before recommending a start, sit, add or drop, read flags: never start a player flagged out or bye, warn on injured, and never suggest adding, dropping, starting or benching a locked player (his game has started or finished). Weeks with no games return an empty list. An unknown league is not_found. - [Nfl schedule](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/nfl_schedule): Sleeper's NFL schedule for one week: games with date and status (pre_game, in_game, complete, canceled) and kicked_off, the teams on bye that week, and every team's regular-season bye week. Sleeper gives game dates but no kickoff times. A season Sleeper has no schedule for is not_found. - [Nfl state](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/nfl_state): Sleeper's current NFL season, week and season_type (pre, regular, post, off). Every week-aware function defaults to this week. - [Players](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/players): NFL players by Sleeper id, trimmed from Sleeper's player map to what lineup decisions need: position, fantasy positions, team, status, injury_status and body part, depth chart, plus the week's bye, game, lock and flags. Before recommending a start, sit, add or drop, read flags: never start a player flagged out or bye, warn on injured, and never suggest adding, dropping, starting or benching a locked player (his game has started or finished). Ids Sleeper does not know are listed in missing_ids; if none are known the call is not_found. The full 15 MB player map is never returned. - [Transactions](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/transactions): Adds, drops, waiver claims and trades in one week of a Sleeper league, with status (complete or failed), the rosters involved, players added and dropped by roster and the FAAB bid. Weeks with none return an empty list. An unknown league is not_found. - [Trending players](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/trending_players): Players most added or dropped across all Sleeper leagues in the last lookback_hours, with counts and each player's injury, bye, lock and flags for the current week. Before recommending a start, sit, add or drop, read flags: never start a player flagged out or bye, warn on injured, and never suggest adding, dropping, starting or benching a locked player (his game has started or finished). ## 1. Choose this provider when Sleeper fantasy football from its public, keyless read API: NFL state, public leagues (settings, managers, rosters with starters, weekly matchups and transactions), NFL players trimmed from the player map, trending adds and drops, and the NFL schedule. Every player comes with injury status, bye week and whether his game has kicked off (locked), on rosters, matchup starters, player lookups and trending lists, so agents can avoid starting injured or bye-week players and never suggest moving a player whose game has started. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "sleeper-com", "capability": "fantasy-football-leagues/league", "options": { "league_id": "1383225688680583168" } } ``` ## 3. Add provider options Use only the options needed for the task: - `league_id` (string, required): Sleeper league id (digits), from a sleeper.com/leagues/ URL or the Sleeper app. Pattern: ^[0-9]{6,20}$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "sleeper-com", capability: "fantasy-football-leagues/league", options: { league_id: "1383225688680583168", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "sleeper-com", "capability": "fantasy-football-leagues/league", "options": { "league_id": "1383225688680583168" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "sleeper-com", "capability": "fantasy-football-leagues/league", "options": { "league_id": "1383225688680583168" } } }' ``` ### CLI ```sh firecrawl scrape 'sleeper-com/fantasy-football-leagues/league' \ --options '{"league_id":"1383225688680583168"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "sleeper-com", "capability": "fantasy-football-leagues/league", "options": { "league_id": "1383225688680583168" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "sleeper-com", "capability": "fantasy-football-leagues/league", "options": { "league_id": "1383225688680583168" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "draft_id": "1383225689943048192", "league_id": "1383225688680583168", "name": "#SFB16 - Forza", "observed_at_ms": 1792622184887, "previous_league_id": null, "roster_positions": [ "FLEX", "FLEX", "FLEX", "FLEX", "FLEX", "FLEX", "FLEX", "FLEX", "SUPER_FLEX", "SUPER_FLEX", "BN", "BN", "BN", "BN", "BN", "BN", "BN", "BN", "BN", "BN" ], "scoring_settings": { "blk_kick": 0, "bonus_fd_te": 1, "bonus_fd_wr": 0, "bonus_pass_yd_300": 10, "bonus_pass_yd_400": 20, "bonus_rec_rb": 0, "bonus_rec_te": 1, "bonus_rec_wr": 0, "bonus_rec_yd_100": 0, "bonus_rec_yd_200": 0, "bonus_rush_rec_yd_100": 10, "bonus_rush_rec_yd_200": 20, "bonus_rush_yd_100": 0, "bonus_rush_yd_200": 0, "bonus_sack_2p": 0, "bonus_tkl_10p": 0, "def_st_ff": 0, "def_st_fum_rec": 0, "def_st_td": 6, "def_td": 0, "ff": 0, "fgm_0_19": 0, "fgm_20_29": 0, "fgm_30_39": 0, "fgm_40_49": 0, "fgm_50p": 0, "fgm_yds": 0, "fgmiss": 0, "fum": 0, "fum_lost": 0, "fum_rec": 0, "fum_rec_td": 6, "int": 0, "kr_yd": 0, "pass_2pt": 2, "pass_cmp": 0, "pass_cmp_40p": 10, "pass_fd": 0, "pass_int": 0, "pass_td": 6, "pass_td_40p": 0, "pass_yd": 0.04, "pr_yd": 0, "pts_allow_0": 0, "pts_allow_14_20": 0, "pts_allow_1_6": 0, "pts_allow_21_27": 0, "pts_allow_28_34": 0, "pts_allow_35p": 0, "pts_allow_7_13": 0, "rec": 0.5, "rec_20_29": 10, "rec_2pt": 2, "rec_30_39": 10, "rec_40p": 10, "rec_fd": 0.5, "rec_td": 6, "rec_yd": 0.1, "rush_2pt": 2, "rush_40p": 10, "rush_att": 0, "rush_fd": 0.5, "rush_td": 6, "rush_yd": 0.1, "sack": 0, "safe": 0, "st_ff": 0, "st_fum_rec": 0, "st_td": 6, "st_tkl_solo": 0, "xpm": 0, "xpmiss": 0 }, "season": "2026", "season_type": "regular", "settings": { "bench_lock": 1, "best_ball": 0, "capacity_override": 0, "commissioner_direct_invite": 0, "daily_waivers": 1, "daily_waivers_days": 5888, "daily_waivers_hour": 8, "daily_waivers_last_ran": 21, "disable_adds": 0, "disable_trades": 0, "draft_rounds": 3, "faab_suggestions": 0, "last_report": 6, "last_scored_leg": 6, "league_average_match": 1, "leg": 7, "max_keepers": 1, "max_subs": 0, "num_teams": 12, "offseason_adds": 0, "pick_trading": 0, "playoff_round_type": 0, "playoff_seed_type": 0, "playoff_teams": 6, "playoff_type": 0, "playoff_week_start": 0, "reserve_allow_cov": 0, "reserve_allow_dnr": 0, "reserve_allow_doubtful": 0, "reserve_allow_na": 0, "reserve_allow_out": 0, "reserve_allow_sus": 0, "reserve_slots": 0, "start_week": 1, "sub_lock_if_starter_active": 0, "sub_start_time_eligibility": 0, "taxi_allow_vets": 0, "taxi_deadline": 0, "taxi_slots": 0, "taxi_years": 0, "trade_deadline": 9, "trade_review_days": 3, "type": 0, "veto_auto_poll": 0, "veto_show_votes": 0, "veto_votes_needed": 6, "waiver_bid_min": 0, "waiver_budget": 100, "waiver_clear_days": 0, "waiver_day_of_week": 2, "waiver_type": 2 }, "status": "in_season", "total_rosters": 12 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### League - Capability: `fantasy-football-leagues/league` - Description: One public Sleeper NFL league: name, season, status, team count, starting lineup slots (roster_positions), league settings (waivers, trade deadline, playoffs, reserve rules) and scoring settings. An unknown league is not_found. - Instructions: Learn a league's lineup slots and scoring before advising on it. - Cost: 5 credits per call - Capability file: [League](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/league) Accepted options: - `league_id` (string, required): Sleeper league id (digits), from a sleeper.com/leagues/ URL or the Sleeper app. Pattern: ^[0-9]{6,20}$. Example: `` Response schema example: ```json { "draft_id": "1383225689943048192", "league_id": "1383225688680583168", "name": "#SFB16 - Forza", "observed_at_ms": 1792622184887, "previous_league_id": null, "roster_positions": [ "FLEX", "FLEX", "FLEX", "FLEX", "FLEX", "FLEX", "FLEX", "FLEX", "SUPER_FLEX", "SUPER_FLEX", "BN", "BN", "BN", "BN", "BN", "BN", "BN", "BN", "BN", "BN" ], "scoring_settings": { "blk_kick": 0, "bonus_fd_te": 1, "bonus_fd_wr": 0, "bonus_pass_yd_300": 10, "bonus_pass_yd_400": 20, "bonus_rec_rb": 0, "bonus_rec_te": 1, "bonus_rec_wr": 0, "bonus_rec_yd_100": 0, "bonus_rec_yd_200": 0, "bonus_rush_rec_yd_100": 10, "bonus_rush_rec_yd_200": 20, "bonus_rush_yd_100": 0, "bonus_rush_yd_200": 0, "bonus_sack_2p": 0, "bonus_tkl_10p": 0, "def_st_ff": 0, "def_st_fum_rec": 0, "def_st_td": 6, "def_td": 0, "ff": 0, "fgm_0_19": 0, "fgm_20_29": 0, "fgm_30_39": 0, "fgm_40_49": 0, "fgm_50p": 0, "fgm_yds": 0, "fgmiss": 0, "fum": 0, "fum_lost": 0, "fum_rec": 0, "fum_rec_td": 6, "int": 0, "kr_yd": 0, "pass_2pt": 2, "pass_cmp": 0, "pass_cmp_40p": 10, "pass_fd": 0, "pass_int": 0, "pass_td": 6, "pass_td_40p": 0, "pass_yd": 0.04, "pr_yd": 0, "pts_allow_0": 0, "pts_allow_14_20": 0, "pts_allow_1_6": 0, "pts_allow_21_27": 0, "pts_allow_28_34": 0, "pts_allow_35p": 0, "pts_allow_7_13": 0, "rec": 0.5, "rec_20_29": 10, "rec_2pt": 2, "rec_30_39": 10, "rec_40p": 10, "rec_fd": 0.5, "rec_td": 6, "rec_yd": 0.1, "rush_2pt": 2, "rush_40p": 10, "rush_att": 0, "rush_fd": 0.5, "rush_td": 6, "rush_yd": 0.1, "sack": 0, "safe": 0, "st_ff": 0, "st_fum_rec": 0, "st_td": 6, "st_tkl_solo": 0, "xpm": 0, "xpmiss": 0 }, "season": "2026", "season_type": "regular", "settings": { "bench_lock": 1, "best_ball": 0, "capacity_override": 0, "commissioner_direct_invite": 0, "daily_waivers": 1, "daily_waivers_days": 5888, "daily_waivers_hour": 8, "daily_waivers_last_ran": 21, "disable_adds": 0, "disable_trades": 0, "draft_rounds": 3, "faab_suggestions": 0, "last_report": 6, "last_scored_leg": 6, "league_average_match": 1, "leg": 7, "max_keepers": 1, "max_subs": 0, "num_teams": 12, "offseason_adds": 0, "pick_trading": 0, "playoff_round_type": 0, "playoff_seed_type": 0, "playoff_teams": 6, "playoff_type": 0, "playoff_week_start": 0, "reserve_allow_cov": 0, "reserve_allow_dnr": 0, "reserve_allow_doubtful": 0, "reserve_allow_na": 0, "reserve_allow_out": 0, "reserve_allow_sus": 0, "reserve_slots": 0, "start_week": 1, "sub_lock_if_starter_active": 0, "sub_start_time_eligibility": 0, "taxi_allow_vets": 0, "taxi_deadline": 0, "taxi_slots": 0, "taxi_years": 0, "trade_deadline": 9, "trade_review_days": 3, "type": 0, "veto_auto_poll": 0, "veto_show_votes": 0, "veto_votes_needed": 6, "waiver_bid_min": 0, "waiver_budget": 100, "waiver_clear_days": 0, "waiver_day_of_week": 2, "waiver_type": 2 }, "status": "in_season", "total_rosters": 12 } ``` ### League rosters - Capability: `fantasy-football-leagues/league_rosters` - Description: Every roster in a Sleeper league (or one roster_id) with owner, record and every player: lineup slot (starter in slot order, bench, reserve, taxi), position, NFL team, injury_status and body part, bye week, this week's game and whether it has kicked off (locked), and flags summarising all of it. Before recommending a start, sit, add or drop, read flags: never start a player flagged out or bye, warn on injured, and never suggest adding, dropping, starting or benching a locked player (his game has started or finished). Weekly lineups come from Sleeper; starters reflect what the manager last set. An unknown league or roster_id is not_found. - Instructions: Lineup advice, start/sit, waiver and drop decisions for a team in a Sleeper league. - Cost: 5 credits per call - Capability file: [League rosters](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/league_rosters) Accepted options: - `league_id` (string, required): Sleeper league id (digits), from a sleeper.com/leagues/ URL or the Sleeper app. Pattern: ^[0-9]{6,20}$. Example: `` - `roster_id` (number): Only this roster (1 to total_rosters). One roster is faster than the whole league. Example: `10` - `week` (number): Regular-season NFL week 1-18 to check. Defaults to Sleeper's current NFL week. Example: `10` Response schema example: ```json { "league_id": "1383225688680583168", "observed_at_ms": 1792622184889, "rosters": [ { "co_owner_ids": [], "empty_starter_slots": 0, "losses": 3, "owner_display_name": "PiBK", "owner_id": "994769240152461312", "players": [ { "bye_week": 6, "depth_chart_order": 1, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610711", "home": true, "opponent": "GB", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Jahmyr Gibbs", "on_bye": false, "player_id": "9221", "position": "RB", "practice_participation": null, "slot": "starter", "starter_slot": 0, "status": "Active", "team": "DET", "week": 7, "years_exp": 3 }, { "bye_week": 11, "depth_chart_order": 4, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610711", "home": false, "opponent": "DET", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Josh Jacobs", "on_bye": false, "player_id": "5850", "position": "RB", "practice_participation": null, "slot": "starter", "starter_slot": 1, "status": "Active", "team": "GB", "week": 7, "years_exp": 7 }, { "bye_week": 5, "depth_chart_order": 1, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610705", "home": true, "opponent": "TB", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Chuba Hubbard", "on_bye": false, "player_id": "7594", "position": "RB", "practice_participation": null, "slot": "starter", "starter_slot": 2, "status": "Active", "team": "CAR", "week": 7, "years_exp": 5 }, { "bye_week": 11, "depth_chart_order": 4, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "injured", "out", "inactive" ], "game": { "date": "2026-10-25", "game_id": "202610730", "home": true, "opponent": "KC", "status": "pre_game" }, "injury_body_part": "Knee - ACL", "injury_start_date": null, "injury_status": "PUP", "locked": false, "name": "Zach Charbonnet", "on_bye": false, "player_id": "9753", "position": "RB", "practice_participation": null, "slot": "starter", "starter_slot": 3, "status": "Inactive", "team": "SEA", "week": 7, "years_exp": 3 }, { "bye_week": 9, "depth_chart_order": 1, "depth_chart_position": "RWR", "fantasy_positions": [ "WR" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610734", "home": true, "opponent": "CLE", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Carnell Tate", "on_bye": false, "player_id": "13279", "position": "WR", "practice_participation": null, "slot": "starter", "starter_slot": 4, "status": "Active", "team": "TEN", "week": 7, "years_exp": 0 }, { "bye_week": 6, "depth_chart_order": 2, "depth_chart_position": "RWR", "fantasy_positions": [ "WR" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610711", "home": true, "opponent": "GB", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Jameson Williams", "on_bye": false, "player_id": "8148", "position": "WR", "practice_participation": null, "slot": "starter", "starter_slot": 5, "status": "Active", "team": "DET", "week": 7, "years_exp": 4 }, { "bye_week": 14, "depth_chart_order": 1, "depth_chart_position": "LWR", "fantasy_positions": [ "WR" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610701", "home": true, "opponent": "DEN", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Michael Wilson", "on_bye": false, "player_id": "10232", "position": "WR", "practice_participation": null, "slot": "starter", "starter_slot": 6, "status": "Active", "team": "ARI", "week": 7, "years_exp": 3 }, { "bye_week": 8, "depth_chart_order": 1, "depth_chart_position": "TE", "fantasy_positions": [ "TE" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610702", "home": false, "opponent": "ATL", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "George Kittle", "on_bye": false, "player_id": "4217", "position": "TE", "practice_participation": null, "slot": "starter", "starter_slot": 7, "status": "Active", "team": "SF", "week": 7, "years_exp": 9 }, { "bye_week": 10, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610705", "home": false, "opponent": "CAR", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Jalon Daniels", "on_bye": false, "player_id": "13425", "position": "QB", "practice_participation": null, "slot": "starter", "starter_slot": 8, "status": "Active", "team": "TB", "week": 7, "years_exp": 0 }, { "bye_week": 11, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [ "injured" ], "game": { "date": "2026-10-25", "game_id": "202610711", "home": false, "opponent": "DET", "status": "pre_game" }, "injury_body_part": "Back", "injury_start_date": null, "injury_status": "Questionable", "locked": false, "name": "Jordan Love", "on_bye": false, "player_id": "6804", "position": "QB", "practice_participation": null, "slot": "starter", "starter_slot": 9, "status": "Active", "team": "GB", "week": 7, "years_exp": 6 }, { "bye_week": 11, "depth_chart_order": 1, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610734", "home": false, "opponent": "TEN", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Jaleel McLaughlin", "on_bye": false, "player_id": "11439", "position": "RB", "practice_participation": null, "slot": "bench", "status": "Active", "team": "CLE", "week": 7, "years_exp": 3 }, { "bye_week": 7, "depth_chart_order": 3, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "bye" ], "game": null, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Ray Davis", "on_bye": true, "player_id": "11575", "position": "RB", "practice_participation": null, "slot": "bench", "status": "Active", "team": "BUF", "week": 7, "years_exp": 2 }, { "bye_week": 5, "depth_chart_order": 4, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "injured", "out", "inactive" ], "game": { "date": "2026-10-25", "game_id": "202610705", "home": true, "opponent": "TB", "status": "pre_game" }, "injury_body_part": "Abdomen", "injury_start_date": null, "injury_status": "IR", "locked": false, "name": "Jonathon Brooks", "on_bye": false, "player_id": "11583", "position": "RB", "practice_participation": null, "slot": "bench", "status": "Inactive", "team": "CAR", "week": 7, "years_exp": 2 }, { "bye_week": 7, "depth_chart_order": 3, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "bye" ], "game": null, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Kimani Vidal", "on_bye": true, "player_id": "11647", "position": "RB", "practice_participation": null, "slot": "bench", "status": "Active", "team": "LAC", "week": 7, "years_exp": 2 }, { "bye_week": 14, "depth_chart_order": 3, "depth_chart_position": "SWR", "fantasy_positions": [ "WR" ], "flags": [], "game": { "date": "2026-10-26", "game_id": "202610726", "home": false, "opponent": "PHI", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Ryan Flournoy", "on_bye": false, "player_id": "11783", "position": "WR", "practice_participation": null, "slot": "bench", "status": "Active", "team": "DAL", "week": 7, "years_exp": 2 }, { "bye_week": 13, "depth_chart_order": 1, "depth_chart_position": "TE", "fantasy_positions": [ "TE" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610724", "home": true, "opponent": "MIA", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Kenyon Sadiq", "on_bye": false, "player_id": "13330", "position": "TE", "practice_participation": null, "slot": "bench", "status": "Active", "team": "NYJ", "week": 7, "years_exp": 0 }, { "bye_week": 10, "depth_chart_order": 2, "depth_chart_position": "LWR", "fantasy_positions": [ "WR" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610701", "home": false, "opponent": "ARI", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Courtland Sutton", "on_bye": false, "player_id": "5045", "position": "WR", "practice_participation": null, "slot": "bench", "status": "Active", "team": "DEN", "week": 7, "years_exp": 8 }, { "bye_week": 13, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610703", "home": true, "opponent": "CIN", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Tyler Huntley", "on_bye": false, "player_id": "7083", "position": "QB", "practice_participation": null, "slot": "bench", "status": "Active", "team": "BAL", "week": 7, "years_exp": 6 }, { "bye_week": 7, "depth_chart_order": 1, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "bye" ], "game": null, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "James Cook III", "on_bye": true, "player_id": "8138", "position": "RB", "practice_participation": null, "slot": "bench", "status": "Active", "team": "BUF", "week": 7, "years_exp": 4 }, { "bye_week": 11, "depth_chart_order": 2, "depth_chart_position": "SWR", "fantasy_positions": [ "WR" ], "flags": [], "game": { "date": "2026-10-22", "game_id": "202610706", "home": false, "opponent": "CHI", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "DeMario Douglas", "on_bye": false, "player_id": "9501", "position": "WR", "practice_participation": null, "slot": "bench", "status": "Active", "team": "NE", "week": 7, "years_exp": 3 } ], "points_against": 1183.56, "points_for": 1471.46, "roster_id": 1, "team_name": null, "ties": 0, "wins": 9 } ], "season": "2026", "season_type": "regular", "week": 7 } ``` ### League users - Capability: `fantasy-football-leagues/league_users` - Description: Managers in a Sleeper league: user id, display name, team name and whether they are a commissioner. Join to league_rosters by owner_id. An unknown league is not_found. - Instructions: Map a manager's name to their roster. - Cost: 5 credits per call - Capability file: [League users](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/league_users) Accepted options: - `league_id` (string, required): Sleeper league id (digits), from a sleeper.com/leagues/ URL or the Sleeper app. Pattern: ^[0-9]{6,20}$. Example: `` Response schema example: ```json { "league_id": "1383225688680583168", "observed_at_ms": 1792622184887, "users": [ { "display_name": "JPeekFF", "is_bot": false, "is_owner": true, "team_name": null, "user_id": "452692167064809472" }, { "display_name": "realdealfantasyhq", "is_bot": false, "is_owner": false, "team_name": "16 Personnel 📊", "user_id": "458831893421355008" }, { "display_name": "SPEEDZ", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "465304174070853632" }, { "display_name": "Meanswell11", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "571853347977863168" }, { "display_name": "Paeno", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "606979573942407168" }, { "display_name": "kaylechips", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "640073414542950400" }, { "display_name": "BigRich20", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "714205058178289664" }, { "display_name": "ScottFishBowl", "is_bot": false, "is_owner": true, "team_name": null, "user_id": "819245060922130432" }, { "display_name": "_MATTO_", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "833520972039598080" }, { "display_name": "Viperman84", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "846805868241592320" }, { "display_name": "LauraluvsTed", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "872704716528906240" }, { "display_name": "clementk6799", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "976596119377506304" }, { "display_name": "PiBK", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "994769240152461312" }, { "display_name": "Hkhotsskhotb", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "1111719573394464768" }, { "display_name": "00Topher00", "is_bot": false, "is_owner": false, "team_name": null, "user_id": "1378778467574755328" } ] } ``` ### Matchups - Capability: `fantasy-football-leagues/matchups` - Description: Head-to-head matchups for one week of a Sleeper league: each roster's matchup_id (rosters sharing it play each other), points, every player's points, and starters in lineup order with points and the same injury status, bye week, game, lock and flags as players for that week. Before recommending a start, sit, add or drop, read flags: never start a player flagged out or bye, warn on injured, and never suggest adding, dropping, starting or benching a locked player (his game has started or finished). Weeks with no games return an empty list. An unknown league is not_found. - Instructions: Scores, opponents and start/sit checks on a week's starting lineups. - Cost: 5 credits per call - Capability file: [Matchups](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/matchups) Accepted options: - `league_id` (string, required): Sleeper league id (digits), from a sleeper.com/leagues/ URL or the Sleeper app. Pattern: ^[0-9]{6,20}$. Example: `` - `week` (number, required): League week (leg). Example: `10` Response schema example: ```json { "league_id": "1383225688680583168", "matchups": [ { "matchup_id": 2, "players_points": { "4217": 31.9, "5045": 3.9, "5850": 0, "6804": 24.74, "7083": 15.4, "7594": 32.1, "8138": 56.8, "8148": 0, "9221": 0, "9753": 0, "10232": 6.2, "11439": 7.5, "11575": 1.9, "11583": 0, "11630": 0, "11647": 6.5, "11783": 14.5, "13279": 17.5, "13330": 4.2, "13425": 18.16 }, "points": 210.54, "roster_id": 1, "starters": [ { "bye_week": 5, "depth_chart_order": 1, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610626", "home": false, "opponent": "PHI", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Chuba Hubbard", "on_bye": false, "player_id": "7594", "points": 32.1, "position": "RB", "practice_participation": null, "status": "Active", "team": "CAR", "week": 6, "years_exp": 5 }, { "bye_week": 7, "depth_chart_order": 1, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610625", "home": false, "opponent": "LV", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "James Cook III", "on_bye": false, "player_id": "8138", "points": 56.8, "position": "RB", "practice_participation": null, "status": "Active", "team": "BUF", "week": 6, "years_exp": 4 }, { "bye_week": 8, "depth_chart_order": 1, "depth_chart_position": "TE", "fantasy_positions": [ "TE" ], "flags": [ "locked" ], "game": { "date": "2026-10-19", "game_id": "202610631", "home": true, "opponent": "WAS", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "George Kittle", "on_bye": false, "player_id": "4217", "points": 31.9, "position": "TE", "practice_participation": null, "status": "Active", "team": "SF", "week": 6, "years_exp": 9 }, { "bye_week": 14, "depth_chart_order": 1, "depth_chart_position": "LWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610632", "home": false, "opponent": "LAR", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Michael Wilson", "on_bye": false, "player_id": "10232", "points": 6.2, "position": "WR", "practice_participation": null, "status": "Active", "team": "ARI", "week": 6, "years_exp": 3 }, { "bye_week": 9, "depth_chart_order": 1, "depth_chart_position": "RWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610614", "home": false, "opponent": "IND", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Carnell Tate", "on_bye": false, "player_id": "13279", "points": 17.5, "position": "WR", "practice_participation": null, "status": "Active", "team": "TEN", "week": 6, "years_exp": 0 }, { "bye_week": 14, "depth_chart_order": 3, "depth_chart_position": "SWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610612", "home": false, "opponent": "GB", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Ryan Flournoy", "on_bye": false, "player_id": "11783", "points": 14.5, "position": "WR", "practice_participation": null, "status": "Active", "team": "DAL", "week": 6, "years_exp": 2 }, { "bye_week": 10, "depth_chart_order": 2, "depth_chart_position": "LWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-15", "game_id": "202610610", "home": true, "opponent": "SEA", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Courtland Sutton", "on_bye": false, "player_id": "5045", "points": 3.9, "position": "WR", "practice_participation": null, "status": "Active", "team": "DEN", "week": 6, "years_exp": 8 }, { "bye_week": 11, "depth_chart_order": 3, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610608", "home": true, "opponent": "BAL", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Jaleel McLaughlin", "on_bye": false, "player_id": "11439", "points": 7.5, "position": "RB", "practice_participation": null, "status": "Active", "team": "CLE", "week": 6, "years_exp": 3 }, { "bye_week": 13, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610608", "home": false, "opponent": "CLE", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Tyler Huntley", "on_bye": false, "player_id": "7083", "points": 15.4, "position": "QB", "practice_participation": null, "status": "Active", "team": "BAL", "week": 6, "years_exp": 6 }, { "bye_week": 11, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610612", "home": true, "opponent": "DAL", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Jordan Love", "on_bye": false, "player_id": "6804", "points": 24.74, "position": "QB", "practice_participation": null, "status": "Active", "team": "GB", "week": 6, "years_exp": 6 } ] }, { "matchup_id": 6, "players_points": { "96": 22.02, "1479": 14.2, "2449": 14.4, "3163": 0, "4035": 24.9, "4943": 25.52, "4950": 0, "4983": 0, "5859": 4.7, "5927": 13.7, "8167": 29.4, "9500": 18.2, "10213": 45.2, "10229": 0, "11604": 27.5, "12501": 61.4, "12545": 33.96, "13317": 16.5, "13346": 2.5, "13413": 14.2 }, "points": 213.38, "roster_id": 2, "starters": [ { "bye_week": 7, "depth_chart_order": 6, "depth_chart_position": "LWR", "fantasy_positions": [ "WR" ], "flags": [ "injured", "out", "locked" ], "game": { "date": "2026-10-18", "game_id": "202610625", "home": false, "opponent": "LV", "status": "complete" }, "injury_body_part": "Shoulder - AC Joint", "injury_start_date": null, "injury_status": "Out", "locked": true, "name": "DJ Moore", "on_bye": false, "player_id": "4983", "points": 0, "position": "WR", "practice_participation": null, "status": "Active", "team": "BUF", "week": 6, "years_exp": 8 }, { "bye_week": 11, "depth_chart_order": 2, "depth_chart_position": "RWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610612", "home": true, "opponent": "DAL", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Matthew Golden", "on_bye": false, "player_id": "12501", "points": 61.4, "position": "WR", "practice_participation": null, "status": "Active", "team": "GB", "week": 6, "years_exp": 1 }, { "bye_week": 11, "depth_chart_order": 1, "depth_chart_position": "LWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610608", "home": true, "opponent": "BAL", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Denzel Boston", "on_bye": false, "player_id": "13346", "points": 2.5, "position": "WR", "practice_participation": null, "status": "Active", "team": "CLE", "week": 6, "years_exp": 0 }, { "bye_week": 13, "depth_chart_order": 1, "depth_chart_position": "TE", "fantasy_positions": [ "TE" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610625", "home": true, "opponent": "BUF", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Brock Bowers", "on_bye": false, "player_id": "11604", "points": 27.5, "position": "TE", "practice_participation": null, "status": "Active", "team": "LV", "week": 6, "years_exp": 2 }, { "bye_week": 11, "depth_chart_order": 1, "depth_chart_position": "LWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610621", "home": true, "opponent": "NYJ", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "A.J. Brown", "on_bye": false, "player_id": "5859", "points": 4.7, "position": "WR", "practice_participation": null, "status": "Active", "team": "NE", "week": 6, "years_exp": 7 }, { "bye_week": 11, "depth_chart_order": 1, "depth_chart_position": "LWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610612", "home": true, "opponent": "DAL", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Christian Watson", "on_bye": false, "player_id": "8167", "points": 29.4, "position": "WR", "practice_participation": null, "status": "Active", "team": "GB", "week": 6, "years_exp": 4 }, { "bye_week": 13, "depth_chart_order": 2, "depth_chart_position": "SWR", "fantasy_positions": [ "WR" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610614", "home": true, "opponent": "TEN", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Josh Downs", "on_bye": false, "player_id": "9500", "points": 18.2, "position": "WR", "practice_participation": null, "status": "Active", "team": "IND", "week": 6, "years_exp": 3 }, { "bye_week": 7, "depth_chart_order": 1, "depth_chart_position": null, "fantasy_positions": [ "WR" ], "flags": [ "injured", "out", "locked" ], "game": { "date": "2026-10-19", "game_id": "202610631", "home": false, "opponent": "SF", "status": "complete" }, "injury_body_part": "Knee", "injury_start_date": null, "injury_status": "Out", "locked": true, "name": "Terry McLaurin", "on_bye": false, "player_id": "5927", "points": 13.7, "position": "WR", "practice_participation": null, "status": "Active", "team": "WAS", "week": 6, "years_exp": 7 }, { "bye_week": 9, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610633", "home": false, "opponent": "TB", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Aaron Rodgers", "on_bye": false, "player_id": "96", "points": 22.02, "position": "QB", "practice_participation": null, "status": "Active", "team": "PIT", "week": 6, "years_exp": 21 }, { "bye_week": 8, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [ "locked" ], "game": { "date": "2026-10-18", "game_id": "202610623", "home": false, "opponent": "NYG", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Tyler Shough", "on_bye": false, "player_id": "12545", "points": 33.96, "position": "QB", "practice_participation": null, "status": "Active", "team": "NO", "week": 6, "years_exp": 1 } ] } ], "observed_at_ms": 1793022062501, "season": "2026", "week": 6 } ``` ### Nfl schedule - Capability: `fantasy-football-leagues/nfl_schedule` - Description: Sleeper's NFL schedule for one week: games with date and status (pre_game, in_game, complete, canceled) and kicked_off, the teams on bye that week, and every team's regular-season bye week. Sleeper gives game dates but no kickoff times. A season Sleeper has no schedule for is not_found. - Instructions: Bye weeks, and whether a team's game has started. - Cost: 5 credits per call - Capability file: [Nfl schedule](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/nfl_schedule) Accepted options: - `season` (string): Season year, default the current one. Pattern: ^20[0-9]{2}$. Example: `` - `week` (number): Regular-season NFL week 1-18 to check. Defaults to Sleeper's current NFL week. Example: `10` Response schema example: ```json { "bye_teams": [ "BUF", "JAX", "LAC", "WAS" ], "games": [ { "away": "DEN", "date": "2026-10-25", "game_id": "202610701", "home": "ARI", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "SF", "date": "2026-10-25", "game_id": "202610702", "home": "ATL", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "CIN", "date": "2026-10-25", "game_id": "202610703", "home": "BAL", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "TB", "date": "2026-10-25", "game_id": "202610705", "home": "CAR", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "NE", "date": "2026-10-22", "game_id": "202610706", "home": "CHI", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "GB", "date": "2026-10-25", "game_id": "202610711", "home": "DET", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "NYG", "date": "2026-10-25", "game_id": "202610713", "home": "HOU", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "IND", "date": "2026-10-25", "game_id": "202610720", "home": "MIN", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "PIT", "date": "2026-10-25", "game_id": "202610722", "home": "NO", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "MIA", "date": "2026-10-25", "game_id": "202610724", "home": "NYJ", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "LAR", "date": "2026-10-25", "game_id": "202610725", "home": "LV", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "DAL", "date": "2026-10-26", "game_id": "202610726", "home": "PHI", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "KC", "date": "2026-10-25", "game_id": "202610730", "home": "SEA", "kicked_off": false, "status": "pre_game", "week": 7 }, { "away": "CLE", "date": "2026-10-25", "game_id": "202610734", "home": "TEN", "kicked_off": false, "status": "pre_game", "week": 7 } ], "observed_at_ms": 1792622184892, "season": "2026", "season_type": "regular", "team_bye_weeks": [ { "bye_week": 14, "team": "ARI" }, { "bye_week": 11, "team": "ATL" }, { "bye_week": 13, "team": "BAL" }, { "bye_week": 7, "team": "BUF" }, { "bye_week": 5, "team": "CAR" }, { "bye_week": 10, "team": "CHI" }, { "bye_week": 6, "team": "CIN" }, { "bye_week": 11, "team": "CLE" }, { "bye_week": 14, "team": "DAL" }, { "bye_week": 10, "team": "DEN" }, { "bye_week": 6, "team": "DET" }, { "bye_week": 11, "team": "GB" }, { "bye_week": 8, "team": "HOU" }, { "bye_week": 13, "team": "IND" }, { "bye_week": 7, "team": "JAX" }, { "bye_week": 5, "team": "KC" }, { "bye_week": 7, "team": "LAC" }, { "bye_week": 11, "team": "LAR" }, { "bye_week": 13, "team": "LV" }, { "bye_week": 6, "team": "MIA" }, { "bye_week": 6, "team": "MIN" }, { "bye_week": 11, "team": "NE" }, { "bye_week": 8, "team": "NO" }, { "bye_week": 8, "team": "NYG" }, { "bye_week": 13, "team": "NYJ" }, { "bye_week": 10, "team": "PHI" }, { "bye_week": 9, "team": "PIT" }, { "bye_week": 11, "team": "SEA" }, { "bye_week": 8, "team": "SF" }, { "bye_week": 10, "team": "TB" }, { "bye_week": 9, "team": "TEN" }, { "bye_week": 7, "team": "WAS" } ], "week": 7 } ``` ### Nfl state - Capability: `fantasy-football-leagues/nfl_state` - Description: Sleeper's current NFL season, week and season_type (pre, regular, post, off). Every week-aware function defaults to this week. - Instructions: Find the current week before asking for matchups, transactions or lineup advice. - Cost: 5 credits per call - Capability file: [Nfl state](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/nfl_state) Accepted options: Response schema example: ```json { "display_week": 7, "league_season": "2026", "observed_at_ms": 1792622184886, "previous_season": "2025", "season": "2026", "season_start_date": "2026-09-09", "season_type": "regular", "week": 7 } ``` ### Players - Capability: `fantasy-football-leagues/players` - Description: NFL players by Sleeper id, trimmed from Sleeper's player map to what lineup decisions need: position, fantasy positions, team, status, injury_status and body part, depth chart, plus the week's bye, game, lock and flags. Before recommending a start, sit, add or drop, read flags: never start a player flagged out or bye, warn on injured, and never suggest adding, dropping, starting or benching a locked player (his game has started or finished). Ids Sleeper does not know are listed in missing_ids; if none are known the call is not_found. The full 15 MB player map is never returned. - Instructions: Check specific players before recommending them. - Cost: 5 credits per call - Capability file: [Players](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/players) Accepted options: - `player_ids` (string[], required): Sleeper player ids (team abbreviation for a defense), as returned by league_rosters, matchups or transactions. Example: `[]` - `season` (string): Season year for the week, default the current one. Pattern: ^20[0-9]{2}$. Example: `` - `week` (number): Regular-season NFL week 1-18 to check. Defaults to Sleeper's current NFL week. Example: `10` Response schema example: ```json { "missing_ids": [], "observed_at_ms": 1793022061157, "players": [ { "bye_week": 6, "depth_chart_order": 5, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [ "injured", "out", "locked", "inactive" ], "game": { "date": "2026-10-25", "game_id": "202610724", "home": false, "opponent": "NYJ", "status": "complete" }, "injury_body_part": "Knee - ACL", "injury_start_date": null, "injury_status": "IR", "locked": true, "name": "De'Von Achane", "on_bye": false, "player_id": "9226", "position": "RB", "practice_participation": null, "status": "Inactive", "team": "MIA", "week": 7, "years_exp": 3 }, { "bye_week": 7, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [ "bye" ], "game": null, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Josh Allen", "on_bye": true, "player_id": "4984", "position": "QB", "practice_participation": null, "status": "Active", "team": "BUF", "week": 7, "years_exp": 8 }, { "bye_week": 5, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [ "locked" ], "game": { "date": "2026-10-25", "game_id": "202610730", "home": false, "opponent": "SEA", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Patrick Mahomes", "on_bye": false, "player_id": "4046", "position": "QB", "practice_participation": null, "status": "Active", "team": "KC", "week": 7, "years_exp": 9 }, { "bye_week": 6, "depth_chart_order": null, "depth_chart_position": null, "fantasy_positions": [ "DEF" ], "flags": [ "locked" ], "game": { "date": "2026-10-25", "game_id": "202610724", "home": false, "opponent": "NYJ", "status": "complete" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": true, "name": "Miami Dolphins", "on_bye": false, "player_id": "MIA", "position": "DEF", "practice_participation": null, "status": null, "team": "MIA", "week": 7, "years_exp": null }, { "bye_week": 7, "depth_chart_order": null, "depth_chart_position": null, "fantasy_positions": [ "DEF" ], "flags": [ "bye" ], "game": null, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Buffalo Bills", "on_bye": true, "player_id": "BUF", "position": "DEF", "practice_participation": null, "status": null, "team": "BUF", "week": 7, "years_exp": null } ], "season": "2026", "season_type": "regular", "week": 7 } ``` ### Transactions - Capability: `fantasy-football-leagues/transactions` - Description: Adds, drops, waiver claims and trades in one week of a Sleeper league, with status (complete or failed), the rosters involved, players added and dropped by roster and the FAAB bid. Weeks with none return an empty list. An unknown league is not_found. - Instructions: See who was picked up or dropped, or which waiver claims failed. - Cost: 5 credits per call - Capability file: [Transactions](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/transactions) Accepted options: - `league_id` (string, required): Sleeper league id (digits), from a sleeper.com/leagues/ URL or the Sleeper app. Pattern: ^[0-9]{6,20}$. Example: `` - `week` (number, required): League week (leg). Example: `10` Response schema example: ```json { "league_id": "1383225688680583168", "observed_at_ms": 1792622184891, "transactions": [ { "adds": [ { "player_id": "9501", "roster_id": 1 } ], "created_ms": 1792542493190, "draft_pick_count": 0, "drops": [ { "player_id": "11630", "roster_id": 1 } ], "roster_ids": [ 1 ], "status": "complete", "status_updated_ms": 1792595124450, "transaction_id": "1418429659145609216", "type": "waiver", "waiver_bid": 2 }, { "adds": [ { "player_id": "12718", "roster_id": 11 } ], "created_ms": 1792473341616, "draft_pick_count": 0, "drops": [ { "player_id": "13264", "roster_id": 11 } ], "roster_ids": [ 11 ], "status": "complete", "status_updated_ms": 1792595124450, "transaction_id": "1418139616422252544", "type": "waiver", "waiver_bid": 0 }, { "adds": [ { "player_id": "11439", "roster_id": 1 } ], "created_ms": 1792338370808, "draft_pick_count": 0, "drops": [ { "player_id": "12491", "roster_id": 1 } ], "roster_ids": [ 1 ], "status": "complete", "status_updated_ms": 1792338370808, "transaction_id": "1417573507818090496", "type": "free_agent", "waiver_bid": null }, { "adds": [ { "player_id": "2197", "roster_id": 10 } ], "created_ms": 1792196973757, "draft_pick_count": 0, "drops": [ { "player_id": "6819", "roster_id": 10 } ], "roster_ids": [ 10 ], "status": "complete", "status_updated_ms": 1792196973757, "transaction_id": "1416980445601480704", "type": "free_agent", "waiver_bid": null }, { "adds": [ { "player_id": "9230", "roster_id": 6 } ], "created_ms": 1792106342368, "draft_pick_count": 0, "drops": [], "roster_ids": [ 6 ], "status": "complete", "status_updated_ms": 1792106342368, "transaction_id": "1416600310004137984", "type": "free_agent", "waiver_bid": null }, { "adds": [], "created_ms": 1792106333867, "draft_pick_count": 0, "drops": [ { "player_id": "7090", "roster_id": 6 } ], "roster_ids": [ 6 ], "status": "complete", "status_updated_ms": 1792106333867, "transaction_id": "1416600274352525312", "type": "free_agent", "waiver_bid": null }, { "adds": [ { "player_id": "13276", "roster_id": 6 } ], "created_ms": 1792106273877, "draft_pick_count": 0, "drops": [ { "player_id": "12492", "roster_id": 6 } ], "roster_ids": [ 6 ], "status": "complete", "status_updated_ms": 1792106273877, "transaction_id": "1416600022736175104", "type": "free_agent", "waiver_bid": null }, { "adds": [ { "player_id": "13420", "roster_id": 3 } ], "created_ms": 1792021253437, "draft_pick_count": 0, "drops": [ { "player_id": "12544", "roster_id": 3 } ], "roster_ids": [ 3 ], "status": "complete", "status_updated_ms": 1792021253437, "transaction_id": "1416243421160439808", "type": "free_agent", "waiver_bid": null }, { "adds": [ { "player_id": "12503", "roster_id": 7 } ], "created_ms": 1792011134685, "draft_pick_count": 0, "drops": [ { "player_id": "11577", "roster_id": 7 } ], "roster_ids": [ 7 ], "status": "complete", "status_updated_ms": 1792011134685, "transaction_id": "1416200980038459392", "type": "free_agent", "waiver_bid": null } ], "week": 6 } ``` ### Trending players - Capability: `fantasy-football-leagues/trending_players` - Description: Players most added or dropped across all Sleeper leagues in the last lookback_hours, with counts and each player's injury, bye, lock and flags for the current week. Before recommending a start, sit, add or drop, read flags: never start a player flagged out or bye, warn on injured, and never suggest adding, dropping, starting or benching a locked player (his game has started or finished). - Instructions: Waiver-wire ideas; check the flags before suggesting a pickup. - Cost: 5 credits per call - Capability file: [Trending players](https://alexandria.firecrawl.dev/agents/providers/sleeper-com/fantasy-football-leagues/trending_players) Accepted options: - `limit` (number): Default 10. Example: `10` - `lookback_hours` (number): Default 24. Example: `10` - `type` (string, required): add or drop. Example: `add` Response schema example: ```json { "lookback_hours": 24, "observed_at_ms": 1792622184892, "players": [ { "bye_week": 13, "count": 3083920, "depth_chart_order": 4, "depth_chart_position": "SWR", "fantasy_positions": [ "WR" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610724", "home": true, "opponent": "MIA", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Omar Cooper Jr.", "on_bye": false, "player_id": "13276", "position": "WR", "practice_participation": null, "status": "Active", "team": "NYJ", "week": 7, "years_exp": 0 }, { "bye_week": 11, "count": 1464575, "depth_chart_order": null, "depth_chart_position": null, "fantasy_positions": [ "DEF" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610734", "home": false, "opponent": "TEN", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Cleveland Browns", "on_bye": false, "player_id": "CLE", "position": "DEF", "practice_participation": null, "status": null, "team": "CLE", "week": 7, "years_exp": null }, { "bye_week": 11, "count": 1214082, "depth_chart_order": 2, "depth_chart_position": "SWR", "fantasy_positions": [ "WR" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610725", "home": false, "opponent": "LV", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Konata Mumpfield", "on_bye": false, "player_id": "12718", "position": "WR", "practice_participation": null, "status": "Active", "team": "LAR", "week": 7, "years_exp": 1 }, { "bye_week": 10, "count": 914880, "depth_chart_order": 2, "depth_chart_position": "RB", "fantasy_positions": [ "RB" ], "flags": [], "game": { "date": "2026-10-22", "game_id": "202610706", "home": true, "opponent": "NE", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Roschon Johnson", "on_bye": false, "player_id": "10235", "position": "RB", "practice_participation": null, "status": "Active", "team": "CHI", "week": 7, "years_exp": 3 }, { "bye_week": 13, "count": 700875, "depth_chart_order": 2, "depth_chart_position": "TE", "fantasy_positions": [ "TE" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610725", "home": true, "opponent": "LAR", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Michael Mayer", "on_bye": false, "player_id": "9482", "position": "TE", "practice_participation": null, "status": "Active", "team": "LV", "week": 7, "years_exp": 3 } ], "season": "2026", "type": "add", "week": 7 } ```