Skip to content
Start Trading

Instruments

Retrieve core details and discovery endpoints for tradable instruments.

Get Instruments
v1.instruments.get_instruments(InstrumentGetInstrumentsParams**kwargs) -> InstrumentGetInstrumentsResponse
GET/v1/instruments
Get Instrument By ID
v1.instruments.get_instrument_by_id(InstrumentIDOrSymbolinstrument_id, InstrumentGetInstrumentByIDParams**kwargs) -> InstrumentGetInstrumentByIDResponse
GET/v1/instruments/{instrument_id}
Search Instruments
v1.instruments.search_instruments(InstrumentSearchInstrumentsParams**kwargs) -> InstrumentSearchInstrumentsResponse
GET/v1/instruments/search
Get Option Contracts
v1.instruments.get_option_contracts(InstrumentGetOptionContractsParams**kwargs) -> InstrumentGetOptionContractsResponse
GET/v1/instruments/options/contracts
ModelsExpand Collapse
Literal["CALL", "PUT"]

The type of options contract

One of the following:
"CALL"
"PUT"
Literal["AMERICAN", "EUROPEAN"]

The exercise style of an options contract

One of the following:
"AMERICAN"
"EUROPEAN"
class Instrument:

Represents a tradable financial instrument.

id: str

Unique instrument identifier (UUID)

formatuuid
country_of_issue: str

The ISO country code of the instrument’s issue

currency: str

The ISO currency code in which the instrument is traded

easy_to_borrow: bool

Indicates if the instrument is classified as Easy-To-Borrow

is_fractionable: bool

Indicates if the instrument supports fractional-quantity orders

is_liquidation_only: bool

Indicates if the instrument is liquidation only and cannot be bought

is_marginable: bool

Indicates if the instrument is marginable

is_ptp: bool

Indicates if the instrument is a publicly traded partnership (PTP). PTP sales are subject to a 10% withholding tax for non-US tax residents.

is_short_prohibited: bool

Indicates if short selling is prohibited for the instrument

is_threshold_security: bool

Indicates if the instrument is on the Regulation SHO Threshold Security List

is_tradable: bool

Indicates if the instrument is tradable

symbol: str

The trading symbol for the instrument

venue: str

The MIC code of the primary listing venue

adv: Optional[str]

Average daily share volume from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedexpiry: Optional[date]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

formatdate
instrument_type: Optional[SecurityType]

The type of security (e.g., Common Stock, ETF) When a null/undefined value is observed, it indicates that there is no available data.

One of the following:
"COMMON_STOCK"
"OPTION"
"CASH"
long_margin_rate: Optional[str]

The percent of a long position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

name: Optional[str]

The full name of the instrument or its issuer When a null/undefined value is observed, it indicates that there is no available data.

notional_adv: Optional[str]

Notional average daily volume (ADV multiplied by previous close price). When a null/undefined value is observed, it indicates that there is no available data.

options_expiry_dates: Optional[List[date]]

Available options expiration dates for this instrument. Present only when include_options_expiry_dates=true in the request. When a null/undefined value is observed, it indicates it does not apply.

previous_close: Optional[str]

Last close price from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

short_margin_rate: Optional[str]

The percent of a short position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedstrike_price: Optional[str]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

class InstrumentCore:
id: str

Unique instrument identifier (UUID)

formatuuid
country_of_issue: str

The ISO country code of the instrument’s issue

currency: str

The ISO currency code in which the instrument is traded

easy_to_borrow: bool

Indicates if the instrument is classified as Easy-To-Borrow

is_fractionable: bool

Indicates if the instrument supports fractional-quantity orders

is_liquidation_only: bool

Indicates if the instrument is liquidation only and cannot be bought

is_marginable: bool

Indicates if the instrument is marginable

is_ptp: bool

Indicates if the instrument is a publicly traded partnership (PTP). PTP sales are subject to a 10% withholding tax for non-US tax residents.

is_short_prohibited: bool

Indicates if short selling is prohibited for the instrument

is_threshold_security: bool

Indicates if the instrument is on the Regulation SHO Threshold Security List

