Is fantasy_points_ppr supplied by the source?

No. Big Balls computes standard PPR from licensed passing, rushing and receiving totals: 0.04 per passing yard, 4 per passing touchdown, -2 per interception, 0.1 per rushing or receiving yard, 6 per rushing or receiving touchdown, and 1 per reception.

Can I rank players by points per game?

Not from this leaderboard. The source carries no games-played field, so dividing by a guessed count would be misleading.

Can every leader open a player detail page?

No. player.id is nullable, and the default top 20 had no resolved ids in the 2026-09-14 production measurement. Disable the link when the id is null.

Are NCAAF injuries and headshots available?

They are separate capabilities. There is no served NCAAF injury feed today. The leaderboard does carry nullable player headshots: Free receives a redacted null plus an upgrade note, while Solo and above receive the stored direct URL when available.

Which seasons does the NCAAF leaderboard cover?

Season 2026 only today. The route resolves an omitted season to the newest populated season, but this guide keeps 2026 explicit.

Tutorial · 12 min · endpoints verified 2026-09-19

How to build an NCAAF fantasy football app

Rank the current FBS season with a licensed player leaderboard and a transparent standard-PPR formula. The useful first release is a board, not a full roster platform: identity, injuries and games-played coverage still impose real limits. Solo adds the player headshots already carried by the response.

API coverage and endpoint overview: Explore the NCAAF API

Why this is hard

College fantasy data needs an honest minimum product

A season-total leader board is buildable now. Draft-room headshots, injury filtering, per-game qualification and reliable player drill-down are not all available, so the first version should be scoped around the board the endpoint can support.

The licensed NCAAF leader route currently carries season 2026 only.
fantasy_points_ppr is computed by Big Balls from served box-score totals; the route also exposes the component passing, rushing and receiving fields.
The source does not provide games_played, so there is no min_games filter and totals cannot be converted honestly to per-game averages here.
player.id is a canonical Big Balls UUID when resolved, but it is nullable. A null id must disable drill-down rather than trigger a name-based guess.
player.headshot_url is a separate embedded capability: Free receives null plus the shared upgrade note, while Solo and above receive the stored direct image URL when one exists.

Path 1 · recommended

Have your AI agent build it

The leaderboard has no MCP tool, so use REST for the board. MCP can inspect coverage and find canonical players, but a name match must never overwrite a null id from the leaderboard.

1. Connect the MCP server

Add the server in your MCP client and sign in with your Big Balls account. Your client registers itself and handles the token exchange — there is no key to copy.

MCP client configjson

{
  "mcpServers": {
    "bigballs-sports-data": {
      "url": "https://mcp.bigballsdata.com/mcp"
    }
  }
}

2. Tools your agent gets

find_players
Find canonical player IDs by name for use with player-stat tools.
get_player_stats
Per-player career or per-season totals and per-game rates.
get_coverage
Machine-readable map of what we hold and what we do not.

3. Ask for what you want

Paste this at your agent. It is written to make the model check coverage before it designs anything, which is what stops it inventing a field we do not serve.

Prompttext

Build a college fantasy football season leaderboard.

Use get_coverage for american_football, then call
GET /v1/ncaaf/leaders?stat=fantasy_points_ppr&season=2026&limit=100 directly.
Display rank, player name, position, team and fantasy_points_ppr.

Do not calculate points per game because this surface has no games_played.
Do not add injuries; there is no served NCAAF injury surface. Use
player.headshot_url when present, and render initials when it is null.
player.id can be null. Enable a player-history link only when it is non-null,
and never guess an id by taking the first same-name result from find_players.

What the agent cannot reach

There is no MCP tool for /v1/ncaaf/leaders. The board is 2026-only today, has no games-played qualifier and has no NCAAF injury feed. Headshots are a Solo field and remain nullable; canonical player ids are nullable too.

Path 2 · hand-coded

Build it yourself

The build stops at a defensible season-total board. It uses no invented game counts, injuries or player joins, and gives a missing headshot an honest initials fallback.

01
Request the standard-PPR leader board
Keep season explicit. The route’s default stat is fantasy_points_ppr, but naming it makes the product rule auditable.
GET /v1/ncaaf/leadersbash
```
curl -s "https://api.bigballsdata.com/v1/ncaaf/leaders?season=2026&stat=fantasy_points_ppr&limit=100" \
  -H "x-api-key: $BBS_API_KEY"
```

Render season totals without a games filter

Use value or fantasy_points_ppr as the season total. Do not divide by an assumed games count.

