Base path: /api/v2
Authentication uses developer portal bearer tokens with route-scoped OAuth2 PKCE
grants. All responses include x-ratelimit-limit, x-ratelimit-window-seconds,
x-request-id, x-v2-api-version, and x-v2-app-id.
Read APIs#
GET /player/{playerId}/stats: rank, league, win-rate, per-fighter stats, per-stage stats, faction info, Crown points, and public visibility.GET /player/{playerId}/history: account-public-flag-gated match history.GET /replay/{replayId}: replay metadata and short-lived stream URL.GET /discord-bot/template: command manifest for/v2-rank,/v2-friend-list, and/v2-tournament-bracket.
Write APIs#
POST /match/{matchId}/coach-stream: frame data, opponent move list, signature moves, and coach annotations withgameplayAuthority: false.POST /notification/subscribe: APNS, FCM, and Web Push subscriptions for tournament invites, friend matches, party invites, Twitch Drops earned, daily challenges, and Battle Pass updates.POST /tournament/{tournamentId}/bracket: single-elimination, double-elimination, or round-robin bracket creation.POST /tournament/{tournamentId}/result: result reporting with replay evidence, leaderboard ingest queueing, and match-end webhook queueing.POST /leaderboard/ingest: authenticated server-to-server leaderboard rows.POST /webhook/tournament/match-end: HMAC-SHA256 callback registration.POST /micro-game/result: HMAC-signed Companion and Web Hub micro-game reward validation.
Scopes#
v2:public:readv2:player:read_privatev2:replay:readv2:coach-stream:writev2:notifications:writev2:tournament:writev2:leaderboard:writev2:webhook:writev2:developer:readv2:micro-game:write