Skip to main content
GET
/
instruments
List instruments
curl --request GET \
  --url https://api.engine.usesophic.com/instruments \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "instrument_type": "<unknown>",
    "trading_increment": "<string>",
    "decimal_precision": 123,
    "pro_traders_only": true,
    "isin": "<string>",
    "issuer_country": "<string>",
    "minimum_trading_quantity": "<string>",
    "initial_issue_date": "2023-12-25",
    "enforce_trading_rules": true,
    "minimum_initial_cash_investment": "<string>",
    "required_cash_increment": 123,
    "maturity_date": "2023-12-25",
    "days_to_maturity": 123,
    "supports_automatic_rollover": true,
    "issuer_credit_rating": "<string>",
    "initial_auction_date": "2023-12-25",
    "latest_auction_date": "2023-12-25",
    "latest_issue_date": "2023-12-25",
    "par_value": "<string>",
    "ticker": "<string>",
    "issuer": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
instrument_type
enum<string>[]

Return instruments of the given types.

Available options:
money_market_fund,
stock,
bill,
bond,
etf,
mutual_fund,
currency_pair,
amc
​
trading_status
enum<string>[]

Return instruments with the given trading statuses.

Available options:
buy_sell,
buy_only,
sell_only,
not_trading

Response

OK

​
id
string
required

Unique resource identifier.

​
name
string
required

The name of the instrument.

​
symbol
string
required

A unique, secondary, identifier representing the instrument in financial markets (e.g. ISIN or currency pair). For example, 'US5949181045' for the Apple Inc. stock and 'EUR/USD' for the EUR/USD currency pair.

​
instrument_type
any
required

The type of instrument.

​
trading_status
enum<string>
required

The trading status of the instrument.

Available options:
buy_sell,
buy_only,
sell_only,
not_trading
​
rollout_stage
enum<string> | null
required

The rollout stage of the instrument. GA instruments are visible to every user; BETA instruments are visible only to pilot users.

Available options:
ga,
beta
​
trading_increment
string
required

The trading increment refers to the smallest quantity or value of a financial instrument that can be traded. This means orders must be executed in multiples of this increment.

​
decimal_precision
integer
required

The number of decimal places for this instrument's trading increment.

​
pro_traders_only
boolean
required

Flag indicating if this instrument is only available to professional (incl. elective) investors under MiFID II.

​
price_type
enum<string>
required

The type of price for this instrument.

Available options:
percent,
money
​
isin
string
required

International Securities Identification Number.

​
issuer_country
string | null
required

The country code (in ISO 3166-1 alpha-2 format) of the instrument issuer.

​
minimum_trading_quantity
string
required

The minimum trading quantity allowed for the given financial instrument.

​
trading_currency
enum<string>
required

The instrument's trading currency.

Available options:
EUR,
USD,
GBP
​
initial_issue_date
string<date>
required

The initial issue date (ISO 8601) of the instrument.

​
enforce_trading_rules
boolean
required
​
minimum_initial_cash_investment
string
required
​
required_cash_increment
integer
required
​
maturity_date
string<date>
required

The maturity date of the instrument.

​
days_to_maturity
integer
required

The number of days until the instrument matures.

​
supports_automatic_rollover
boolean
required

Flag indicating whether account positions in this instrument can be configured to automatically rollover upon maturity.

​
issuer_credit_rating
string
required

Credit rating from a credit agency e.g AA.

​
initial_auction_date
string<date> | null
required

The initial auction date (ISO 8601) of the instrument.

​
latest_auction_date
string<date> | null
required

The latest auction date (ISO 8601) of the instrument (in case of tap issues).

​
latest_issue_date
string<date> | null
required

The latest issue date (ISO 8601) of the instrument (in case of tap issues).

​
par_value
string | null
required

Nominal denomination per unit against which the price is quoted, as reported by the venue. Varies by market convention: many Euro MTNs quote 1.00, US Treasuries typically 100, and US corporates often 100 or 1000. Stored for reference only.

​
ticker
string | null

The ticker symbol of the security.

​
issuer
string

The name of the instrument issuer.