is_tradable: bool

Indicates if the instrument is tradable

symbol: str

The trading symbol for the instrument

venue: str

The MIC code of the primary listing venue

adv: Optional[str]

Average daily share volume from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedexpiry: Optional[date]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

formatdate
instrument_type: Optional[SecurityType]

The type of security (e.g., Common Stock, ETF) When a null/undefined value is observed, it indicates that there is no available data.

One of the following:
"COMMON_STOCK"
"OPTION"
"CASH"
long_margin_rate: Optional[str]

The percent of a long position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

name: Optional[str]

The full name of the instrument or its issuer When a null/undefined value is observed, it indicates that there is no available data.

notional_adv: Optional[str]

Notional average daily volume (ADV multiplied by previous close price). When a null/undefined value is observed, it indicates that there is no available data.

previous_close: Optional[str]

Last close price from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

short_margin_rate: Optional[str]

The percent of a short position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedstrike_price: Optional[str]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

id: str

Unique instrument identifier (UUID)

formatuuid
country_of_issue: str

The ISO country code of the instrument’s issue

currency: str

The ISO currency code in which the instrument is traded

easy_to_borrow: bool

Indicates if the instrument is classified as Easy-To-Borrow

is_fractionable: bool

Indicates if the instrument supports fractional-quantity orders

is_liquidation_only: bool

Indicates if the instrument is liquidation only and cannot be bought

is_marginable: bool

Indicates if the instrument is marginable

is_ptp: bool

Indicates if the instrument is a publicly traded partnership (PTP). PTP sales are subject to a 10% withholding tax for non-US tax residents.

is_short_prohibited: bool

Indicates if short selling is prohibited for the instrument

is_threshold_security: bool

Indicates if the instrument is on the Regulation SHO Threshold Security List

is_tradable: bool

Indicates if the instrument is tradable

symbol: str

The trading symbol for the instrument

venue: str

The MIC code of the primary listing venue

adv: Optional[str]

Average daily share volume from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedexpiry: Optional[date]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

formatdate
instrument_type: Optional[SecurityType]

The type of security (e.g., Common Stock, ETF) When a null/undefined value is observed, it indicates that there is no available data.

One of the following:
"COMMON_STOCK"
"OPTION"
"CASH"
long_margin_rate: Optional[str]

The percent of a long position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

name: Optional[str]

The full name of the instrument or its issuer When a null/undefined value is observed, it indicates that there is no available data.

notional_adv: Optional[str]

Notional average daily volume (ADV multiplied by previous close price). When a null/undefined value is observed, it indicates that there is no available data.

previous_close: Optional[str]

Last close price from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

short_margin_rate: Optional[str]

The percent of a short position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedstrike_price: Optional[str]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

Literal["STANDARD", "FLEX", "OTC"]

The listing type of an options contract

One of the following:
"STANDARD"
"FLEX"
"OTC"
class OptionsContract:

An options contract with options-specific metadata

id: str

Instrument identifier

formatuuid
contract_type: ContractType

Whether this is a CALL or PUT

One of the following:
"CALL"
"PUT"
currency: str

ISO currency code

exchange: str

MIC code of the primary listing venue

exercise_style: ExerciseStyle

Exercise style

One of the following:
"AMERICAN"
"EUROPEAN"
expiry: date

Expiration date

formatdate
is_liquidation_only: bool

Whether the contract is liquidation-only

is_marginable: bool

Whether the contract is marginable

listing_type: ListingType

Listing type

One of the following:
"STANDARD"
"FLEX"
"OTC"
multiplier: str

Contract multiplier (100 for standard options)

strike_price: str

Strike price

symbol: str

OSI symbol (e.g. “AAPL 251219C00150000”)

open_interest: Optional[int]

Open interest (number of outstanding contracts), if available When a null/undefined value is observed, it indicates that there is no available data.

formatint64
underlying_instrument_id: Optional[str]

Instrument ID of the underlying instrument, when available When a null/undefined value is observed, it indicates that there is no available data.

formatuuid
id: str

Instrument identifier

