Tokenized Assets

Tokenized Assets lets users buy real ERC-20 tokens that represent stocks and real-world assets, and hold them in their own Tokenized Assets Account. Four issuers with different settlement models sit behind one API and one account: you always call the same endpoints and read the same positions. This is different from Perpetual Trading, where users trade contracts with leverage and own no token.

What users can buy

Family	Issuer	Examples	`asset_class`	Chain	How it trades
US equities	Ondo	`TSLAon`, `AAPLon`, `NVDAon` and 450+ more	`EQUITY`	Ethereum	Signed orders, filled by market makers
RWA yield tokens	Midas	`mTBILL` (T-bills), `mBASIS` (basis trade)	`T_BILLS`, `BASIS_TRADE`	Ethereum, Base	One transaction, at NAV
Managed vaults	IXS	`ixv1`	`MANAGED_VAULT`	BNB Smart Chain	One transaction to buy. Sells settle later
deRWA fund tokens	Centrifuge	`deSPXA` (S&P 500), `deJAAA` (AAA CLOs)	`DERWA`	Base	One transaction. Not for US persons

The markets endpoint returns the live catalog with prices, 24h change, APY and TVL for yield assets, and whether each market is open right now.

Before you start

An API key. See the Quick Start.
A Tokenized Assets Account for the user on the asset’s chain, holding USDC. See Create an Account and Fund an Account.

1. Find a market

import os
from compass_api_sdk import CompassAPI

compass = CompassAPI(api_key_auth=os.environ["COMPASS_API_KEY"])

markets = compass.tokenized_assets.tokenized_assets_markets(
    provider="ondo", search="TSLA"
).markets

for market in markets:
    print(market.symbol, market.current_price_usd, market.status.is_open)

import { CompassApiSDK } from "@compass-labs/api-sdk";

const compass = new CompassApiSDK({ apiKeyAuth: process.env.COMPASS_API_KEY });

const { markets } = await compass.tokenizedAssets.tokenizedAssetsMarkets({
  provider: "ondo",
  search: "TSLA",
});

for (const market of markets) {
  console.log(market.symbol, market.currentPriceUsd, market.status?.isOpen);
}

curl "https://api.compasslabs.ai/v2/tokenized_assets/markets?provider=ondo&search=TSLA" \
  -H "x-api-key: $COMPASS_API_KEY"

Read symbol, current_price_usd, asset_class and status.is_open. Equities follow US market hours, and status.next_open says when a closed market reopens. Filter with provider, asset_class, chain, category or search.

2. Buy

Which call you make depends on asset_class. Equities use signed orders. Everything else is one transaction.

Equities: place an order

Build the order

Buy 100 USDC of TSLAon:

build = compass.tokenized_assets.tokenized_assets_order(
    from_token="USDC",
    to_token="TSLAon",
    amount="100",
    owner="0xYourWalletAddress",
    slippage_bps=50,
)

quote = build.quote                       # expected amounts and fees
approval = build.approval_safe_tx_eip712  # only until USDC is approved
order = build.order                       # what the user signs

const build = await compass.tokenizedAssets.tokenizedAssetsOrder({
  fromToken: "USDC",
  toToken: "TSLAon",
  amount: "100",
  owner: "0xYourWalletAddress",
  slippageBps: 50,
});

const quote = build.quote; // expected amounts and fees
const approval = build.approvalSafeTxEip712; // only until USDC is approved
const order = build.order; // what the user signs

curl -X POST "https://api.compasslabs.ai/v2/tokenized_assets/order" \
  -H "x-api-key: $COMPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_token": "USDC",
    "to_token": "TSLAon",
    "amount": "100",
    "owner": "0xYourWalletAddress",
    "slippage_bps": 50
  }'

slippage_bps is in basis points: 50 is 0.5%.

Approve the input token (first order per token only)

If the response includes approval_safe_tx_eip712, the user signs it as EIP-712 typed data, and you relay it through POST /v2/gas_sponsorship/prepare with product: "tokenized_assets". Wait for that transaction to confirm before submitting the order. Later orders with the same input token skip this step.

Sign and submit the order

The user signs order.safe_message_eip712 as EIP-712 typed data. This signature never goes on-chain: it authorizes market makers to fill the order.

