Package Exports

espn-fantasy-wnba-api
espn-fantasy-wnba-api/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (espn-fantasy-wnba-api) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ESPN Fantasy WNBA API

The first and only public API for ESPN's Fantasy WNBA

This library provides access to ESPN's internal Fantasy WNBA endpoints, reverse-engineered and documented for public use.

Prerequisites

This package is designed for Node.js environments and requires:

npm install node-fetch  # Required dependency

Installation

Since this package isn't published to npm yet, install directly from GitHub:

npm install matthewh8/espn-fantasy-wnba-api
npm install node-fetch  # Required dependency

Quick Start

import ESPNWNBAFantasyAPI from 'espn-fantasy-wnba-api';

// Public data (no authentication)
const api = new ESPNWNBAFantasyAPI();
const players = await api.getAllPlayers();

// Private league data (requires ESPN cookies)
const privateApi = new ESPNWNBAFantasyAPI({
    espnS2: 'your_espn_s2_cookie',
    swid: 'your_swid_cookie'
});

const rosters = await privateApi.getLeagueRosters('YOUR_LEAGUE_ID_HERE');

Authentication

For private league data, you need ESPN authentication cookies:

Go to ESPN Fantasy WNBA in your browser
Open DevTools (F12) → Application → Cookies → espn.com
Copy espn_s2 and SWID values

Available Methods

Public Endpoints (No Auth Required)

getAllPlayers(scoringPeriodId?) - All WNBA players with ownership data
getProTeamSchedules() - WNBA team schedules
getGameState() - Current game state info

Private Endpoints (Auth Required)

getLeagueRosters(leagueId) - All team rosters in league
getLeagueSettings(leagueId) - League scoring settings
getPendingTransactions(leagueId) - Waivers and pending trades
getCurrentMatchups(leagueId, scoringPeriodId?) - Current week matchups
getScoreboard(leagueId, scoringPeriodId?) - League scoreboard

Example: Get Team Rosters

const api = new ESPNWNBAFantasyAPI({
    espnS2: 'your_cookie',
    swid: 'your_swid'
});

const data = await api.getLeagueRosters('YOUR_LEAGUE_ID_HERE');
const rosters = api.extractRosters(data);

rosters.forEach(team => {
    console.log(`${team.name}:`);
    team.players.forEach(player => {
        console.log(`  - ${player.name}`);
    });
});

Troubleshooting

Common Issues:

"fetch is not defined" - Make sure you've installed node-fetch
401 Unauthorized - Check that your ESPN cookies are valid and not expired
Module not found - Ensure you're using Node.js 14+ with ES modules support

Getting Your League ID: Your league ID can be found in the URL when viewing your ESPN Fantasy WNBA league: https://fantasy.espn.com/basketball/league?leagueId=YOUR_LEAGUE_ID_HERE

Discovered Endpoints

This API exposes ESPN's internal Fantasy WNBA endpoints. All discovered endpoints are documented in the source code for developers who want to expand functionality.

Base URL: https://lm-api-reads.fantasy.espn.com/apis/v3/games/wfba

Game Code: wfba (Women's Fantasy Basketball Association)

Environment Support

Node.js: 14.0.0 or higher
ES Modules: Required
Browser: Not supported (due to CORS restrictions)

Contributing

Found more endpoints or want to add features? PRs welcome!

License

MIT - Use freely for personal or commercial projects.