Skip to main content
GET
/
v2
/
tokenized_assets
/
markets
/
{symbol}
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_markets_symbol_(symbol="<value>")

    # Handle response
    print(res)
import { CompassApiSDK } from "@compass-labs/api-sdk";

const compassApiSDK = new CompassApiSDK({
apiKeyAuth: "<YOUR_API_KEY_HERE>",
});

async function run() {
const result = await compassApiSDK.tokenizedAssets.tokenizedAssetsMarketsSymbol({
symbol: "<value>",
});

console.log(result);
}

run();
curl --request GET \
--url https://api.compasslabs.ai/v2/tokenized_assets/markets/{symbol} \
--header 'x-api-key: <api-key>'
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.compasslabs.ai/v2/tokenized_assets/markets/{symbol}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.compasslabs.ai/v2/tokenized_assets/markets/{symbol}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.compasslabs.ai/v2/tokenized_assets/markets/{symbol}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("x-api-key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.compasslabs.ai/v2/tokenized_assets/markets/{symbol}")
.header("x-api-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.compasslabs.ai/v2/tokenized_assets/markets/{symbol}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "asset_class": "EQUITY",
  "average_volume": "92840100",
  "candles": [
    {
      "close": "353.10",
      "high": "354.27",
      "low": "350.92",
      "open": "351.40",
      "timestamp": "2026-05-04T08:00:00Z"
    },
    {
      "close": "354.05",
      "high": "355.18",
      "low": "352.74",
      "open": "353.10",
      "timestamp": "2026-05-04T09:00:00Z"
    }
  ],
  "chain": "ethereum",
  "change_24h_pct": "1.49",
  "change_24h_usd": "5.21",
  "contract_address": "0xf6b1117ec07684D3958caD8BEb1b302bfD21103f",
  "current_price_usd": "354.82",
  "decimals": 18,
  "market_cap": "1135000000000",
  "name": "Tesla, Inc.",
  "price_high_52w": "488.54",
  "price_history_24h": [
    {
      "price": "349.61",
      "timestamp": "2026-05-03T20:00:00Z"
    },
    {
      "price": "351.07",
      "timestamp": "2026-05-04T00:00:00Z"
    },
    {
      "price": "352.94",
      "timestamp": "2026-05-04T04:00:00Z"
    },
    {
      "price": "354.10",
      "timestamp": "2026-05-04T08:00:00Z"
    },
    {
      "price": "354.82",
      "timestamp": "2026-05-04T12:00:00Z"
    }
  ],
  "price_low_52w": "138.80",
  "provider": "ondo",
  "region_exposure": [
    "US"
  ],
  "sectors": [
    "Consumer Discretionary"
  ],
  "shares_multiplier": "1",
  "shares_outstanding": "3198000000",
  "symbol": "TSLAon",
  "total_holders": 1842,
  "tradable_sessions": [
    "regular",
    "premarket",
    "afterhours"
  ],
  "underlying_ticker": "TSLA",
  "volume_24h": "84231590"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}
{
"error": "<string>",
"message": "<string>"
}

Authorizations

x-api-key
string
header
required

Your Compass API Key. Get your key here.

Path Parameters

symbol
string
required

Query Parameters

chain
enum<string>

Network the market is deployed on (defaults to Ethereum). A token deployed on multiple chains (e.g. Midas RWA on Ethereum and Base) is resolved per chain; 404 if the symbol isn't deployed there. Ondo equities are Ethereum-only. The chain to use.

Available options:
base,
ethereum,
arbitrum,
hyperevm,
tempo,
bsc
interval
enum<string> | null

Optional candle interval. Must be paired with range and form a valid (interval, range) pair to include OHLC candles in the response.

Available options:
1min,
5min,
15min,
1hour,
4hour,
12hour,
1day
range
enum<string> | null

Optional lookback window. Must be paired with interval and form a valid (interval, range) pair to include OHLC candles in the response.

Available options:
1day,
1month,
3month,
6month,
1year,
all

Response

Successful Response

Extended market view returned when fetching a single market.

symbol
string
required

On-chain token symbol (e.g. 'TSLAon').

underlying_ticker
string
required

Underlying equity ticker (e.g. 'TSLA').

name
string
required

Underlying equity full name (e.g. 'Tesla, Inc. Common Stock').

contract_address
string
required

On-chain ERC-20 address for this token, on the network given by chain.

decimals
integer
required

ERC-20 decimals for this token.

current_price_usd
string
required

Latest price in USD as a decimal string.

provider
enum<string>
required

Issuer of this tokenized asset ('ondo' equities, 'midas' RWA yield, 'ixs' managed vaults).

Available options:
ondo,
midas,
ixs
asset_class
enum<string>
required

Asset class. EQUITY trades via the order endpoints; the RWA yield classes and MANAGED_VAULT trade via transact/buy and transact/sell.

Available options:
EQUITY,
T_BILLS,
BASIS_TRADE,
BTC_YIELD,
MANAGED_VAULT
chain
enum<string>
required

Network the contract_address lives on (e.g. 'ethereum', 'base', 'bsc').

Available options:
base,
ethereum,
arbitrum,
hyperevm,
tempo,
bsc
change_24h_usd
string | null

Absolute USD price change vs 24h ago (decimal string).

change_24h_pct
string | null

Percent price change vs 24h ago (decimal string).

sectors
string[]

Sector / industry tags from the issuer (e.g. ['Technology']).

region_exposure
string[]

Regional market exposure tags (e.g. ['US']).

apy_7d
string | null

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
string | null

Trailing 30-day annualized NAV growth (decimal fraction string). RWA yield assets only; null until enough NAV history exists.

tvl_usd
string | null

Total value locked in USD (RWA yield assets only).

status
TradingStatus · object | null

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.

Example:
{
"is_open": false,
"next_open": "2026-07-06T00:05:00Z",
"reason": "Weekend or Holiday",
"state": "CLOSED"
}
price_history_24h
PricePoint · object[]

24h price sparkline as (timestamp, price) samples in chronological order.

price_high_52w
string | null

52-week high of the underlying equity (USD).

price_low_52w
string | null

52-week low of the underlying equity (USD).

volume_24h
string | null

24h trading volume of the underlying equity.

average_volume
string | null

Average trading volume of the underlying equity.

shares_outstanding
string | null

Shares outstanding of the underlying equity.

market_cap
string | null

Market cap of the underlying equity (USD).

total_holders
integer | null

On-chain holder count for the tokenized equity.

tradable_sessions
string[]

Sessions in which the token can be traded (e.g. 'regular', 'premarket').

shares_multiplier
string | null

Shares-multiplier ratio (= 1 if no recent split / corporate action).

candles
OhlcCandle · object[] | null

OHLC candles. Present only when both interval and range query params are provided and form a valid pair; omitted otherwise.