Get a market - Compass API Docs

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();

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))

}

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>"
}

GET

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();

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))

}

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,

ethereum_sepolia

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, 'centrifuge' deRWA).

Available options:

ondo,

midas,

ixs,

centrifuge,

wisdomtree

asset_class

enum<string>

required

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

Available options:

EQUITY,

T_BILLS,

BASIS_TRADE,

BTC_YIELD,

MANAGED_VAULT,

DERWA,

MONEY_MARKET

chain

enum<string>

required

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

Available options:

base,

ethereum,

arbitrum,

hyperevm,

tempo,

bsc,

ethereum_sepolia

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.

Show child attributes

Example:

{
  "is_open": false,
  "next_open": "2026-07-06T00:05:00Z",
  "reason": "Weekend or Holiday",
  "state": "CLOSED"
}

restricted_jurisdictions

string[]

ISO country codes where this asset must not be offered (e.g. ['US']). Regulation-S instruments (Centrifuge deRWA) restrict US persons; the API surfaces the restriction for integrators to enforce — it does not itself geo-gate. Empty for unrestricted assets (Ondo/Midas/IXS).

price_history_24h

PricePoint · object[]

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

Show child attributes

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.

Show child attributes

⌘I