> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwacks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Currencies & Wallets

> Define soft and hard currencies and track player balances.

export const Scope = ({children}) => <Info>
    <b>Scope:</b> {children}
  </Info>;

**Currencies** are the units your economy runs on — coins, gems, energy, or anything else. Each
game defines its own currencies; every player has a **wallet** holding their balances.

<Scope>currencies are defined per **game**; each player has a wallet of balances.</Scope>

<Tabs>
  <Tab title="Dashboard">
    Define your currencies in the dashboard — a currency is just a named unit; you decide whether
    it's earned, purchased, or both. You can also inspect player wallets here.

    <Frame caption="Define currencies and inspect player wallets in the dashboard.">
      <img src="https://mintcdn.com/qwacks/TGGmq_oWzDacAqHl/images/guides/currencies.png?fit=max&auto=format&n=TGGmq_oWzDacAqHl&q=85&s=b49bc04ab4005152a82c6bd24e2be928" alt="Currencies and wallets" width="1440" height="866" data-path="images/guides/currencies.png" />
    </Frame>
  </Tab>

  <Tab title="SDK">
    Read the signed-in player's wallet balances through the SDK. Balances change when players:

    * earn currency through gameplay,
    * purchase currency, or
    * spend it in a [shop](/guides/shops-and-inventory).

    ```
    Player wallet
     ├─ coins: 1,250
     └─ gems:     40
    ```
  </Tab>
</Tabs>

<Note>
  Shop purchases debit the relevant wallet automatically as part of the transaction — you don't
  adjust balances by hand for a normal buy.
</Note>