---
title: "Buy generator units with buzz"
method: POST
path: "/api/v1/engage/games/locker-singularity/ledger/buy"
tags: ["Games", "Game Engine", "Engage"]
---

# Buy generator units with buzz

`POST /api/v1/engage/games/locker-singularity/ledger/buy`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/engage/games/locker-singularity/ledger/buy`
- Auth: HTTP bearer

quantity is an integer 1-100, else 400 IDLE_MAX_PER_CALL. Unknown generatorId returns 400 VALIDATION_ERROR. Locked generators (unlock thresholds unmet) return 409 IDLE_GENERATOR_LOCKED. Insufficient buzz returns 409 IDLE_INSUFFICIENT_BUZZ with no partial write. Crossing 25/50 owned per generator appends milestones and grants +1 Playbook each (max 8 per run). Idempotent per idempotencyKey. Optional X-Client-Version below minClientVersion returns 403 GAME_UPDATE_REQUIRED.

## Headers

- `X-Client-Version` string

## Request body

- object
  - `generatorId` 'rookie-card' | 'foam-finger-stand' | 'zamboni-fleet' | 'banner-press', required
  - `quantity` integer, required
  - `idempotencyKey` string, uuid, required

## Response `200`

{ ledger, costPaid, playbooksGranted }

- object
  - `ledger` LedgerState, required: locker-singularity idle ledger wire state. Buzz counters are BigInt serialized as decimal strings. Additive-only wire evolution (d-sports-api#682).
    - `buzz` string, required: BigInt serialized as decimal string.
    - `lifetimeBuzz` string, required: BigInt serialized as decimal string.
    - `cumulativeBuzz` string, required: BigInt serialized as decimal string.
    - `playbooks` integer, required
    - `generators` IdleLedgerGeneratorState[], required
      - `generatorId` 'rookie-card' | 'foam-finger-stand' | 'zamboni-fleet' | 'banner-press', required
      - `owned` integer, required
    - `milestonesClaimed` string[], required
    - `upgrades` string[], required
    - `rings` integer, required: Most recent prestige grant (informational); totalRings is the cumulative balance.
    - `totalRings` integer, required
    - `prestigeCount` integer, required
    - `multiplier` number, required
    - `prestigeUnlocked` boolean, required
    - `version` integer, required
    - `lastSeenAt` string, date-time, required
  - `costPaid` string, required: BigInt serialized as decimal string.
  - `playbooksGranted` integer, required: 0 when no milestone threshold was crossed.

## Other responses

- `400`: VALIDATION_ERROR, IDLE_MAX_PER_CALL
- `401`: UNAUTHORIZED
- `403`: GAME_UPDATE_REQUIRED
- `404`: GAME_UNKNOWN
- `409`: IDLE_GENERATOR_LOCKED, IDLE_INSUFFICIENT_BUZZ

## Changes

- **2026-09-24** `01971acf764b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/engage/games/locker-singularity/ledger/buy/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
