--- 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), so agents can avoid starting injured or bye-week players and suggesting drops Sleeper will refuse." 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), so agents can avoid starting injured or bye-week players and suggesting drops Sleeper will refuse." 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), so agents can avoid starting injured or bye-week players and suggesting drops Sleeper will refuse. - Categories: Sports - Category index: [Sports category](https://firecrawl.dev/alexandria/agents/categories/sports) - Provider key: `sleeper-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/sleeper-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/sleeper-com/openapi.json) ## Capabilities - [League](https://firecrawl.dev/alexandria/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://firecrawl.dev/alexandria/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 benching or dropping a locked player. Weekly lineups come from Sleeper; starters reflect what the manager last set. An unknown league or roster_id is not_found. - [League users](https://firecrawl.dev/alexandria/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://firecrawl.dev/alexandria/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, starters with their points and every player's points. Weeks with no games return an empty list. An unknown league is not_found. - [Nfl schedule](https://firecrawl.dev/alexandria/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://firecrawl.dev/alexandria/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://firecrawl.dev/alexandria/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 benching or dropping a locked player. 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://firecrawl.dev/alexandria/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://firecrawl.dev/alexandria/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 benching or dropping a locked player. ## 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), so agents can avoid starting injured or bye-week players and suggesting drops Sleeper will refuse. ## 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://firecrawl.dev/alexandria/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 benching or dropping a locked player. 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://firecrawl.dev/alexandria/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://firecrawl.dev/alexandria/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, starters with their points and every player's points. Weeks with no games return an empty list. An unknown league is not_found. - Instructions: Scores and opponents for a given week. - Cost: 5 credits per call - Capability file: [Matchups](https://firecrawl.dev/alexandria/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": [ { "player_id": "7594", "points": 32.1 }, { "player_id": "8138", "points": 56.8 }, { "player_id": "4217", "points": 31.9 }, { "player_id": "10232", "points": 6.2 }, { "player_id": "13279", "points": 17.5 }, { "player_id": "11783", "points": 14.5 }, { "player_id": "5045", "points": 3.9 }, { "player_id": "11439", "points": 7.5 }, { "player_id": "7083", "points": 15.4 }, { "player_id": "6804", "points": 24.74 } ] }, { "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": [ { "player_id": "4983", "points": 0 }, { "player_id": "12501", "points": 61.4 }, { "player_id": "13346", "points": 2.5 }, { "player_id": "11604", "points": 27.5 }, { "player_id": "5859", "points": 4.7 }, { "player_id": "8167", "points": 29.4 }, { "player_id": "9500", "points": 18.2 }, { "player_id": "5927", "points": 13.7 }, { "player_id": "96", "points": 22.02 }, { "player_id": "12545", "points": 33.96 } ] }, { "matchup_id": 2, "players_points": { "421": 30.88, "5892": 0, "7525": 18, "7547": 0, "7567": 3.9, "8150": 10.7, "8161": 0, "8180": 1.9, "8228": 11.3, "9482": 39, "11560": 29, "11576": 25.4, "11581": 1, "11620": 16.9, "11628": 6.4, "11637": 25.4, "12527": 15.3, "13288": 0, "13311": 0, "13420": 8.4 }, "points": 169.78, "roster_id": 3, "starters": [ { "player_id": "7567", "points": 3.9 }, { "player_id": "12527", "points": 15.3 }, { "player_id": "8150", "points": 10.7 }, { "player_id": "11576", "points": 25.4 }, { "player_id": "11581", "points": 1 }, { "player_id": "11637", "points": 25.4 }, { "player_id": "11620", "points": 16.9 }, { "player_id": "8228", "points": 11.3 }, { "player_id": "11560", "points": 29 }, { "player_id": "421", "points": 30.88 } ] }, { "matchup_id": 4, "players_points": { "1166": 44.52, "2306": 13.48, "3257": 9.42, "4034": 40.2, "4892": 0, "5022": 19.6, "7021": 7.9, "7523": 47.34, "8137": 22.8, "9486": 4.4, "9487": 19.9, "9488": 43.4, "11610": 0, "12472": 0, "12490": 34.2, "12514": 14.8, "12534": 0, "13285": 3.4, "13296": 0, "13417": 0 }, "points": 294.66, "roster_id": 4, "starters": [ { "player_id": "9488", "points": 43.4 }, { "player_id": "4034", "points": 40.2 }, { "player_id": "8137", "points": 22.8 }, { "player_id": "12514", "points": 14.8 }, { "player_id": "12490", "points": 34.2 }, { "player_id": "7021", "points": 7.9 }, { "player_id": "5022", "points": 19.6 }, { "player_id": "9487", "points": 19.9 }, { "player_id": "7523", "points": 47.34 }, { "player_id": "1166", "points": 44.52 } ] }, { "matchup_id": 1, "players_points": { "1466": 25.8, "3161": 0, "4046": 12.98, "4199": 0, "4866": 0, "7828": 21.3, "8112": 21.2, "8129": 15, "8131": 62.9, "8408": 0, "9228": 23.84, "9493": 22, "9997": 20.7, "10236": 15.8, "11608": 0.9, "12481": 0, "12497": 2.3, "13293": 8, "13294": 3.9, "13298": 6.9 }, "points": 220.22, "roster_id": 5, "starters": [ { "player_id": "9493", "points": 22 }, { "player_id": "8112", "points": 21.2 }, { "player_id": "9997", "points": 20.7 }, { "player_id": "1466", "points": 25.8 }, { "player_id": "8129", "points": 15 }, { "player_id": "8131", "points": 62.9 }, { "player_id": "12481", "points": 0 }, { "player_id": "10236", "points": 15.8 }, { "player_id": "4046", "points": 12.98 }, { "player_id": "9228", "points": 23.84 } ] }, { "matchup_id": 1, "players_points": { "2505": 0, "3198": 8, "3321": 0, "4663": 1.7, "5849": 0, "6770": 0, "6813": 45.6, "8155": 0, "9230": 14.6, "9511": 0.4, "9758": 60.98, "11584": 6.9, "11586": 14.5, "11834": 6.2, "12487": 0, "12506": 2.4, "12512": 0, "12533": 0, "13276": 40.3, "13286": 0 }, "points": 159.58, "roster_id": 6, "starters": [ { "player_id": "6813", "points": 45.6 }, { "player_id": "3198", "points": 8 }, { "player_id": "11586", "points": 14.5 }, { "player_id": "9511", "points": 0.4 }, { "player_id": "11584", "points": 6.9 }, { "player_id": "11834", "points": 6.2 }, { "player_id": "2505", "points": 0 }, { "player_id": "12506", "points": 2.4 }, { "player_id": "9230", "points": 14.6 }, { "player_id": "9758", "points": 60.98 } ] }, { "matchup_id": 3, "players_points": { "1373": 25.98, "2216": 32.4, "3294": 17.02, "4881": 0, "5012": 3.4, "5846": 17.3, "6786": 13.5, "6865": 18.1, "7526": 4.4, "8172": 0, "9480": 26.4, "9756": 0, "9757": 9, "11571": 3.6, "12503": 0, "12507": 6.4, "12522": 10.78, "12536": 50.2, "13414": 5.2, "13421": 4.1 }, "points": 140.6, "roster_id": 7, "starters": [ { "player_id": "6786", "points": 13.5 }, { "player_id": "12507", "points": 6.4 }, { "player_id": "7526", "points": 4.4 }, { "player_id": "2216", "points": 32.4 }, { "player_id": "5846", "points": 17.3 }, { "player_id": "5012", "points": 3.4 }, { "player_id": "9757", "points": 9 }, { "player_id": "9480", "points": 26.4 }, { "player_id": "12522", "points": 10.78 }, { "player_id": "3294", "points": 17.02 } ] }, { "matchup_id": 4, "players_points": { "2133": 6.9, "5967": 9.6, "6790": 22.5, "6797": 21.26, "6904": 0, "7002": 0, "8676": 22.3, "9479": 14.5, "9509": 6.8, "11435": 7.7, "11565": 40.82, "11635": 2.7, "12493": 6.2, "12499": 0.8, "12524": 0, "12542": 0, "13281": 0, "13287": 0, "13301": 18, "13337": 3.9 }, "points": 79.86, "roster_id": 8, "starters": [ { "player_id": "9509", "points": 6.8 }, { "player_id": "13337", "points": 3.9 }, { "player_id": "11635", "points": 2.7 }, { "player_id": "2133", "points": 6.9 }, { "player_id": "6790", "points": 22.5 }, { "player_id": "12493", "points": 6.2 }, { "player_id": "7002", "points": 0 }, { "player_id": "5967", "points": 9.6 }, { "player_id": "6797", "points": 21.26 }, { "player_id": "12542", "points": 0 } ] }, { "matchup_id": 5, "players_points": { "3271": 8.2, "3634": 3.3, "4037": 7.2, "4039": 9, "7553": 38.5, "7611": 5.1, "8110": 4.3, "8111": 3.4, "8130": 31.8, "8132": 6.8, "8134": 11.9, "8144": 13.3, "8146": 7.9, "8154": 2, "11566": 35, "11618": 0, "12489": 15.1, "12509": 0, "13269": 0, "13274": 22.2 }, "points": 180.7, "roster_id": 9, "starters": [ { "player_id": "8130", "points": 31.8 }, { "player_id": "8144", "points": 13.3 }, { "player_id": "8146", "points": 7.9 }, { "player_id": "7611", "points": 5.1 }, { "player_id": "8132", "points": 6.8 }, { "player_id": "13274", "points": 22.2 }, { "player_id": "3271", "points": 8.2 }, { "player_id": "8134", "points": 11.9 }, { "player_id": "7553", "points": 38.5 }, { "player_id": "11566", "points": 35 } ] }, { "matchup_id": 5, "players_points": { "2197": 2.3, "4017": 9.96, "4454": 8.7, "4984": 22.8, "5844": 0, "5872": 0, "5947": 32.8, "6806": 12.6, "7600": 5.6, "8121": 20.7, "8210": 31.9, "9484": 14.2, "10219": 7.5, "10859": 0, "11563": 4.48, "11646": 24.7, "12495": 0, "12517": 23, "12518": 0, "13150": 1.4 }, "points": 179.86, "roster_id": 10, "starters": [ { "player_id": "7600", "points": 5.6 }, { "player_id": "2197", "points": 2.3 }, { "player_id": "9484", "points": 14.2 }, { "player_id": "8210", "points": 31.9 }, { "player_id": "11646", "points": 24.7 }, { "player_id": "5947", "points": 32.8 }, { "player_id": "6806", "points": 12.6 }, { "player_id": "12517", "points": 23 }, { "player_id": "4984", "points": 22.8 }, { "player_id": "4017", "points": 9.96 } ] }, { "matchup_id": 6, "players_points": { "1339": 0, "4993": 0, "5001": 10.8, "6801": 0, "7564": 0, "7569": 30.9, "7571": 0, "8136": 14.2, "8142": 0, "8183": 31.36, "9508": 1.8, "11559": 41.1, "11603": 6.1, "11631": 0, "11632": 56, "11643": 0, "12502": 0, "12526": 33.1, "12529": 5, "13264": 0 }, "points": 222.46, "roster_id": 11, "starters": [ { "player_id": "12526", "points": 33.1 }, { "player_id": "12529", "points": 5 }, { "player_id": "11632", "points": 56 }, { "player_id": "11631", "points": 0 }, { "player_id": "7571", "points": 0 }, { "player_id": "8136", "points": 14.2 }, { "player_id": "7569", "points": 30.9 }, { "player_id": "5001", "points": 10.8 }, { "player_id": "8183", "points": 31.36 }, { "player_id": "11559", "points": 41.1 } ] }, { "matchup_id": 3, "players_points": { "3214": 21.3, "5870": 19.76, "6794": 0, "7543": 0, "7588": 13.5, "8126": 4.2, "8127": 8, "8151": 39.9, "9224": 0, "9504": 3.1, "9754": 16.7, "11564": 40.3, "11624": 12.3, "11625": 0, "12048": 8.5, "12474": 10.1, "12498": 10.8, "12519": 34.5, "13305": 6.5, "13345": 0 }, "points": 152.16, "roster_id": 12, "starters": [ { "player_id": "12048", "points": 8.5 }, { "player_id": "9224", "points": 0 }, { "player_id": "6794", "points": 0 }, { "player_id": "8126", "points": 4.2 }, { "player_id": "7588", "points": 13.5 }, { "player_id": "12519", "points": 34.5 }, { "player_id": "3214", "points": 21.3 }, { "player_id": "12474", "points": 10.1 }, { "player_id": "11564", "points": 40.3 }, { "player_id": "5870", "points": 19.76 } ] } ], "observed_at_ms": 1792622184891, "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://firecrawl.dev/alexandria/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://firecrawl.dev/alexandria/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 benching or dropping a locked player. 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://firecrawl.dev/alexandria/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: `[]` - `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": 1792622184891, "players": [ { "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, "status": "Active", "team": "GB", "week": 7, "years_exp": 6 }, { "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, "status": "Inactive", "team": "SEA", "week": 7, "years_exp": 3 }, { "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, "status": "Active", "team": "BUF", "week": 7, "years_exp": 4 }, { "bye_week": 5, "depth_chart_order": 1, "depth_chart_position": "QB", "fantasy_positions": [ "QB" ], "flags": [], "game": { "date": "2026-10-25", "game_id": "202610730", "home": false, "opponent": "SEA", "status": "pre_game" }, "injury_body_part": null, "injury_start_date": null, "injury_status": null, "locked": false, "name": "Patrick Mahomes", "on_bye": false, "player_id": "4046", "position": "QB", "practice_participation": null, "status": "Active", "team": "KC", "week": 7, "years_exp": 9 } ], "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://firecrawl.dev/alexandria/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 benching or dropping a locked player. - Instructions: Waiver-wire ideas; check the flags before suggesting a pickup. - Cost: 5 credits per call - Capability file: [Trending players](https://firecrawl.dev/alexandria/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 } ```