catalog

Retrieve an instrument

Changed on Oct 29, 2026

Retrieve an instrument by ID or symbol. Note that the instrument has to be visible for your tenant to be accessible.

get/instruments/{id_or_symbol}

Request

Base URL
https://api.engine.usesophic.com
Auth
HTTP bearer

Path parameters

id_or_symbolstring required

The ID or symbol of the instrument to retrieve.

Response

Example response

{
  "about": "Common stock listed on the Nasdaq Global Select Market.",
  "asset_class": [
    {
      "weight": "0.48640000"
    }
  ],
  "days_to_maturity": 182,
  "decimal_precision": 2,
  "exchange": "XNAS",
  "icon_url": "https://storage.googleapis.com/sophic-assets/instrument-icons/in_x7GqT.png",
  "initial_auction_date": "2024-12-30",
  "initial_issue_date": "2025-01-02",
  "isin": "US5949181045",
  "issuer": "United States Department of the Treasury",
  "issuer_country": "US",
  "issuer_credit_rating": "AA+",
  "latest_auction_date": "2025-01-27",
  "latest_issue_date": "2025-01-30",
  "maturity_date": "2025-07-03",
  "name": "Apple Inc.",
  "symbol": "US5949181045",
  "ticker": "AAPL",
  "trading_configuration": {
    "buy": {
      "min_cash_amount": "20000.00000000",
      "min_initial_cash_amount": "100000.00000000",
      "min_initial_quantity": "100.00000000",
      "min_quantity": "10.00000000",
      "modes": [
        "cash"
      ]
    },
    "sell": {
      "min_cash_amount": "1000.00000000",
      "min_quantity": "10.00000000",
      "modes": [
        "quantity"
      ]
    }
  },
  "trading_increment": "0.00010000"
}

Changes

Oct 29, 20266a63920239d8 Revision changes
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new alternatives enum value to the //// response property for the response status
- warning
  added the new alternatives enum value to the //// response property for the response status
- warning
  added the new alternatives enum value to the //// response property for the response status
- warning
  added the new alternatives enum value to the //// response property for the response status
- warning
  added the new alternatives enum value to the //// response property for the response status
- warning
  added the new alternatives enum value to the //// response property for the response status
- warning
  added the new buy_only enum value to the / response property for the response status
- warning
  added the new buy_only enum value to the / response property for the response status
- warning
  added the new buy_only enum value to the / response property for the response status
- warning
  added the new buy_only enum value to the / response property for the response status
- warning
  added the new buy_only enum value to the / response property for the response status
- warning
  added the new buy_only enum value to the / response property for the response status
- warning
  added the new buy_sell enum value to the / response property for the response status
- warning
  added the new buy_sell enum value to the / response property for the response status
- warning
  added the new buy_sell enum value to the / response property for the response status
- warning
  added the new buy_sell enum value to the / response property for the response status
- warning
  added the new buy_sell enum value to the / response property for the response status
- warning
  added the new buy_sell enum value to the / response property for the response status
- warning
  added the new cash enum value to the //// response property for the response status
- warning
  added the new cash enum value to the //// response property for the response status
- warning
  added the new cash enum value to the //// response property for the response status
- warning
  added the new cash enum value to the //// response property for the response status
- warning
  added the new cash enum value to the //// response property for the response status
- warning
  added the new cash enum value to the //// response property for the response status
- warning
  added the new credit_linked_coupon enum value to the / response property for the response status
- warning
  added the new deferred_coupon enum value to the / response property for the response status
- warning
  added the new equity enum value to the //// response property for the response status
- warning
  added the new equity enum value to the //// response property for the response status
- warning
  added the new equity enum value to the //// response property for the response status
- warning
  added the new equity enum value to the //// response property for the response status
- warning
  added the new equity enum value to the //// response property for the response status
- warning
  added the new equity enum value to the //// response property for the response status
- warning
  added the new fixed_coupon enum value to the / response property for the response status
- warning
  added the new fixed_income enum value to the //// response property for the response status
- warning
  added the new fixed_income enum value to the //// response property for the response status
- warning
  added the new fixed_income enum value to the //// response property for the response status
- warning
  added the new fixed_income enum value to the //// response property for the response status
- warning
  added the new fixed_income enum value to the //// response property for the response status
- warning
  added the new fixed_income enum value to the //// response property for the response status
- warning
  added the new floating_coupon enum value to the / response property for the response status
- warning
  added the new indexed_coupon enum value to the / response property for the response status
- warning
  added the new money enum value to the / response property for the response status
- warning
  added the new money enum value to the / response property for the response status
- warning
  added the new money enum value to the / response property for the response status
- warning
  added the new money enum value to the / response property for the response status
- warning
  added the new money enum value to the / response property for the response status
- warning
  added the new money enum value to the / response property for the response status
- warning
  added the new not_trading enum value to the / response property for the response status
- warning
  added the new not_trading enum value to the / response property for the response status
- warning
  added the new not_trading enum value to the / response property for the response status
- warning
  added the new not_trading enum value to the / response property for the response status
- warning
  added the new not_trading enum value to the / response property for the response status
- warning
  added the new not_trading enum value to the / response property for the response status
- warning
  added the new pay_in_kind_coupon enum value to the / response property for the response status
- warning
  added the new percent enum value to the / response property for the response status
- warning
  added the new percent enum value to the / response property for the response status
- warning
  added the new percent enum value to the / response property for the response status
- warning
  added the new percent enum value to the / response property for the response status
- warning
  added the new percent enum value to the / response property for the response status
- warning
  added the new percent enum value to the / response property for the response status
- warning
  added the new sell_only enum value to the / response property for the response status
- warning
  added the new sell_only enum value to the / response property for the response status
- warning
  added the new sell_only enum value to the / response property for the response status
- warning
  added the new sell_only enum value to the / response property for the response status
- warning
  added the new sell_only enum value to the / response property for the response status
- warning
  added the new sell_only enum value to the / response property for the response status
- warning
  added the new stepped_coupon enum value to the / response property for the response status
- warning
  added the new uninvested enum value to the //// response property for the response status
- warning
  added the new uninvested enum value to the //// response property for the response status
- warning
  added the new uninvested enum value to the //// response property for the response status
- warning
  added the new uninvested enum value to the //// response property for the response status
- warning
  added the new uninvested enum value to the //// response property for the response status
- warning
  added the new uninvested enum value to the //// response property for the response status
- warning
  added the new zero_coupon enum value to the / response property for the response status
- info
  removed from the //// response property allOf list for the response status
- info
  removed from the //// response property allOf list for the response status
- info
  removed from the //// response property allOf list for the response status
- info
  removed from the //// response property allOf list for the response status
- info
  removed from the //// response property allOf list for the response status
- info
  removed from the //// response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
Oct 6, 2026aa43bab6253c Revision changes
- breaking
  response property context/additionalProperties/ list-of-types was widened by adding types array to media type application/json of response 400
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status

Operation history (8 revisions)