Data freshness

SWGoH is not live. Everything you see was read from Comlink at some point, and knowing when is often the difference between a right answer and a wrong one.

Three ways data arrives

On demand. Opening a player or guild that SWGoH has never seen fetches it from Comlink immediately. This is why the first load is slow and the rest are not.

On a schedule. Six background jobs keep things current: game reference data, events, guilds, players, new-guild discovery, and Grand Arena bracket capture. Each runs on its own cron expression, set by configuration rather than in code, so cadence differs between instances.

On request. A guild page's Refresh players re-pulls every member now.

History is written on change

This is the one that surprises people.

Snapshots are not written on a timer. A guild snapshot is written when the guild's galactic power changes; a player snapshot when their headline stats change.

So a quiet week produces no rows. That is not a gap in the data — it is the data saying nothing happened. History charts are correspondingly uneven, with clusters around active periods and flat stretches where nothing moved.

What cannot be backfilled

Some things are only observable while they are happening:

• Grand Arena brackets — not retrievable once the season closes.
• Territory Wars older than Comlink's last eight — outside the window, gone.

Everything else can be re-fetched, because Comlink will still tell you what is true now.