fantasycalc.com APIfantasycalc.com ↗
Access FantasyCalc player rankings, trade values, and historical trade data via API. Supports Dynasty, Redraft, Superflex, PPR, and multi-team formats.
curl -X GET 'https://api.parse.bot/scraper/5e9d9ba7-cf7a-4bb0-bc6a-1c6038981577/get_rankings?ppr=1&num_qbs=2&num_teams=12&is_dynasty=true&include_adp=false' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch comprehensive fantasy football rankings and player values for a given league format. Returns an array of all ranked players sorted by overall rank, each with trade value, positional rank, trend data, and player metadata.
| Param | Type | Description |
|---|---|---|
| ppr | number | PPR scoring format. Accepted values: 0, 0.5, 1. |
| num_qbs | integer | Number of starting QBs. Accepted values: 1 (standard), 2 (Superflex). |
| num_teams | integer | Number of teams in the league. Accepted values: 10, 12, 14. |
| is_dynasty | boolean | Whether to fetch Dynasty (true) or Redraft (false) rankings. |
| include_adp | boolean | Whether to include ADP data in the response. |
{
"type": "object",
"fields": {
"data": "array of player ranking objects, each containing value (integer trade value), overallRank, positionRank, trend30Day, and a player object with id, name, position, team, age, and platform IDs"
},
"sample": {
"data": [
{
"value": 10211,
"player": {
"id": 6170,
"name": "Josh Allen",
"maybeAge": 30,
"position": "QB",
"maybeTeam": "BUF"
},
"maybeTier": 1,
"trend30Day": -200,
"overallRank": 1,
"positionRank": 1,
"maybeTradeFrequency": 0.0068
}
],
"status": "success"
}
}About the fantasycalc.com API
The FantasyCalc API exposes 3 endpoints covering fantasy football player rankings, trade value history, and database-wide trade counts derived from thousands of real league trades. The get_rankings endpoint returns a full ranked player list with integer trade values, positional ranks, 30-day trend data, and optional ADP figures across Dynasty, Redraft, Superflex, and multiple PPR settings. Player-level trade history is available through get_player_trades.
Rankings and Player Values
The get_rankings endpoint accepts five optional parameters — ppr (0, 0.5, or 1), num_qbs (1 for standard, 2 for Superflex), num_teams (10, 12, or 14), is_dynasty (Dynasty vs. Redraft), and include_adp — and returns an array of player objects sorted by overallRank. Each object includes a numeric value (the trade value score), positionRank, trend30Day, and player metadata such as name, position, and the player.id field used to query other endpoints.
Trade Value History
The get_player_trades endpoint takes a required player_id (obtained from get_rankings results) plus optional num_qbs and is_dynasty flags. It returns an object with two arrays: historicalValues, a dated time series of the player's trade value ({date, value}), and impliedValues, which lists actual trade scenarios showing the assets on each side (side1, side2) along with the implied value. This makes it possible to reconstruct what other managers considered fair for a given player.
Trade Volume
The get_trade_count endpoint takes no parameters and returns a single integer representing the total number of trades in the FantasyCalc database. This figure reflects the data volume underpinning all value calculations and can be surfaced in applications to communicate data freshness or credibility to end users.
- Display dynasty league trade values sorted by
overallRankandpositionRankinside a custom team management dashboard - Track a player's
trend30Dayacross multiple weeks to identify buy-low or sell-high opportunities - Compare
historicalValuestime series for two players to evaluate a proposed trade over time - Build a Superflex startup draft board by querying
get_rankingswithnum_qbs=2andis_dynasty=true - Show users the actual
impliedValuestrade scenarios fromget_player_tradesto justify a recommended deal - Surface the total trade count from
get_trade_countas a data freshness indicator in a fantasy advice tool - Generate PPR-adjusted rankings for half-PPR leagues by setting
ppr=0.5inget_rankings
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FantasyCalc have an official developer API?+
What does `get_player_trades` return beyond a single trade value number?+
historicalValues, which is a dated time series of the player's value, and impliedValues, which lists individual trade scenarios with assets on each side (side1, side2) and the implied value for that exchange. The num_qbs and is_dynasty parameters let you scope this history to a specific league format.Does the API cover IDP, TE-premium, or keeper league formats?+
num_qbs), Dynasty, and Redraft formats with 10, 12, or 14 teams. IDP, TE-premium scoring, or keeper-specific values are not exposed by the current endpoints. You can fork this API on Parse and revise it to add those scoring variants if FantasyCalc surfaces that data.Can I retrieve rankings for a specific player by name or position without fetching the full list?+
get_rankings returns all ranked players in one array sorted by overallRank. There is no per-player or per-position filter on that endpoint — filtering by position or name must be done client-side on the returned array. To get detailed trade history for one specific player, use get_player_trades with that player's player.id.How current is the trade value data?+
get_trade_count reflects the current database size. The historicalValues array in get_player_trades provides dated data points, so you can assess how recently values have shifted. Exact ingestion latency is not exposed by the API.