> ## Documentation Index > Fetch the complete documentation index at: https://docs.compasslabs.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get token balances > Get a Tokenized Assets Account's full token ledger. Returns every token the account has held — including zero balances from fully-exited positions and USDC funding — each with its USD value and transfer history (a superset of `/positions`). Pass `chain=base` or `chain=bsc` for Base or BNB Smart Chain holdings. ## OpenAPI ````yaml /v2/combined_spec.json get /v2/tokenized_assets/balances openapi: 3.1.0 info: title: Compass API description: Compass Labs DeFi API version: 0.0.1 servers: - url: https://api.compasslabs.ai description: Production server security: - ApiKeyAuth: [] paths: /v2/tokenized_assets/balances: get: tags: - Tokenized Assets summary: Get token balances description: >- Get a Tokenized Assets Account's full token ledger. Returns every token the account has held — including zero balances from fully-exited positions and USDC funding — each with its USD value and transfer history (a superset of `/positions`). Pass `chain=base` or `chain=bsc` for Base or BNB Smart Chain holdings. operationId: v2_tokenized_assets_balances parameters: - name: owner in: query required: true schema: type: string title: Owner default: '0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B' description: >- The address of the owner of the Tokenized Assets Account to read balances for. The account address is derived deterministically from this owner; balances are read from the derived account. - name: chain in: query required: false schema: type: string enum: - base - ethereum - arbitrum - hyperevm - tempo - bsc title: Chain description: The chain to use. description: >- Network to read balances on (defaults to Ethereum). Equities exist on Ethereum only; RWA yield assets also exist on Base. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TokenizedAssetsBalancesResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' x-codeSamples: - lang: python label: Python (SDK) source: |- from compass_api_sdk import CompassAPI with CompassAPI( api_key_auth="", ) as compass_api: res = compass_api.tokenized_assets.tokenized_assets_balances(owner="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B") # Handle response print(res) - lang: typescript label: Typescript (SDK) source: |- import { CompassApiSDK } from "@compass-labs/api-sdk"; const compassApiSDK = new CompassApiSDK({ apiKeyAuth: "", }); async function run() { const result = await compassApiSDK.tokenizedAssets.tokenizedAssetsBalances({ owner: "0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B", }); console.log(result); } run(); components: schemas: TokenizedAssetsBalancesResponse: properties: tokenized_assets_account_address: type: string title: Tokenized Assets Account Address description: The derived Tokenized Assets Account address. examples: - '0xA4Dc919c61fDAA100AC9aB8Fae4A2d725165C181' balances: additionalProperties: $ref: >- #/components/schemas/compass__api_backend__v2__models__balances__TokenBalance type: object title: Balances description: >- Token balances keyed by symbol. Each entry includes the current balance, its USD value, and transfer history. total_usd_value: anyOf: - type: string - type: 'null' title: Total Usd Value description: Total USD value of all priced balances. type: object required: - tokenized_assets_account_address title: TokenizedAssetsBalancesResponse description: >- Token balances and transfer history for a Tokenized Assets Account. Each token held in the account is keyed by symbol with its current balance, USD value, and transfer history. Uses the same `TokenBalance`/`TokenTransfer` shape as the earn and credit balances endpoints. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError compass__api_backend__v2__models__balances__TokenBalance: properties: token_address: type: string title: Token Address description: The token contract address. examples: - '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' token_symbol: type: string title: Token Symbol description: The token symbol (e.g., 'USDC'). examples: - USDC token_decimals: type: integer title: Token Decimals description: The token's decimal places. examples: - 6 balance: type: string title: Balance description: The current on-chain balance (raw). examples: - '70710737' balance_formatted: type: string title: Balance Formatted description: The human-readable balance. examples: - '70.710737' usd_value: anyOf: - type: string - type: 'null' title: Usd Value description: Balance value in USD (null if price unavailable). examples: - '70.77' transfers: items: $ref: '#/components/schemas/TokenTransfer' type: array title: Transfers description: List of all transfers involving this token. type: object required: - token_address - token_symbol - token_decimals - balance - balance_formatted title: TokenBalance description: Balance and transfer history for a single token. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError TokenTransfer: properties: from_address: type: string title: From Address description: The address tokens were sent from. examples: - '0x111111125421cA6dc452d289314280a0f8842A65' to_address: type: string title: To Address description: The address tokens were sent to. examples: - '0xA4Dc919c61fDAA100AC9aB8Fae4A2d725165C181' amount: type: string title: Amount description: The raw transfer amount (in token's smallest unit). examples: - '70710737' amount_formatted: type: string title: Amount Formatted description: The human-readable transfer amount. examples: - '70.710737' block_number: type: integer title: Block Number description: The block number of the transfer. examples: - 43830869 block_timestamp: type: string format: date-time title: Block Timestamp description: The timestamp of the transfer. examples: - '2026-03-25T15:04:45Z' transaction_hash: type: string title: Transaction Hash description: The transaction hash of the transfer. examples: - '0x949969bf49c100beca5d05bebbc99a57608a6d1f7472c621f3b00a5987bb417a' direction: type: string enum: - in - out title: Direction description: >- Direction relative to the product account: 'in' for received, 'out' for sent. examples: - in type: object required: - from_address - to_address - amount - amount_formatted - block_number - block_timestamp - transaction_hash - direction title: TokenTransfer description: A single ERC20 token transfer event. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your Compass API Key. Get your key [here](https://www.compasslabs.ai/dashboard). ````