Skip to main content
GET
Retrieve an instrument

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id_or_symbol
string
required

The ID or symbol of the instrument to retrieve.

Response

OK

days_to_maturity
integer
required

Calendar days remaining until maturity.

Example:

182

decimal_precision
integer
required

Decimal places used by the trading increment.

Example:

2

enforce_trading_rules
boolean
required

Whether order amounts must satisfy the instrument trading rules.

id
string
required

Unique resource identifier.

initial_auction_date
string<date> | null
required

Date of the first auction.

Example:

"2024-12-30"

initial_issue_date
string<date>
required

Date the instrument was first issued.

Example:

"2025-01-02"

instrument_type
any
required

Instrument type.

isin
string
required

International Securities Identification Number.

Example:

"US5949181045"

issuer
string
required

Name of the issuer.

Example:

"United States Department of the Treasury"

issuer_country
string | null
required

ISO 3166-1 alpha-2 country code of the issuer.

Example:

"US"

issuer_credit_rating
string
required

Issuer credit rating.

Example:

"AA+"

latest_auction_date
string<date> | null
required

Date of the latest auction, including tap issues.

Example:

"2025-01-27"

latest_issue_date
string<date> | null
required

Date of the latest issue, including tap issues.

Example:

"2025-01-30"

maturity_date
string<date>
required

Date the instrument matures.

Example:

"2025-07-03"

minimum_initial_cash_investment
string
required

Minimum cash amount accepted for an initial investment.

Example:

"1000.00"

minimum_trading_quantity
string
required

Smallest quantity accepted for an order.

Example:

"1.00"

name
string
required

Display name of the instrument.

Example:

"Apple Inc."

price_type
enum<string>
required

Price quotation type.

Available options:
percent,
money
pro_traders_only
boolean
required

Whether the instrument is restricted to professional investors.

required_cash_increment
integer
required

Cash increment accepted above the minimum investment.

Example:

100

rollout_stage
enum<string> | null
required

Availability stage of the instrument.

Available options:
ga,
beta,
provisional
supports_automatic_rollover
boolean
required

Whether positions can roll over automatically at maturity.

symbol
string
required

Market identifier, such as an ISIN or currency pair.

Example:

"US5949181045"

trading_currency
enum<string>
required

Currency used to trade the instrument.

Available options:
EUR,
USD,
GBP
Example:

"USD"

trading_increment
string
required

Smallest quantity increment accepted for orders.

Example:

"0.01"

trading_status
enum<string>
required

Current trading status.

Available options:
buy_sell,
buy_only,
sell_only,
not_trading
about
string | null

Summary of the instrument.

Example:

"Common stock listed on the Nasdaq Global Select Market."

exchange
string | null

MIC of the listing venue.

Example:

"XNAS"

icon_url
string | null

Public CDN URL of the instrument's icon.

Example:

"https://storage.googleapis.com/sophic-assets/instrument-icons/in_x7GqT.png"

ticker
string | null

Ticker symbol of the security.

Example:

"AAPL"