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)
{
  "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",
  "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"
}

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.

Path Parameters

​
symbol
string
required

Query Parameters

​
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

Ethereum mainnet ERC-20 address for this token.

​
decimals
integer
required

ERC-20 decimals for this token.

​
current_price_usd
string
required

Latest price in USD as a decimal string.

​
chain
enum<string>
default:ethereum

Chain on which the contract is deployed.

Available options:
ethereum
​
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']).

​
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 asset.

​
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.