Skip to content
Clear Street Clear Street
Get started
API Reference
V1
Instrument Data

Get Instrument Fundamentals

v1.instrument_data.get_instrument_fundamentals(InstrumentIDOrSymbolinstrument_id) -> InstrumentDataGetInstrumentFundamentalsResponse
GET/v1/instruments/{instrument_id}/fundamentals

Retrieves supplemental fundamentals and company profile data for an instrument.

ParametersExpand Collapse
instrument_id: InstrumentIDOrSymbol

OEMS instrument UUID

formatuuid
ReturnsExpand Collapse
class InstrumentDataGetInstrumentFundamentalsResponse: …

Supplemental fundamentals and company profile data for an instrument.

average_volume: Optional[int]

The average daily trading volume over the past 30 days

formatint64
beta: Optional[str]

The beta value, measuring the instrument’s volatility relative to the overall market

description: Optional[str]

A detailed description of the instrument or company

dividend_yield: Optional[str]

The trailing twelve months (TTM) dividend yield

earnings_per_share: Optional[str]

The trailing twelve months (TTM) earnings per share

fifty_two_week_high: Optional[str]

The highest price over the last 52 weeks

fifty_two_week_low: Optional[str]

The lowest price over the last 52 weeks

industry: Optional[str]

The specific industry of the instrument’s issuer

list_date: Optional[date]

The date the instrument was first listed

formatdate
logo_url: Optional[str]

URL to a representative logo image for the instrument or issuer

market_cap: Optional[str]

The total market capitalization

previous_close: Optional[str]

The closing price from the previous trading day

price_to_earnings: Optional[str]

The price-to-earnings (P/E) ratio for the trailing twelve months (TTM)

reporting_currency: Optional[str]

The currency used for reporting financial data

sector: Optional[str]

The business sector of the instrument’s issuer

Get Instrument Fundamentals

from clear_street import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.instrument_data.get_instrument_fundamentals(
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(response)
{
  "data": {
    "average_volume": 76000000,
    "beta": "1.20",
    "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide.",
    "dividend_yield": "0.005",
    "earnings_per_share": "5.61",
    "fifty_two_week_high": "230.00",
    "fifty_two_week_low": "165.00",
    "industry": "Consumer Electronics",
    "list_date": "1980-12-12",
    "logo_url": "https://example.com/logos/aapl.png",
    "market_cap": "2800000000000",
    "previous_close": "210.87",
    "price_to_earnings": "30.5",
    "reporting_currency": "USD",
    "sector": "Technology"
  },
  "error": null,
  "metadata": {
    "request_id": "5b6c7d8e-9f0a-1b2c-3d4e-5f6a7b8c9d0e"
  }
}
Returns Examples
{
  "data": {
    "average_volume": 76000000,
    "beta": "1.20",
    "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide.",
    "dividend_yield": "0.005",
    "earnings_per_share": "5.61",
    "fifty_two_week_high": "230.00",
    "fifty_two_week_low": "165.00",
    "industry": "Consumer Electronics",
    "list_date": "1980-12-12",
    "logo_url": "https://example.com/logos/aapl.png",
    "market_cap": "2800000000000",
    "previous_close": "210.87",
    "price_to_earnings": "30.5",
    "reporting_currency": "USD",
    "sector": "Technology"
  },
  "error": null,
  "metadata": {
    "request_id": "5b6c7d8e-9f0a-1b2c-3d4e-5f6a7b8c9d0e"
  }
}