Games
Game Engine
Engage

Read the caller's locker-singularity idle ledger

Changed on

First-ever read creates the ledger row. Otherwise credits offline accrual from the server lastSeenAt only (8h cap at 50% efficiency; client timestamps are never accepted) and returns { ledger, accruedBuzz, cappedHours, lastSeenAt }. Toy currencies only: zero writes to DSC balances, Rep, PointsHistory, pack inventory, or marketplace state (d-sports-api#682). The locker-singularity Game row ships as LIVE: the catalog marks it playable=true. Ledger routes serve COMING_SOON rows normally; an absent Game row returns 404 GAME_UNKNOWN with the ledger untouched. Optional X-Client-Version is checked against minClientVersion; below-minimum returns 403 GAME_UPDATE_REQUIRED. Native mirror: locker-singularity spec on the native soft-idle-mini-game branch.

get/api/v1/engage/games/locker-singularity/ledger

Request

  • Base URL
    https://app.d-sports.org
  • Auth
    HTTP bearer

Headers

X-Client-Versionstring

Native client semver. Below minClientVersion returns 403 GAME_UPDATE_REQUIRED.

Response

{ ledger, accruedBuzz, cappedHours, lastSeenAt }

accruedBuzzstring required

BigInt serialized as decimal string.

cappedHoursnumber required
lastSeenAtstring date-time required

Changes