How it works

From wherever your history is to one verified record.

Five stages, most of them automatic. The only one that needs you is the first.

1 · Connect

Give us the league. For Sleeper that is the league ID. For Yahoo, the league pages. For a spreadsheet, the file. Recordbook walks the league chain back as far as it goes and pulls every matchup, lineup, draft, transaction and bracket it can find.

2 · Reconcile

Sources merge into one model: one identity per manager across platforms and name changes, one timeline of seasons, one scoring rule set per era. Mid-season takeovers, score corrections and league rulings are recorded as configuration. The record shows what the league decided, with the raw number kept beside it.

3 · Verify

The build runs hundreds of checks. Standings against the platform. Standings against the spreadsheet. Box scores against team totals. Awards against game data. Every disagreement is resolved or explained on the league's data-notes page. A new unexplained disagreement stops the build from shipping.

4 · Publish

One site per league at its own address. Seasons, managers, players, records, rivalries, drafts, moves and tools. A twelve-season league runs to more than a thousand pages. Every page is static, so it is fast everywhere, and there is no database of your league to leak.

5 · Repeat

In season, the record refreshes itself after the week's last game. Season page, manager pages, playoff odds and power rankings are current by Tuesday morning. The weekly drop and the vote go out from there.

What is on a record

Twelve kinds of page.

Every page on a league site is one of twelve templates, so a reader who learns one league's record can read any other.

  • Home. What is going on right now, then the door to the archive.
  • Season. What happened this year, or what is happening this week.
  • Manager profile. Who this person is in the league.
  • Manager season. Every game and lineup of one year.
  • Manager career. The long table, season by season.
  • Player. One player's whole league life, with NFL stat lines.
  • Leaderboards. Records, lifetime tables, the value board, the tools.
  • Rivalry matrix. Who owns whom, at a glance.
  • Versus. Two managers, every game between them.
  • Moves ledger. Every trade, bid and add, filterable.
  • Auction board. Every roster as bought, steals and busts.
  • Data notes. Where the sources disagreed and what was decided.

The indexes

Two numbers every manager gets.

Luck Index
0 to 100, 50 is neutral, higher is luckier. Regular season only. Five components: all-play luck (actual wins minus the wins your scores would have earned against everyone), availability (starter weeks lost to injury, weighted by production), close games, cheap wins and unlucky losses against the week's median, and schedule draw. Each is standardized across the league's current managers, so the number means the same thing in every league.
Skill Index
Same construction. Lineup efficiency (points started against the best possible lineup), draft return per auction dollar, acquisition value from waivers and trades, start-sit misses that cost a game, waiver hit rate, and trades won.
Trade grades
A trade is valued on what each side's players produced for their new manager for as long as he kept them, across seasons, with credit carried forward when a player is flipped again. Every trade gets a letter, A to F.

Managers with fewer than 30 games get the indexes with a small-sample mark and stay out of the standardization pool.

Data and sources

Data and sources.

When deep history and instant setup conflict, deep history wins. If your league's records exist anywhere, the plan is to get them.

SleeperLive

Through the API. Matchups, per-player lineups, drafts (auction and snake), transactions, brackets, divisions, avatars. Walks the league chain to the first Sleeper season.

YahooRecovered

The Yahoo API no longer grants fantasy access to new apps, so history comes from the league pages themselves, paced to Yahoo's limits. Team scores and full box scores. One league: 361 games, 722 lineups, 2017 to 2020.

SpreadsheetsImport

Google Sheets or Excel. Standings, podiums, lifetime tables, noteworthy events. Pre-platform seasons live here.

ESPNPlanned

Not built yet. Say so when you request access.

NFL.comArtifacts only

The fantasy product was shut down. Recovery depends on a surviving link or screenshot and archived snapshots.

NFL statisticsLive

Stats, rosters, injuries, schedules and snap counts back to 1999 for every player who ever touched the league, from the nflverse project, joined to platform IDs. For one league: 718 players, 30,724 game lines.

What we keep: scores, lineups, transactions, drafts, and manager display names and avatars as they appear on the platform. What we never hold: platform passwords. Recordbook reads public league data, or data you hand us.

How the writing works

How the writing works.

The desk is optional and off until a commissioner turns it on. When it is on, a rotating crew of writers files after each week's data lands. Each writer has a set temperament and a byline, and the crew cycles so no two weeks read the same. The commissioner sets a tone from friendly to savage that every writer respects.

Rules the desk cannot break

  • Every sentence traces to a figure in the record. If it cannot be sourced, it does not run.
  • No invented quotes, reactions or scenes. The league's group chat is not the desk's material.
  • Numbers first. The ruthlessness comes from the facts.
  • Superlatives are cross-checked. Only one thing is the most.
  • Every story links to the pages it was written from.

This seasonLeagues can run human-written storylines today.

Start your league's record.

Tell us where it lives. We reply with what we can recover.

Start your record