> For the complete documentation index, see [llms.txt](https://p00ls.gitbook.io/token-os/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://p00ls.gitbook.io/token-os/wallet-api/balances.md).

# Balances

### The balance object

This object represents the balance of one of your holders.  This balance merges the following sources of information:

* **Off-Chain Balance.** This balance represents any $TOKENs a user has been allocated, but has not yet claimed.
* **On-Chain Balance.**  This balance represents $TOKENs within the user's wallet.

### Retrieve balance

{% openapi src="/files/1ZufwT7kT9H2fuk8bljn" path="/wallets/{userId}/balance" method="get" %}
[wallet-api.yaml](https://2025772754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKOyoBDhx8ymvd9xgu92d%2Fuploads%2FPmDqNaxOC2MxYZ9YprNW%2Fwallet-api.yaml?alt=media\&token=ae9da10b-ca04-4a1a-9edf-a9a27adfa4ff)
{% endopenapi %}