Skip to main content
POST
/
v2
/
tokenized_assets
/
quote
Python (SDK)
from compass_api_sdk import CompassAPI, models


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

    res = compass_api.tokenized_assets.tokenized_assets_quote(chain=models.Chain.BASE, from_token="<value>", to_token="<value>", amount="226.42", owner="<value>")

    # Handle response
    print(res)
{
  "auction_range_bps": 50,
  "quote": {
    "est_fill_seconds": 180,
    "fee": {
      "amount_usd": "0.06",
      "bps": 6
    },
    "input": {
      "amount": "100",
      "amount_usd": "100.00",
      "contract_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "symbol": "USDC"
    },
    "output": {
      "amount": "0.281678",
      "amount_usd": "99.94",
      "contract_address": "0xf6b1117ec07684D3958caD8BEb1b302bfD21103f",
      "symbol": "TSLAon"
    }
  },
  "recommended_slippage_bps": 100
}

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.

Authorizations

​
x-api-key
string
header
required

Your Compass API Key. Get your key here.

Body

application/json

Preview a buy or sell quote for a tokenized equity.

Read-only relative to Fusion: this hits /quote/receive only and does not consume a quote_id or commit an order. Use it to surface expected output, fees, and a thin-liquidity warning before the user confirms; pass the same body (plus slippage_bps) to POST /tokenized_assets/order when they do.

​
chain
enum<string>
required

Chain on which the tokenized asset trades. Currently only ethereum is supported; reserved for future xStocks venues.

Available options:
base,
ethereum,
arbitrum,
hyperevm
​
from_token
string
required

Token the sender is paying. Either an on-chain symbol (e.g. TSLAon), the literal USDC, or a 0x-prefixed token address.

Examples:

"USDC"

"WETH"

"0xA0b86a33E6441ccF30EE5DdEF1E9b652C91ac1c8"

​
to_token
string
required

Token the sender is receiving. Same accepted forms as from_token.

Examples:

"USDC"

"WETH"

"0xA0b86a33E6441ccF30EE5DdEF1E9b652C91ac1c8"

​
amount
string
required

Human-readable amount of from_token to swap (decimal string). Decimals are applied server-side.

​
owner
string
required

Wallet that owns the Tokenized Assets Account. Used to verify the account is deployed before quoting; the account address is derived deterministically from this owner.

Response

Successful Response

Preview of input/output amounts plus auction-derived risk hints.

​
quote
Quote · object
required

Preview of input/output amounts and fees. Identical shape to the quote block on POST /tokenized_assets/order.

​
recommended_slippage_bps
integer
required

Slippage tolerance in basis points (1 bp = 0.01%) the UI should echo back as slippage_bps on POST /tokenized_assets/order. Derived from Fusion's Dutch auction range (auctionEndAmount vs toTokenAmount) plus a small buffer; capped at 5000 bps.

​
auction_range_bps
integer
required

Worst-case basis-points gap between the auction's end amount and the reference quote amount. Surfaces as a thin-liquidity warning before the user signs.