sleeper-go

Go library for the Sleeper fantasy sports free read-only API. According to their documentation, stay under 1000 API calls per minute, otherwise, you risk being IP-blocked.

Usage

Example code that gets the users for the specified league and outputs their display name and team name.

package main

import (
	"fmt"
	"log"

	"github.com/lum8rjack/sleeper-go"
)

func main() {
    leagueID := "123456789012345678" // Fake league Id
	botClient := sleeper.NewClient()

	leagueUsers, err := botClient.GetLeagueUsers(leagueID)
	if err != nil {
		log.Fatal(err)
	}
	for _, user := range leagueUsers {
		fmt.Printf("%s (Team name: %s)\n", user.DisplayName, user.Metadata.TeamName)
	}
}

Sample output:

2KSports (Team name: Game of End Zones)
TOBOT (Team name: Saving Matt Ryan)
...

Custom Methods

I created a few custom methods that require correlating results from multiple API calls in order to receive the data.

GetMatchups

This method gets the matchups for the specified week and returns each team and their wins and losses.

type TeamMatchup struct {
	Teamname1   string
	Teamname2   string
	Team1Losses int
	Team2Losses int
	Team1Wins   int
	Team2Wins   int
}

func (c *Client) GetTeamMatchups(league_id string, week int) ([]TeamMatchup, error)

GetScoreboards

This method gets the scoreboard for each matchup for the specified week and returns each team and points.

type Scoreboard struct {
	Teamname1 string  `json:"teamname_1"`
	Teamname2 string  `json:"teamname_2"`
	Points1   float32 `json:"points_1"`
	Points2   float32 `json:"points_2"`
}

func (c *Client) GetScoreboards(league_id string, week int) ([]Scoreboard, error)

Players

The players API is not intended to be called every time you need to look up players due to the large file size. It should not be called more than once per day.

With this in mind, I have created additional methods to save the players information to disk and read the saved file from disk.

// Get all players - use this sparingly
func (c *Client) GetAllPlayers(sport string) (Players, error)

// Get all players and save the details to a file
func (c *Client) SaveAllPlayers(sport string, file string) (bool, error)

// Get all players from a saved file
func GetAllPlayers(file string) (Players, error)

Sleeper API Implementation Status

• User
  • User object - GET https://api.sleeper.app/v1/user/<username>
  • User object - GET https://api.sleeper.app/v1//user/<user_id>
• Avatars
  • Full size URL - GET https://sleepercdn.com/avatars/<avatar_id>
  • Thumbnail URL - GET https://sleepercdn.com/avatars/thumbs/<avatar_id>
• Leagues
  • Get all leagues for user - GET https://api.sleeper.app/v1/user/<user_id>/leagues/<sport>/<season>
  • Get a specific league - GET https://api.sleeper.app/v1/league/<league_id>
  • Get rosters in a league - GET https://api.sleeper.app/v1/league/<league_id>/rosters
  • Get users in a league - GET https://api.sleeper.app/v1/league/<league_id>/users
  • Get matchups in a league - GET https://api.sleeper.app/v1/league/<league_id>/matchups/<week>
  • Get the playoff bracket (winners bracket) - GET https://api.sleeper.app/v1/league/<league_id>/winners_bracket
  • Get the playoff bracket (loses bracket) - GET https://api.sleeper.app/v1/league/<league_id>/loses_bracket
  • Get transactions - GET https://api.sleeper.app/v1/league/<league_id>/transactions/<round>
  • Get traded picks - GET https://api.sleeper.app/v1/league/<league_id>/traded_picks
  • Get sport state - GET https://api.sleeper.app/v1/state/<sport>
• Drafts
  • Get all drafts for user - GET https://api.sleeper.app/v1/user/<user_id>/drafts/<sport>/<season>
  • Get all drafts for a league - GET https://api.sleeper.app/v1/league/<league_id>/drafts
  • Get a specific draft - GET https://api.sleeper.app/v1/draft/<draft_id>
  • Get all picks in a draft - GET https://api.sleeper.app/v1/draft/<draft_id>/picks
  • Get traded picks in a draft - GET https://api.sleeper.app/v1/draft/<draft_id>/traded_picks
• Players
  • Get all players - GET https://api.sleeper.app/v1/players/<sport>
  • Trending players - GET https://api.sleeper.app/v1/players/<sport>/trending/<type>?lookback_hours=<hours>&limit=<int>

License

MIT