formatuuid
contract_type: ContractType

Whether this is a CALL or PUT

One of the following:
"CALL"
"PUT"
currency: str

ISO currency code

exchange: str

MIC code of the primary listing venue

exercise_style: ExerciseStyle

Exercise style

One of the following:
"AMERICAN"
"EUROPEAN"
expiry: date

Expiration date

formatdate
is_liquidation_only: bool

Whether the contract is liquidation-only

is_marginable: bool

Whether the contract is marginable

listing_type: ListingType

Listing type

One of the following:
"STANDARD"
"FLEX"
"OTC"
multiplier: str

Contract multiplier (100 for standard options)

strike_price: str

Strike price

symbol: str

OSI symbol (e.g. “AAPL 251219C00150000”)

open_interest: Optional[int]

Open interest (number of outstanding contracts), if available When a null/undefined value is observed, it indicates that there is no available data.

formatint64
underlying_instrument_id: Optional[str]

Instrument ID of the underlying instrument, when available When a null/undefined value is observed, it indicates that there is no available data.

formatuuid
class InstrumentGetInstrumentsResponse:
id: str

Unique instrument identifier (UUID)

formatuuid
country_of_issue: str

The ISO country code of the instrument’s issue

currency: str

The ISO currency code in which the instrument is traded

easy_to_borrow: bool

Indicates if the instrument is classified as Easy-To-Borrow

is_fractionable: bool

Indicates if the instrument supports fractional-quantity orders

is_liquidation_only: bool

Indicates if the instrument is liquidation only and cannot be bought

is_marginable: bool

Indicates if the instrument is marginable

is_ptp: bool

Indicates if the instrument is a publicly traded partnership (PTP). PTP sales are subject to a 10% withholding tax for non-US tax residents.

is_short_prohibited: bool

Indicates if short selling is prohibited for the instrument

is_threshold_security: bool

Indicates if the instrument is on the Regulation SHO Threshold Security List

is_tradable: bool

Indicates if the instrument is tradable

symbol: str

The trading symbol for the instrument

venue: str

The MIC code of the primary listing venue

adv: Optional[str]

Average daily share volume from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedexpiry: Optional[date]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

formatdate
instrument_type: Optional[SecurityType]

The type of security (e.g., Common Stock, ETF) When a null/undefined value is observed, it indicates that there is no available data.

One of the following:
"COMMON_STOCK"
"OPTION"
"CASH"
long_margin_rate: Optional[str]

The percent of a long position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

name: Optional[str]

The full name of the instrument or its issuer When a null/undefined value is observed, it indicates that there is no available data.

notional_adv: Optional[str]

Notional average daily volume (ADV multiplied by previous close price). When a null/undefined value is observed, it indicates that there is no available data.

previous_close: Optional[str]

Last close price from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

short_margin_rate: Optional[str]

The percent of a short position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedstrike_price: Optional[str]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

class InstrumentGetInstrumentByIDResponse:

Represents a tradable financial instrument.

id: str

Unique instrument identifier (UUID)

formatuuid
country_of_issue: str

The ISO country code of the instrument’s issue

currency: str

The ISO currency code in which the instrument is traded

easy_to_borrow: bool

Indicates if the instrument is classified as Easy-To-Borrow

is_fractionable: bool

Indicates if the instrument supports fractional-quantity orders

is_liquidation_only: bool

Indicates if the instrument is liquidation only and cannot be bought

is_marginable: bool

Indicates if the instrument is marginable

is_ptp: bool

Indicates if the instrument is a publicly traded partnership (PTP). PTP sales are subject to a 10% withholding tax for non-US tax residents.

is_short_prohibited: bool

Indicates if short selling is prohibited for the instrument

is_threshold_security: bool

Indicates if the instrument is on the Regulation SHO Threshold Security List

is_tradable: bool

Indicates if the instrument is tradable

symbol: str

The trading symbol for the instrument

venue: str

The MIC code of the primary listing venue

adv: Optional[str]

Average daily share volume from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedexpiry: Optional[date]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

formatdate
instrument_type: Optional[SecurityType]