# What the user signs as EIP-712 typed data
typed_data = order.safe_message_eip712.model_dump(by_alias=True)
signature = "0xUserSignature"

submit = compass.tokenized_assets.tokenized_assets_order_submit(
    signed_order=order.order_message,
    signature=signature,
    extension=order.extension,
    quote_id=order.quote_id,
    order_hash=order.order_hash,
)

order_hash = submit.order_hash

// The user signs order.safeMessageEip712. The SDK camelCases the keys
// of its types (safeMessage, eip712Domain): rename them back
// (SafeMessage, EIP712Domain) before signing.
const signature = "0xUserSignature";

const submit = await compass.tokenizedAssets.tokenizedAssetsOrderSubmit({
  signedOrder: order.orderMessage,
  signature,
  extension: order.extension,
  quoteId: order.quoteId,
  orderHash: order.orderHash,
});

const orderHash = submit.orderHash;

curl -X POST "https://api.compasslabs.ai/v2/tokenized_assets/order/submit" \
  -H "x-api-key: $COMPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signed_order": { "...": "order.order_message from the build response" },
    "signature": "0xUserSignature",
    "extension": "0xOrderExtension",
    "quote_id": "OrderQuoteId",
    "order_hash": "0xOrderHash"
  }'

Pass order_message, extension and quote_id back exactly as you received them.

Poll for the fill

status = compass.tokenized_assets.tokenized_assets_order_order_hash_(
    order_hash=order_hash
)

print(status.status, status.fill_tx_hash)

const status = await compass.tokenizedAssets.tokenizedAssetsOrderOrderHash({
  orderHash,
});

console.log(status.status, status.fillTxHash);

curl "https://api.compasslabs.ai/v2/tokenized_assets/order/0xOrderHash" \
  -H "x-api-key: $COMPASS_API_KEY"

status is pending, then filled (with fill_tx_hash), expired if no market maker filled it in time, or cancelled. The tokens land in the user’s account when the order fills. To cancel a pending or expired order, call POST /v2/tokenized_assets/order/{order_hash}/cancel and relay the returned typed data like the approval.

RWA tokens, vaults and deRWA: one transaction

Buy 1,000 USDC of mTBILL on Ethereum:

buy = compass.tokenized_assets.tokenized_assets_transact_buy(
    token_in="USDC",
    token_out="mTBILL",
    amount_in="1000",
    slippage=0.5,
    owner="0xYourWalletAddress",
    chain="ethereum",
)

# buy.transaction: unsigned tx for the owner to sign and send
# buy.estimated_amount_out: expected mTBILL
# buy.settlement: "instant", or "async" when the trade settles later

const buy = await compass.tokenizedAssets.tokenizedAssetsTransactBuy({
  tokenIn: "USDC",
  tokenOut: "mTBILL",
  amountIn: "1000",
  slippage: 0.5,
  owner: "0xYourWalletAddress",
  chain: "ethereum",
});

// buy.transaction: unsigned tx for the owner to sign and send
// buy.estimatedAmountOut: expected mTBILL
// buy.settlement: "instant", or "async" when the trade settles later

curl -X POST "https://api.compasslabs.ai/v2/tokenized_assets/transact/buy" \
  -H "x-api-key: $COMPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token_in": "USDC",
    "token_out": "mTBILL",
    "amount_in": "1000",
    "slippage": 0.5,
    "owner": "0xYourWalletAddress",
    "chain": "ethereum"
  }'

For an IXS vault or a Centrifuge deRWA token, set token_out to the vault address or the token symbol from the markets list, and chain to bsc or base. slippage is in percent: 0.5 is 0.5%.

3. Track positions

positions = compass.tokenized_assets.tokenized_assets_positions(
    owner="0xYourWalletAddress", chain="ethereum"
)

print(positions.total_usd)
for position in positions.positions:
    print(position.symbol, position.balance, position.balance_usd)

const positions = await compass.tokenizedAssets.tokenizedAssetsPositions({
  owner: "0xYourWalletAddress",
  chain: "ethereum",
});

console.log(positions.totalUsd);
for (const position of positions.positions ?? []) {
  console.log(position.symbol, position.balance, position.balanceUsd);
}