Leaderboard view modeljavascript

const board = response.data.leaders.map((row) => ({
  rank: row.rank,
  playerId: row.player.id,
  name: row.player.name,
  position: row.player.position,
  team: row.team.name,
  ppr: row.fantasy_points_ppr,
}));

03
Handle unresolved player identity
Identity and media are independent. Disable drill-down when id is null; use initials when headshot_url is null. Never match the first identical name.
Null-safe player link and imagejavascript
```
function playerHref(row) {
  return row.playerId ? `/players/${row.playerId}` : null;
}

function playerImage(row) {
  return row.headshotUrl ?? null; // render initials when null
}
```
04
Offer alternate statistical boards
The same route can rank allowed passing, rushing, receiving and defensive totals. Keep the selected stat in the heading.
Receiving-yards boardbash
```
curl -s "https://api.bigballsdata.com/v1/ncaaf/leaders?season=2026&stat=receiving_yards&limit=50" \
  -H "x-api-key: $BBS_API_KEY"
```

Reference

Every endpoint this tutorial uses

All on the gateway at api.bigballsdata.com. Verified against production on 2026-09-19.

Method	Path	Returns	Why you need it	Plan
GET	/v1/ncaaf/leaders?season=2026&stat=fantasy_points_ppr	Season-total PPR ranking, component statistics and nullable player.headshot_url	The primary board. Big Balls computes standard PPR over the licensed raw totals. The route stays Free; only the embedded headshot field has a Solo floor. Read the endpoint guide.Only 2026 is populated today. There is no games_played field or min_games parameter.	Free
GET	/v1/players/:id/stats?sport=american_football&season=	Per-player season or game stat rows when a canonical player id is known	Optional drill-down only for leader rows whose player.id is non-null. Review authenticated calls.Do not fall back to a name join. On the default board, production measurement found 0 of 20 ids resolved on 2026-09-14.	Free

Pricing, honestly

Free proves the board; Solo supplies player headshots

The current leaderboard and historical player-stat queries are Free, but Free redacts player.headshot_url to null with the shared upgrade note. Solo serves the stored URL when one exists. Drill-down still requires a non-null canonical player id.

Free leaderboard

texttext

GET /v1/ncaaf/leaders?season=2026&stat=fantasy_points_ppr&limit=100

Solo leaderboard media

texttext

GET /v1/ncaaf/leaders?season=2026&stat=fantasy_points_ppr
→ player.headshot_url is served when available

Free builds the complete current season-total ranking returned by the leaderboard.
Solo serves player.headshot_url where the canonical player row has one; a nullable field still needs an initials fallback.
Historical player drill-down is Free, but useful only for rows with a non-null canonical id.
An upgrade does not create games-played or injuries; those remain data requirements.

See the full plan ladder →

Other build guides

Known gaps

What the fantasy board cannot promise yet

These gaps define the first release and the data work required for a fuller roster product.

Canonical identity and headshot completeness remain measurable coverage questions; clients must handle null for both fields independently.
The season surface has no games_played field, so per-game averages and minimum-game qualification are not supportable.
There is no served NCAAF injury feed. Player headshots are served as direct URLs on Solo when the canonical player row has one.
Only season 2026 is populated in the licensed leaderboard today.

Questions

Is fantasy_points_ppr supplied by the source?: No. Big Balls computes standard PPR from licensed passing, rushing and receiving totals: 0.04 per passing yard, 4 per passing touchdown, -2 per interception, 0.1 per rushing or receiving yard, 6 per rushing or receiving touchdown, and 1 per reception.
Can I rank players by points per game?: Not from this leaderboard. The source carries no games-played field, so dividing by a guessed count would be misleading.
Can every leader open a player detail page?: No. player.id is nullable, and the default top 20 had no resolved ids in the 2026-09-14 production measurement. Disable the link when the id is null.
Are NCAAF injuries and headshots available?: They are separate capabilities. There is no served NCAAF injury feed today. The leaderboard does carry nullable player headshots: Free receives a redacted null plus an upgrade note, while Solo and above receive the stored direct URL when available.
Which seasons does the NCAAF leaderboard cover?: Season 2026 only today. The route resolves an omitted season to the newest populated season, but this guide keeps 2026 explicit.

Related APIs

Other APIs you can build with:

NCAAF API: FBS/FCS Scores & Odds American Football API NFL API: Play-by-Play & Stats

Stats reference

NFL Player Stats API

Ship the honest season-total board

Start with the free 2026 leaderboard and make every unavailable enrichment visibly unavailable instead of guessed.