> ## 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. # List markets > List the tradable tokenized-asset catalog. Aggregates all three providers — Ondo (tokenized US equities), Midas (RWA yield tokens), and IXS (managed vaults) — into a single list with live USD pricing, plus APY and TVL for yield assets. Filter by provider, asset class, or chain, and narrow the results with a sector `category` or free-text `search`. ## OpenAPI ````yaml /v2/combined_spec.json get /v2/tokenized_assets/markets 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/markets: get: tags: - Tokenized Assets summary: List markets description: >- List the tradable tokenized-asset catalog. Aggregates all three providers — Ondo (tokenized US equities), Midas (RWA yield tokens), and IXS (managed vaults) — into a single list with live USD pricing, plus APY and TVL for yield assets. Filter by provider, asset class, or chain, and narrow the results with a sector `category` or free-text `search`. operationId: v2_tokenized_assets_markets parameters: - name: category in: query required: false schema: anyOf: - type: string - type: 'null' title: Category default: null description: Filter markets by category (e.g. 'tech', 'finance'). - name: search in: query required: false schema: anyOf: - type: string - type: 'null' title: Search default: null description: >- Case-insensitive substring match against the on-chain symbol, underlying ticker, and underlying name. - name: provider in: query required: false schema: anyOf: - $ref: '#/components/schemas/TokenizedAssetProvider' - type: 'null' title: Provider default: null description: Filter by issuer ('ondo' equities, 'midas' RWA yield). - name: asset_class in: query required: false schema: anyOf: - $ref: '#/components/schemas/TokenizedAssetClass' - type: 'null' title: Asset Class default: null description: Filter by asset class (EQUITY, T_BILLS, BASIS_TRADE, BTC_YIELD). - name: chain in: query required: false schema: anyOf: - $ref: '#/components/schemas/Chain' - type: 'null' title: Chain default: null description: >- Filter by network. Equities are Ethereum-only; RWA yield assets exist on Ethereum and Base. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TokenizedAssetsMarketsListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: '`ONDO_API_UNAVAILABLE` — upstream provider is unavailable.' content: application/json: schema: $ref: '#/components/schemas/TokenizedAssetsErrorResponse' 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_markets() # 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.tokenizedAssetsMarkets({}); console.log(result); } run(); components: schemas: TokenizedAssetProvider: type: string enum: - ondo - midas - ixs title: TokenizedAssetProvider description: Issuer/provider of a tokenized asset. TokenizedAssetClass: type: string enum: - EQUITY - T_BILLS - BASIS_TRADE - BTC_YIELD - MANAGED_VAULT title: TokenizedAssetClass description: >- Asset class of a tokenized asset. `EQUITY` trades via the order endpoints (build/submit/cancel); the RWA yield classes (`T_BILLS`, `BASIS_TRADE`, `BTC_YIELD`) and `MANAGED_VAULT` trade via the swap-based `transact/buy` and `transact/sell` endpoints. `MANAGED_VAULT` (IXS ERC-4626 vaults) is special in that a sell is an *asynchronous* redemption request settled off-chain by the vault operator. Chain: type: string enum: - base - ethereum - arbitrum - hyperevm - tempo - bsc title: Chain description: The chain to use. TokenizedAssetsMarketsListResponse: properties: markets: items: $ref: >- #/components/schemas/compass__api_backend__v2__models__tokenized_assets__market__Market type: array title: Markets description: Tokenized equity markets surfaced on Ethereum. type: object required: - markets title: TokenizedAssetsMarketsListResponse description: List of tokenized equity markets. example: markets: - change_24h_pct: '1.49' change_24h_usd: '5.21' contract_address: '0xf6b1117ec07684D3958caD8BEb1b302bfD21103f' current_price_usd: '354.82' decimals: 18 name: Tesla, Inc. region_exposure: - US sectors: - Consumer Discretionary symbol: TSLAon underlying_ticker: TSLA - change_24h_pct: '-0.46' change_24h_usd: '-1.07' contract_address: '0x6cdcF8C170552DCA1a4dD8Bb1aB6dB7e7E0bF7c4' current_price_usd: '229.13' decimals: 18 name: Apple Inc. region_exposure: - US sectors: - Technology symbol: AAPLon underlying_ticker: AAPL - change_24h_pct: '2.16' change_24h_usd: '2.92' contract_address: '0x9c3F4D8F9eC6c1F9aB1f2C3D4E5F60718293A4B5' current_price_usd: '138.41' decimals: 18 name: NVIDIA Corporation region_exposure: - US sectors: - Technology symbol: NVDAon underlying_ticker: NVDA HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TokenizedAssetsErrorResponse: properties: error: type: string title: Error description: >- Short human-readable error label (e.g. `Market not found.`, `Insufficient liquidity`, `Order not found.`). message: type: string title: Message description: Human-readable explanation. type: object required: - error - message title: TokenizedAssetsErrorResponse description: >- Standard error envelope returned by every non-2xx response. Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. compass__api_backend__v2__models__tokenized_assets__market__Market: properties: symbol: type: string title: Symbol description: On-chain token symbol (e.g. 'TSLAon'). underlying_ticker: type: string title: Underlying Ticker description: Underlying equity ticker (e.g. 'TSLA'). name: type: string title: Name description: Underlying equity full name (e.g. 'Tesla, Inc. Common Stock'). contract_address: type: string title: Contract Address description: >- On-chain ERC-20 address for this token, on the network given by `chain`. decimals: type: integer title: Decimals description: ERC-20 decimals for this token. current_price_usd: type: string title: Current Price Usd description: Latest price in USD as a decimal string. change_24h_usd: anyOf: - type: string - type: 'null' title: Change 24H Usd description: Absolute USD price change vs 24h ago (decimal string). change_24h_pct: anyOf: - type: string - type: 'null' title: Change 24H Pct description: Percent price change vs 24h ago (decimal string). sectors: items: type: string type: array title: Sectors description: Sector / industry tags from the issuer (e.g. ['Technology']). default: [] region_exposure: items: type: string type: array title: Region Exposure description: Regional market exposure tags (e.g. ['US']). default: [] provider: $ref: '#/components/schemas/TokenizedAssetProvider' description: >- Issuer of this tokenized asset ('ondo' equities, 'midas' RWA yield, 'ixs' managed vaults). asset_class: $ref: '#/components/schemas/TokenizedAssetClass' description: >- Asset class. EQUITY trades via the order endpoints; the RWA yield classes and MANAGED_VAULT trade via transact/buy and transact/sell. chain: $ref: '#/components/schemas/Chain' description: >- Network the `contract_address` lives on (e.g. 'ethereum', 'base', 'bsc'). apy_7d: anyOf: - type: string - type: 'null' title: Apy 7D description: >- Trailing 7-day annualized NAV growth (decimal fraction string, e.g. '0.0512' = 5.12%). RWA yield assets only; null until enough NAV history exists. apy_30d: anyOf: - type: string - type: 'null' title: Apy 30D description: >- Trailing 30-day annualized NAV growth (decimal fraction string). RWA yield assets only; null until enough NAV history exists. tvl_usd: anyOf: - type: string - type: 'null' title: Tvl Usd description: Total value locked in USD (RWA yield assets only). status: anyOf: - $ref: '#/components/schemas/TradingStatus' - type: 'null' description: >- Live tradability: whether this market can be traded right now, and if not, why (and when it reopens). Equities follow US market sessions (some are 24-7 via an off-hours track); RWA yield / vault assets trade continuously unless the issuer pauses. Null if status is unavailable. type: object required: - symbol - underlying_ticker - name - contract_address - decimals - current_price_usd - provider - asset_class - chain title: Market description: Compact market entry returned in list responses. example: asset_class: EQUITY chain: ethereum change_24h_pct: '1.49' change_24h_usd: '5.21' contract_address: '0xf6b1117ec07684D3958caD8BEb1b302bfD21103f' current_price_usd: '354.82' decimals: 18 name: Tesla, Inc. provider: ondo region_exposure: - US sectors: - Consumer Discretionary symbol: TSLAon underlying_ticker: TSLA 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 TradingStatus: properties: is_open: type: boolean title: Is Open description: True if the market can be traded right now. state: $ref: '#/components/schemas/TradingState' description: >- OPEN, CLOSED (outside hours), PAUSED (halted), or LIMITED (tradable but restricted). reason: anyOf: - type: string - type: 'null' title: Reason description: >- Why the market is not fully open (e.g. 'Weekend or Holiday', 'cash_dividend'). Null when open. session: anyOf: - type: string - type: 'null' title: Session description: >- Active trading session for equities when open ('regular', 'premarket', 'postmarket', 'overnight', 'offhours'). Null for RWA/vault assets or when closed. next_open: anyOf: - type: string - type: 'null' title: Next Open description: >- ISO 8601 UTC time the market next opens. Null when open now or unknown. next_close: anyOf: - type: string - type: 'null' title: Next Close description: >- ISO 8601 UTC time the market next closes. Null when closed now or unknown. type: object required: - is_open - state title: TradingStatus description: Whether a tokenized market can be traded right now, and if not, why. example: is_open: false next_open: '2026-07-06T00:05:00Z' reason: Weekend or Holiday state: CLOSED TradingState: type: string enum: - OPEN - CLOSED - PAUSED - LIMITED title: TradingState description: Coarse tradability state for a tokenized market. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your Compass API Key. Get your key [here](https://www.compasslabs.ai/dashboard). ````