The type of security (e.g., Common Stock, ETF) When a null/undefined value is observed, it indicates that there is no available data.

One of the following:
"COMMON_STOCK"
"OPTION"
"CASH"
long_margin_rate: Optional[str]

The percent of a long position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

name: Optional[str]

The full name of the instrument or its issuer When a null/undefined value is observed, it indicates that there is no available data.

notional_adv: Optional[str]

Notional average daily volume (ADV multiplied by previous close price). When a null/undefined value is observed, it indicates that there is no available data.

options_expiry_dates: Optional[List[date]]

Available options expiration dates for this instrument. Present only when include_options_expiry_dates=true in the request. When a null/undefined value is observed, it indicates it does not apply.

previous_close: Optional[str]

Last close price from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

short_margin_rate: Optional[str]

The percent of a short position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedstrike_price: Optional[str]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

class InstrumentSearchInstrumentsResponse:
id: str

Unique instrument identifier (UUID)

formatuuid
country_of_issue: str

The ISO country code of the instrument’s issue

currency: str

The ISO currency code in which the instrument is traded

easy_to_borrow: bool

Indicates if the instrument is classified as Easy-To-Borrow

is_fractionable: bool

Indicates if the instrument supports fractional-quantity orders

is_liquidation_only: bool

Indicates if the instrument is liquidation only and cannot be bought

is_marginable: bool

Indicates if the instrument is marginable

is_ptp: bool

Indicates if the instrument is a publicly traded partnership (PTP). PTP sales are subject to a 10% withholding tax for non-US tax residents.

is_short_prohibited: bool

Indicates if short selling is prohibited for the instrument

is_threshold_security: bool

Indicates if the instrument is on the Regulation SHO Threshold Security List

is_tradable: bool

Indicates if the instrument is tradable

symbol: str

The trading symbol for the instrument

venue: str

The MIC code of the primary listing venue

adv: Optional[str]

Average daily share volume from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedexpiry: Optional[date]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

formatdate
instrument_type: Optional[SecurityType]

The type of security (e.g., Common Stock, ETF) When a null/undefined value is observed, it indicates that there is no available data.

One of the following:
"COMMON_STOCK"
"OPTION"
"CASH"
long_margin_rate: Optional[str]

The percent of a long position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

name: Optional[str]

The full name of the instrument or its issuer When a null/undefined value is observed, it indicates that there is no available data.

notional_adv: Optional[str]

Notional average daily volume (ADV multiplied by previous close price). When a null/undefined value is observed, it indicates that there is no available data.

previous_close: Optional[str]

Last close price from the security definition. When a null/undefined value is observed, it indicates that there is no available data.

short_margin_rate: Optional[str]

The percent of a short position’s value you must post as margin When a null/undefined value is observed, it indicates that there is no available data.

Deprecatedstrike_price: Optional[str]

Deprecated. Always null. When a null/undefined value is observed, it indicates it does not apply.

class InstrumentGetOptionContractsResponse:
id: str

Instrument identifier

formatuuid
contract_type: ContractType

Whether this is a CALL or PUT

One of the following:
"CALL"
"PUT"
currency: str

ISO currency code

exchange: str

MIC code of the primary listing venue

exercise_style: ExerciseStyle

Exercise style

One of the following:
"AMERICAN"
"EUROPEAN"
expiry: date

Expiration date

formatdate
is_liquidation_only: bool

Whether the contract is liquidation-only

is_marginable: bool

Whether the contract is marginable

listing_type: ListingType

Listing type

One of the following:
"STANDARD"
"FLEX"
"OTC"
multiplier: str

Contract multiplier (100 for standard options)

strike_price: str

Strike price

symbol: str

OSI symbol (e.g. “AAPL 251219C00150000”)

open_interest: Optional[int]

Open interest (number of outstanding contracts), if available When a null/undefined value is observed, it indicates that there is no available data.

formatint64
underlying_instrument_id: Optional[str]

Instrument ID of the underlying instrument, when available When a null/undefined value is observed, it indicates that there is no available data.

formatuuid