Skip to main content

PlayerWallet

The caller's player wallet: one platform-scoped balance, across every org and app they play in, that pays for the player's mods past their monthly trial (250,000 compute units in each app) and for any Agentic Studio model requests charged to them. Out-of-band from org wallets — player usage never touches an org's money.

type PlayerWallet {
  walletId: BigInt!
  userId: BigInt!
  balanceMicrousd: BigInt!
  holdsMicrousd: BigInt!
  balanceCents: BigInt! @deprecated
  currency: String!
  createdAt: DateTime!
}

Fields​

PlayerWallet.walletId ● BigInt! non-null scalar​

Wallet id.

PlayerWallet.userId ● BigInt! non-null scalar​

The owning player user id.

PlayerWallet.balanceMicrousd ● BigInt! non-null scalar​

Current balance in MICRO-USD (1 USD = 1,000,000). The unit of account since 2026-09-11; nothing is rounded. May go negative when accrued usage settles against an empty wallet.

PlayerWallet.holdsMicrousd ● BigInt! non-null scalar​

Micro-USD held against in-flight request-priced usage (a model turn reserves its worst case before it runs). Spendable = balanceMicrousd - holdsMicrousd.

PlayerWallet.balanceCents ● BigInt! deprecated non-null scalar​

DEPRECATED

Derived from balanceMicrousd (truncated toward zero). Read balanceMicrousd.

DEPRECATED. balanceMicrousd / 10,000 truncated toward zero.

PlayerWallet.currency ● String! non-null scalar​

ISO currency code (lowercase).

PlayerWallet.createdAt ● DateTime! non-null scalar​

Wallet creation time.

Returned By​

playerWalletBalance query