@yaelouuu/fortnite-api 7.1.1 → 7.2.0

package/dist/resources/tournaments.d.ts

@@ -1,5 +1,5 @@
 import { FortniteAPI } from "../client";
-import { Leaderboard, TournamentTrackerResponse, TournamentEligibilityResponse, EventTokenEligibilityResponse } from "../types";
+import { Leaderboard, TournamentTrackerResponse, TournamentEligibilityResponse, EventTokenEligibilityResponse, CashPrizesResponse, PayoutTable } from "../types";
 export declare class TournamentsResource {
     private client;
     constructor(client: FortniteAPI);
@@ -170,6 +170,47 @@ export declare class TournamentsResource {
      * );
      * ```
      */
+    /**
+     * Get all payout tables across all event windows.
+     *
+     * Player-specific data is stripped — only the reward/prize structures are returned.
+     * The response is an object keyed by event window ID (e.g. `"epicgames_S40_RankedCupSolo_EU_1_Elite"`).
+     * Response is cached for 4 hours.
+     *
+     * No authentication required.
+     */
+    getCashPrizes(): Promise<CashPrizesResponse>;
+    /**
+     * Get the payout table for a specific event window.
+     *
+     * @param eventWindowId - Event window identifier (e.g. `"epicgames_S40_RankedCupSolo_EU_1_Elite"`)
+     *
+     * @throws {FortniteAPIError} 404 if no payout table exists for the given event window
+     */
+    getCashPrize(eventWindowId: string): Promise<PayoutTable>;
+    /**
+     * Get top performers for a specific tracked stat across the entire leaderboard.
+     * Fetches all pages in parallel so high-stat but low-placed teams are always included.
+     * Response includes an `availableStats` array listing every stat key tracked in this tournament.
+     * Requires pro or custom plan.
+     * @param eventId - Event identifier (e.g. "epicgames_Bratwurst_Official")
+     * @param eventWindowId - Event window identifier (e.g. "Bratwurst_UpperBracket_Day1")
+     * @param statKey - Tracked stat key to rank by (e.g. TEAM_ELIMS_STAT_INDEX, DamageDealt, Headshots)
+     * @param top - Number of teams to return (default: 10, max: 100)
+     */
+    getEventStats(eventId: string, eventWindowId: string, statKey: string, top?: number): Promise<any>;
+    /**
+     * Get all tracked stats for a specific team.
+     * Returns every stat tracked in this tournament for that team (total + per-game), plus their
+     * rank in the requested statKey across all teams in the event.
+     * Accepts an Epic account ID (32 hex chars) or display name — clan tags are stripped for matching.
+     * Requires pro or custom plan.
+     * @param eventId - Event identifier
+     * @param eventWindowId - Event window identifier
+     * @param statKey - Stat to show this team's rank in (e.g. DamageDealt, TEAM_ELIMS_STAT_INDEX)
+     * @param teamIdentifier - Epic account ID or display name of any player on the team
+     */
+    getTeamEventStats(eventId: string, eventWindowId: string, statKey: string, teamIdentifier: string): Promise<any>;
     getLeaderboardV2(params: {
         eventId: string;
         eventWindowId: string;

package/dist/resources/tournaments.js

@@ -225,6 +225,59 @@ class TournamentsResource {
      * );
      * ```
      */
+    /**
+     * Get all payout tables across all event windows.
+     *
+     * Player-specific data is stripped — only the reward/prize structures are returned.
+     * The response is an object keyed by event window ID (e.g. `"epicgames_S40_RankedCupSolo_EU_1_Elite"`).
+     * Response is cached for 4 hours.
+     *
+     * No authentication required.
+     */
+    async getCashPrizes() {
+        return this.client.request("/events/cashprizes");
+    }
+    /**
+     * Get the payout table for a specific event window.
+     *
+     * @param eventWindowId - Event window identifier (e.g. `"epicgames_S40_RankedCupSolo_EU_1_Elite"`)
+     *
+     * @throws {FortniteAPIError} 404 if no payout table exists for the given event window
+     */
+    async getCashPrize(eventWindowId) {
+        return this.client.request(`/events/cashprize/${encodeURIComponent(eventWindowId)}`);
+    }
+    /**
+     * Get top performers for a specific tracked stat across the entire leaderboard.
+     * Fetches all pages in parallel so high-stat but low-placed teams are always included.
+     * Response includes an `availableStats` array listing every stat key tracked in this tournament.
+     * Requires pro or custom plan.
+     * @param eventId - Event identifier (e.g. "epicgames_Bratwurst_Official")
+     * @param eventWindowId - Event window identifier (e.g. "Bratwurst_UpperBracket_Day1")
+     * @param statKey - Tracked stat key to rank by (e.g. TEAM_ELIMS_STAT_INDEX, DamageDealt, Headshots)
+     * @param top - Number of teams to return (default: 10, max: 100)
+     */
+    async getEventStats(eventId, eventWindowId, statKey, top) {
+        const params = new URLSearchParams();
+        if (top != null)
+            params.append("top", String(top));
+        const qs = params.toString();
+        return this.client.request(`/events/stats/${encodeURIComponent(eventId)}/${encodeURIComponent(eventWindowId)}/${encodeURIComponent(statKey)}${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get all tracked stats for a specific team.
+     * Returns every stat tracked in this tournament for that team (total + per-game), plus their
+     * rank in the requested statKey across all teams in the event.
+     * Accepts an Epic account ID (32 hex chars) or display name — clan tags are stripped for matching.
+     * Requires pro or custom plan.
+     * @param eventId - Event identifier
+     * @param eventWindowId - Event window identifier
+     * @param statKey - Stat to show this team's rank in (e.g. DamageDealt, TEAM_ELIMS_STAT_INDEX)
+     * @param teamIdentifier - Epic account ID or display name of any player on the team
+     */
+    async getTeamEventStats(eventId, eventWindowId, statKey, teamIdentifier) {
+        return this.client.request(`/events/stats/${encodeURIComponent(eventId)}/${encodeURIComponent(eventWindowId)}/${encodeURIComponent(statKey)}/${encodeURIComponent(teamIdentifier)}`);
+    }
     async getLeaderboardV2(params, teams, fortniteToken) {
         const query = new URLSearchParams({
             eventId: params.eventId,

package/dist/resources/weapons.d.ts

@@ -1,33 +1,37 @@
 import { FortniteAPI } from "../client";
-import { WeaponsResponse, RarityDefinitionsResponse } from "../types";
+import { WeaponsResponse, RarityDefinitionsResponse, AvailablePatchesResponse } from "../types";
 export declare class WeaponsResource {
     private client;
     constructor(client: FortniteAPI);
     /**
      * Get weapons data with optional filtering
-     * @param options - Query options
-     * @param options.version - Version filter: "current" (loot pool), "all" (every weapon), or a specific patch like "39.50"
-     * @param options.category - Filter by category: assault-rifle, shotgun, smg, sniper, pistol, explosive, bow, crossbow, melee, light-machine-gun
-     * @param options.search - Search weapons by name (e.g. "pump", "assault", "bolt")
-     * @param options.gamemode - Filter by gamemode: "br" (Battle Royale) or "og" (OG mode)
-     * @param options.rarity - Filter by rarity: common, uncommon, rare, epic, legendary, mythic, transcendent
-     * @param options.type - Filter by weapon type: ranged, melee, consumable, trap, gadget
-     * @param options.ammoType - Filter by ammo type: light, medium, heavy, shells, rockets, energy, arrows
-     * @param options.season - Filter by season availability: "CH6S7" or "6.7" format
-     * @returns Weapons response with metadata, availableSeasons, and weapon data
+     * @param options.patch - Patch version (e.g. "32.00"). Defaults to current patch.
+     * @param options.category - Filter by category (e.g. Assault, Shotgun)
+     * @param options.search - Search weapons by name
+     * @param options.gamemode - Filter by gamemode: "BattleRoyale" or "ZeroBuild"
+     * @param options.rarity - Filter by rarity (e.g. rare, epic, legendary)
+     * @param options.type - Filter by weapon type (e.g. ranged, melee)
+     * @param options.ammoType - Filter by ammo type (e.g. light, medium, heavy)
+     * @param options.itemType - Filter by item type
+     * @param options.lang - Language code (default: en)
      */
     getWeapons(options?: {
-        version?: string;
+        patch?: string;
         category?: string;
         search?: string;
-        gamemode?: "br" | "og";
+        gamemode?: string;
         rarity?: string;
         type?: string;
         ammoType?: string;
-        season?: string;
+        itemType?: string;
+        lang?: string;
     }): Promise<WeaponsResponse>;
     /**
-     * Get rarity definitions (colors, display names, backend values)
+     * Get all available weapon patches, with the current patch flagged
+     */
+    getAvailablePatches(): Promise<AvailablePatchesResponse>;
+    /**
+     * Get rarity definitions and their display colors
      */
     getRarityDefinitions(): Promise<RarityDefinitionsResponse>;
 }

package/dist/resources/weapons.js

@@ -7,21 +7,20 @@ class WeaponsResource {
     }
     /**
      * Get weapons data with optional filtering
-     * @param options - Query options
-     * @param options.version - Version filter: "current" (loot pool), "all" (every weapon), or a specific patch like "39.50"
-     * @param options.category - Filter by category: assault-rifle, shotgun, smg, sniper, pistol, explosive, bow, crossbow, melee, light-machine-gun
-     * @param options.search - Search weapons by name (e.g. "pump", "assault", "bolt")
-     * @param options.gamemode - Filter by gamemode: "br" (Battle Royale) or "og" (OG mode)
-     * @param options.rarity - Filter by rarity: common, uncommon, rare, epic, legendary, mythic, transcendent
-     * @param options.type - Filter by weapon type: ranged, melee, consumable, trap, gadget
-     * @param options.ammoType - Filter by ammo type: light, medium, heavy, shells, rockets, energy, arrows
-     * @param options.season - Filter by season availability: "CH6S7" or "6.7" format
-     * @returns Weapons response with metadata, availableSeasons, and weapon data
+     * @param options.patch - Patch version (e.g. "32.00"). Defaults to current patch.
+     * @param options.category - Filter by category (e.g. Assault, Shotgun)
+     * @param options.search - Search weapons by name
+     * @param options.gamemode - Filter by gamemode: "BattleRoyale" or "ZeroBuild"
+     * @param options.rarity - Filter by rarity (e.g. rare, epic, legendary)
+     * @param options.type - Filter by weapon type (e.g. ranged, melee)
+     * @param options.ammoType - Filter by ammo type (e.g. light, medium, heavy)
+     * @param options.itemType - Filter by item type
+     * @param options.lang - Language code (default: en)
      */
     async getWeapons(options) {
         const params = new URLSearchParams();
-        if (options?.version)
-            params.set("version", options.version);
+        if (options?.patch)
+            params.set("patch", options.patch);
         if (options?.category)
             params.set("category", options.category);
         if (options?.search)
@@ -34,13 +33,21 @@ class WeaponsResource {
             params.set("type", options.type);
         if (options?.ammoType)
             params.set("ammoType", options.ammoType);
-        if (options?.season)
-            params.set("season", options.season);
+        if (options?.itemType)
+            params.set("itemType", options.itemType);
+        if (options?.lang)
+            params.set("lang", options.lang);
         const query = params.toString() ? `?${params.toString()}` : "";
         return this.client.request(`/weapons${query}`, {}, "v2");
     }
     /**
-     * Get rarity definitions (colors, display names, backend values)
+     * Get all available weapon patches, with the current patch flagged
+     */
+    async getAvailablePatches() {
+        return this.client.request("/weapons/patches", {}, "v2");
+    }
+    /**
+     * Get rarity definitions and their display colors
      */
     async getRarityDefinitions() {
         return this.client.request("/weapons/rarity", {}, "v2");

package/dist/types/index.d.ts

@@ -695,6 +695,9 @@ export interface PlayerEligibilityResult {
     }>;
     checkedAt: string;
 }
+export interface OAuthAuthorizeUrlResponse {
+    url: string;
+}
 export interface OAuthExchangeCodeResponse {
     success: boolean;
     accessToken: string;
@@ -705,6 +708,67 @@ export interface OAuthExchangeCodeResponse {
     accountId: string;
     displayName: string | null;
 }
+export interface PlayerWindowStandingSession {
+    sessionId: string;
+    placement: number;
+    teamId: string;
+    teamAccountIds: string[];
+    score: number;
+    trackedStats: Record<string, number>;
+    gameSessionId?: string;
+    gameSessionKey?: string;
+    liveSessionId?: string;
+}
+/**
+ * Player standing in a specific event window.
+ * Returned by GET /api/v2/events/{eventId}/windows/{eventWindowId}/players/{accountId}
+ */
+export interface PlayerWindowStanding {
+    eventId: string;
+    eventWindowId: string;
+    teamAccountIds: string[];
+    teamAccountDisplayNames?: string[];
+    pointsEarned: number;
+    rank: number;
+    percentile?: number;
+    sessionHistory: PlayerWindowStandingSession[];
+}
+export interface PayoutTableReward {
+    itemType: string;
+    itemId?: string;
+    itemGuid?: string;
+    templateId?: string;
+    quantity: number;
+    rewardType?: string;
+}
+export interface PayoutTableRankEntry {
+    threshold: number;
+    items: PayoutTableReward[];
+}
+export interface PayoutTablePercentileEntry {
+    scorePercent: number;
+    scoreRank: number;
+    items: PayoutTableReward[];
+}
+/**
+ * Payout table for a specific event window.
+ * `scoringType` determines which array is populated:
+ * - `"rank"` → `rankPayoutTable` is present
+ * - `"percentile"` → `percentilePayoutTable` is present
+ */
+export interface PayoutTable {
+    scoringType: "rank" | "percentile" | string;
+    rankPayoutTable?: PayoutTableRankEntry[];
+    percentilePayoutTable?: PayoutTablePercentileEntry[];
+    [key: string]: any;
+}
+/**
+ * All payout tables keyed by event window ID.
+ * Returned by GET /api/v1/events/cashprizes
+ */
+export interface CashPrizesResponse {
+    [eventWindowId: string]: PayoutTable;
+}
 export interface ArenaHype {
     accountId: string;
     currentHype?: number;
@@ -804,6 +868,15 @@ export interface RarityDefinitionsResponse {
     status: number;
     data: RarityDefinition[];
 }
+export interface AvailablePatchInfo {
+    patch: string;
+    isCurrent: boolean;
+}
+export interface AvailablePatchesResponse {
+    status: number;
+    current: string | null;
+    patches: AvailablePatchInfo[];
+}
 export interface CrewPackResponse {
     status: number;
     data: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaelouuu/fortnite-api",
-  "version": "7.1.1",
+  "version": "7.2.0",
   "description": "SDK for Fortnite API - api-fortnite.com - Author : Yael Brinkert",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",