curl "https://api.compasslabs.ai/v2/tokenized_assets/positions?owner=0xYourWalletAddress&chain=ethereum" \
  -H "x-api-key: $COMPASS_API_KEY"

Each position has balance, current_price_usd, balance_usd and a pnl block, and the account has a total_usd. The read is per chain: pass chain=base or chain=bsc for holdings there.

4. Sell

Equities: build an order with the equity as from_token and USDC as to_token, then submit and poll as above.
Everything else: call POST /v2/tokenized_assets/transact/sell with the token as token_in and USDC as token_out. Midas and Centrifuge sells settle in the same transaction. An IXS redemption is async: the vault operator settles it later, so poll GET /v2/tokenized_assets/redemptions until it’s finalized.

The USDC lands in the Tokenized Assets Account. Send it to the user’s wallet with transfer. See Withdraw Funds.

Good to know

Two trade flows, enforced. An RWA symbol on /order returns 422 Wrong trade flow, and an equity on /transact/buy returns 422. Branch on asset_class.
Fees. Add a fee to transact/sell to take a share of the USDC proceeds. For equities, call POST /v2/tokenized_assets/order/{order_hash}/charge_fee after a sell fills. See Embedded Fees.
Gas sponsorship. transact/buy, transact/sell and transfer accept gas_sponsorship: true. Equity approvals and cancels are always relayed through prepare. See Gas Sponsorship.
deRWA tokens are Regulation S instruments. Their markets carry restricted_jurisdictions (["US"]). The API reports it but doesn’t enforce it. Geo-gating is your responsibility.
APYs here are fractions (0.0512 is 5.12%), unlike Earn and Credit, which return percentages.
USDC on BNB Smart Chain has 18 decimals. Amounts are always in token units, so "1000" still means 1,000 USDC.

Errors

Status	Error	When
`400`	`Tokenized Assets Account not deployed`	Create the account on this chain first.
`404`	`Market not found`	Unknown symbol or token.
`409`	`Insufficient liquidity`	No market maker can fill this size. Try smaller, or retry shortly.
`410`	`Quote expired`	Build the order again.
`422`	`Slippage exceeded`	Raise `slippage_bps` or pick a more liquid market.
`422`	`Wrong trade flow`	Use the other flow for this `asset_class`.

Endpoints

Endpoint	Use it to
`GET /v2/tokenized_assets/markets`	List the catalog with prices and status.
`GET /v2/tokenized_assets/markets/{symbol}`	One market in detail, with optional price candles.
`POST /v2/tokenized_assets/order`	Build an equity order.
`POST /v2/tokenized_assets/order/submit`	Submit the signed order.
`GET /v2/tokenized_assets/order/{order_hash}`	Poll an order.
`POST /v2/tokenized_assets/transact/buy`	Buy an RWA token, vault share or deRWA token.
`POST /v2/tokenized_assets/transact/sell`	Sell one back to USDC.
`GET /v2/tokenized_assets/positions`	Holdings with prices and PnL.
`GET /v2/tokenized_assets/redemptions`	Status of IXS redemptions.

Perpetual Trading

Stocks, commodities and forex as perps, with leverage.

Embedded Fees

Earn a fee on every sale.

Gas Sponsorship

Pay gas for your users so they never need ETH.

Get Started

Products

Data

Account Lifecycle

Platform Concepts

Developer Tools

Resources

What users can buy

Before you start

1. Find a market

2. Buy

Equities: place an order

RWA tokens, vaults and deRWA: one transaction

3. Track positions

4. Sell

Good to know

Errors

Endpoints

Next

Perpetual Trading

Embedded Fees

Gas Sponsorship

​What users can buy

​Before you start

​1. Find a market

​2. Buy

​Equities: place an order

​RWA tokens, vaults and deRWA: one transaction

​3. Track positions

​4. Sell

​Good to know

​Errors

​Endpoints

​Next

Perpetual Trading

Embedded Fees

Gas Sponsorship

What users can buy

Before you start

1. Find a market

2. Buy

Equities: place an order

RWA tokens, vaults and deRWA: one transaction

3. Track positions

4. Sell

Good to know

Errors

Endpoints

Next