Skip to main content
GET
/
v2
/
tokenized_assets
/
balances
Python (SDK)
from compass_api_sdk import CompassAPI


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.tokenized_assets.tokenized_assets_balances(owner="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B")

    # Handle response
    print(res)
{
  "tokenized_assets_account_address": "<string>",
  "balances": {},
  "total_usd_value": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Your Compass API Key. Get your key here.

Query Parameters

​
owner
string
default:0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B
required

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.

​
chain
enum<string>

Network to read balances on (defaults to Ethereum). Equities exist on Ethereum only; RWA yield assets also exist on Base. The chain to use.

Available options:
base,
ethereum,
arbitrum,
hyperevm,
tempo

Response

Successful Response

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.

​
tokenized_assets_account_address
string
required

The derived Tokenized Assets Account address.

Example:

"0xA4Dc919c61fDAA100AC9aB8Fae4A2d725165C181"

​
balances
Balances · object

Token balances keyed by symbol. Each entry includes the current balance, its USD value, and transfer history.

​
total_usd_value
string | null

Total USD value of all priced balances.