‹ All updates

Contract 3.17.0

Tool contract 3.17.0

One grammar, one vocabulary (docs/reviews/2026-09-19-INTERFACE-REVIEW.md Part 2, Phase 4).

  • Every windowed tool's applied.window says its season: season (the season the window starts in; null on an unbounded window), crosses (every season roll inside it, empty when clean) and season_age_days, on battles_query, battles_performance, battles_decks, battles_cards, battles_opponents, battles_compare, clans_standings, battles_levels, clans_pilot_scores, clans_participation, rankings_timeline, game_events and elixir_timeline, as the meta and series tools already carried them. The crossing note fires only when crosses is non-empty.
  • The player battle tools and clans_standings take season ('current', 'previous', 2026-08 or 135), so "this season" is one argument on every tool that has a window; their default is unchanged.
  • The series tools (players_timeline, clans_timeline, clans_members_timeline) accept an instant for from/to and floor it to its game day (10:00Z grid), echoing the instant under applied.window.floored with a note, where they refused it; days: N is N game days, today included.
  • The one point vocabulary: players_timeline points carry day beside date; rankings_timeline points carry day (the snapshot's game day); battles_levels.monthly_trend marks the window's clipped months with partial: true and covers {from, to}, the weekly shape; clans_participation echoes applied.window.source: 'default' when weeks was defaulted and its notes say war_points is the period points figure; game_events carries game_days_seen beside days_seen (the same sightings on the game day grid; days_seen retires at 4.0.0), its running_on_latest_day is a fact of the table rather than of the window, and a date-only to no longer reaches one day past itself; clans_roster.lifetime carries profile_observed_at beside as_of (as_of retires at 4.0.0).
  • clans_pilot_scores and battles_levels.monthly_trend take mean_starting_trophies over ladder battles only (a Path of Legends figure is a league rating on another scale; null with none), and say so.
  • players_summary.top_deck and best_deck carry mean_level_gap, so the comparability note names real gaps.
  • Descriptions: players_timeline.metrics names its four groups and the default; battles_performance.group_by says mode is the named game mode, not the group; clans_members_timeline.limit says the order and how to choose; rankings_players says rating is the profile's pol_trophies, verified equal on the live API.

Additive; no migration.

Help for Tool contract 3.17.0

One grammar, one vocabulary (docs/reviews/2026-09-19-INTERFACE-REVIEW.md Part 2, Phase 4).

Read more

The page you are on rides along. Every item is answered, and the answer comes to your email and your timeline.