---
title: "Retrieve Instrument"
method: GET
path: "/instruments/{symbolOrInstrumentID}"
tags: ["Instruments"]
---

# Retrieve Instrument

`GET /instruments/{symbolOrInstrumentID}`

Retrieves an Instrument details by symbol or instrumentID.

## Path parameters

- `symbolOrInstrumentID` string, required

## Query parameters

- `options` string

## Response `200`

Fetching Instrument details was successful.

- union
  - EquityInstrumentDetails
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `name` string — A friendly name of the Instrument, like the Company name for an equity
    - `orderSizeMax` number — The maximum share amount for any order of this Instrument.
    - `orderSizeMin` number — The minimum share amount for any order of this Instrument.
    - `orderSizeStep` number — Increment amount on order of this Instrument.
    - `id` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `instrumentType` 'EQUITY' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' | 'DEBT' | 'OPTION' | 'CRYPTO' — The classification of the instrument.
    - `exchange` string — The stock exchange the instrument is listed on.
    - `status` 'ACTIVE' | 'INACTIVE' | 'CLOSE_ONLY' | 'HALTED' — The current status of the instrument.
    - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.
    - `international` boolean — Instrument trades on a non-US exchange.
    - `region` string — The high-level jurisdiction where the instrument trades.
    - `priceBufferPctMOC` number, double, nullable — The buffer, expressed in percentage points, applied to the buying power check from the close price for a Market-on-Close order for the instrument. For example, a value of 4 means 4%.
    - `intlEquityData` object
      - `fundFamily` string, nullable — The name of the fund family. For example, "ABC Funds".
      - `fundStatus` 'OPEN' | 'LIQUIDATED' | 'MERGED' | 'UNKNOWN', nullable — Indicates the fund status. Eligible values are OPEN, LIQUIDATED, MERGED, UNKNOWN.
      - `summaryRiskIndicator` 1 | 2 | 3 | 4 | 5 | 6 | 7, nullable — The fund risk reward indicator.
      - `UCITS` boolean — Identifies whether the instrument is a UCITS instrument.
      - `dividendPayoutIndicator` boolean — Identifies whether the instrument pays out a dividend.
      - `dividendFrequency` 'DAILY' | 'WEEKLY' | 'FORTNIGHTLY' | 'MONTHLY' | 'BI_MONTHLY' | 'QUARTERLY' | 'EVERY_FOUR_MONTHS' | 'SEMI_ANNUALLY' | 'ANNUALLY' | 'OTHER', nullable — The frequency dividends are paid out by the fund.
    - `reutersPrimaryRic` string — Reuters instrument code, or RIC, is a ticker-like code similar to the ticker symbol of a security.
    - `description` string — A comprehensive description of the Instrument in English.
    - `marketTier` 'Q' | 'G'
    - `sector` 'Services' | 'Industrials' | 'Energy' | 'Technology' | 'Healthcare' | 'Financial' | 'Consumer Cyclical' | 'Real Estate' | 'Capital Goods' | 'Utilities' | 'Consumer Defensive' | 'Basic Materials' | 'Financial Services' | 'Transportation' | 'Communication Services' — The categorization of the sector pertaining to the Instrument.
    - `industry` 'Retail (Apparel)' | 'Coal' | 'Scientific & Technical Instr.' | 'Biotechnology & Drugs' | 'Business Services' | 'Medical Equipment & Supplies' | 'Oil & Gas Operations' | 'Electronic Instr. & Controls' | 'Misc. Financial Services' | 'Software & Programming' | 'Real Estate Operations' | 'Aerospace & Defense' | 'Water Utilities' | 'Food Processing' | 'Computer Services' | 'Semiconductors' | 'Auto & Truck Parts' | 'Investment Services' | 'Misc. Transportation' | 'Construction - Raw Materials' | 'Airline' | 'Construction Services' | 'Recreational Activities' | 'Schools' | 'Consumer Financial Services' | 'Money Center Banks' | 'Retail (Specialty)' | 'Misc. Capital Goods' | 'Apparel/Accessories' | 'Oil Well Services & Equipment' | 'Retail (Department & Discount)' | 'Rental & Leasing' | 'Constr. - Supplies & Fixtures' | 'Fabricated Plastic & Rubber' | 'Printing & Publishing' | 'Fish/Livestock' | 'Furniture & Fixtures' | 'Retail (Grocery)' | 'Healthcare Facilities' | 'Major Drugs' | 'Auto & Truck Manufacturers' | 'Gold & Silver' | 'Broadcasting & Cable TV' | 'Misc. Fabricated Products' | 'Chemical Manufacturing' | 'Insurance (Prop. & Casualty)' | 'Textiles - Non Apparel' | 'Restaurants' | 'Communications Equipment' | 'Hotels & Motels' | 'Computer Hardware' | 'Footwear' | 'Retail (Home Improvement)' | 'Paper & Paper Products' | 'Insurance (Life)' | 'Personal & Household Prods.' | 'Crops' | 'Iron & Steel' | 'Personal Services' | 'Casinos & Gaming' | 'Communications Services' | 'Insurance (Miscellaneous)' | 'Mobile Homes & RVs' | 'Advertising' | 'Trucking' | 'Appliance & Tool' | 'Constr. & Agric. Machinery' | 'Metal Mining' | 'Natural Gas Utilities' | 'Audio & Video Equipment' | 'Retail (Drugs)' | 'Electric Utilities' | 'Regional Banks' | 'Railroads' | 'Waste Management Services' | 'Water Transportation' | 'Recreational Products' | 'Printing Services' | 'Beverages (Nonalcoholic)' | 'Office Supplies' | 'Containers & Packaging' | 'Chemicals - Plastics & Rubber' | 'Forestry & Wood Products' | 'Motion Pictures' | 'Air Courier' | 'Tobacco' | 'Insurance (Accident & Health)' | 'Computer Storage Devices' | 'Beverages (Alcoholic)' | 'Non-Metallic Mining' | 'Tires' | 'Security Systems & Services' | 'Jewelry & Silverware' — The categorization of the industry pertaining to the Instrument.
    - `trbc2012` 'Apparel & Accessories Retailers (NEC)' | 'Coal (NEC)' | 'Heavy Electrical Equipment (NEC)' | 'Biotechnology & Medical Research (NEC)' | 'Management Consulting Services' | 'Executive Search Services' | 'Medical Equipment, Supplies & Distribution (NEC)' | 'Oil & Gas Exploration and Production (NEC)' | 'Oil & Gas Refining and Marketing (NEC)' | 'Electronic Components' | 'Bio Therapeutic Drugs' | 'Investment Management & Fund Operators (NEC)' | 'Enterprise Software' | 'Entertainment Production (NEC)' | 'Aerospace & Defense (NEC)' | 'Biopharmaceuticals' | 'Water Supply & Irrigation Systems' | 'Fruit & Vegetable Processing' | 'IT Services & Consulting (NEC)' | 'Food Processing (NEC)' | 'Photovoltaic Solar Systems & Equipment' | 'Internet Gaming' | 'Engine & Powertrain Systems' | 'Commercial REITs (NEC)' | 'Securities & Commodity Exchanges' | 'Investment Banking & Brokerage Services (NEC)' | 'Ground Freight & Logistics (NEC)' | 'Online Services (NEC)' | 'Social Media & Networking' | 'Construction Materials (NEC)' | 'Advanced Medical Equipment & Technology (NEC)' | 'Airlines (NEC)' | 'Construction & Engineering (NEC)' | 'Gyms, Fitness and Spa Centers' | 'Advertising & Marketing (NEC)' | 'Miscellaneous Educational Service Providers' | 'Transaction & Payment Services' | 'Banks (NEC)' | 'Real Estate Services (NEC)' | 'Appliances, Tools & Housewares (NEC)' | 'Apparel & Accessories (NEC)' | 'Shell Companies' | 'Oil Related Services and Equipment (NEC)' | 'General Department Stores' | 'Real Estate Rental, Development & Operations (NEC)' | 'Iron & Steel (NEC)' | 'Plastic Containers & Packaging' | 'Professional Information Services (NEC)' | 'Poultry Farming' | 'Furniture' | 'Business Support Services (NEC)' | 'Gasoline stations' | 'Display Screens' | 'Internet & Mail Order Department Stores' | 'Bio Diagnostics & Testing' | 'Renewable Energy Equipment & Services (NEC)' | 'Closed End Funds' | 'Server & Database Software' | 'Pharmaceuticals Wholesale' | 'Consumer Leasing' | 'Corporate Banks' | 'Electric (Alternative) Vehicles' | 'Non-Gold Precious Metals & Minerals (NEC)' | 'Broadcasting (NEC)' | 'Pest Control Services' | 'Heavy Machinery & Vehicles (NEC)' | 'Office REITs' | 'Home Furnishings (NEC)' | 'Financial Technology (Fintech) (NEC)' | 'Semiconductors (NEC)' | 'Agricultural Chemicals (NEC)' | 'Commodity Chemicals (NEC)' | 'Property & Casualty Insurance (NEC)' | 'Commercial Printing Services (NEC)' | 'Testing & Measuring Equipment' | 'Integrated Circuits' | 'Software (NEC)' | 'Venture Capital' | 'Integrated Hardware & Software' | 'Blockchain & Cryptocurrency (NEC)' | 'Auto Vehicles, Parts & Service Retailers (NEC)' | 'Medical Diagnostic & Testing Equipment' | 'Programming Software & Testing Tools' | 'Industrial Machinery' | 'Batteries & Uninterruptable Power supplies' | 'Quick Service Restaurants' | 'Auto, Truck & Motorcycle Parts (NEC)' | 'Laboratory Diagnostic & Testing Substances' | 'Phones & Smart Phones' | 'Footwear (NEC)' | 'Aircraft Parts Manufacturing' | 'Home Improvement Products & Services Retailers (NEC)' | 'Paper Mills & Products' | 'Industrial REITs' | 'Pharmaceuticals (NEC)' | 'Investment Holding Companies (NEC)' | 'Industrial Machinery & Equipment (NEC)' | 'Industrial Equipment Rental' | 'Personal Products (NEC)' | 'Vegetable, Fruit & Nut Farming' | 'Semiconductor Equipment & Testing (NEC)' | 'Specialty Mining & Metals (NEC)' | 'Biodiesel' | 'Application Software' | 'System Software' | 'Travel Agents' | 'Gold Mining' | 'Casinos & Gaming (NEC)' | 'Heating, Ventilation & Air Conditioning Systems' | 'Handbags & Luggage' | 'Restaurants & Bars (NEC)' | 'Financial Information Providers' | 'Child Care & Family Services' | 'Life Insurance' | 'Integrated Telecommunications Services (NEC)' | 'Television Broadcasting' | 'Consumer Repair Services' | 'Education & Training Information Providers' | 'Computer Hardware (NEC)' | 'Machine Tools' | 'Used Car Dealers' | 'Insurance Brokers' | 'Courier Services' | 'Network Equipment' | 'Prefabricated Homes' | 'Consumer Credit Cards Services' | 'Outdoor Advertising' | 'Radio Broadcasting' | 'Freight Trucking' | 'Recreational Products (NEC)' | 'Telemedicine Services' | 'Communications & Networking (NEC)' | 'Advanced Electronic Equipment' | 'Oil Exploration & Production - Onshore' | 'Residential Builders - Single Homes' | 'Agricultural Machinery' | 'Investment Banking' | 'Uranium (NEC)' | 'Building Contractors' | 'Personal Services (NEC)' | 'Silver Mining' | 'Electrical Components & Equipment (NEC)' | 'Security Software' | 'Food Retail & Distribution (NEC)' | 'Discount Stores (NEC)' | 'Children's & Infants' Clothing Retailers' | 'Oil & Gas Transportation Services (NEC)' | 'Agricultural Biotechnology' | 'E-commerce & Auction Services' | 'Home Audio' | 'Integrated Oil & Gas' | 'Courier, Postal, Air Freight & Land-based Logistics (NEC)' | 'Professional & Business Education' | 'Paints & Coatings' | 'Retail REITs' | 'Frozen Food Manufacturing' | 'Biomass & Waste to Energy Electric Utilities' | 'Specialty Chemicals (NEC)' | 'Employment Services (NEC)' | 'Supermarkets & Convenience Stores' | 'Commercial Aircraft Manufacturing' | 'Healthcare Facilities & Services (NEC)' | 'Multiline Utilities' | 'Mortgage REITs' | 'Memory Chips (RAM)' | 'Scientific & Super Computers' | 'Electric Utilities (NEC)' | 'Environmental Services & Equipment (NEC)' | 'Homebuilding (NEC)' | 'Gambling & Gaming Machine Manufacturers' | 'Women's Footwear' | 'Petroleum Product Wholesale' | 'Cruise Lines' | 'Investment Management' | 'Consumer Lending (NEC)' | 'Sporting Goods Stores' | 'Diversified REITs' | 'Oil Related Equipment' | 'Cryptocurrency Mining' | 'Non-Alcoholic Beverages (NEC)' | 'Toys & Children's Products (NEC)' | 'Regional Airlines' | 'Healthcare REITs' | 'Satellite Design & Manufacture' | 'Residential REITs' | 'Hotels, Motels & Cruise Lines (NEC)' | 'Diversified Chemicals' | 'Business Support Supplies (NEC)' | 'Passenger Car rental' | 'Grain (Crop) Production' | 'Paper Packaging (NEC)' | 'Construction Supplies & Fixtures Wholesale' | 'Sea-Borne Tankers' | 'Household Products (NEC)' | 'Highway & Bridge Construction' | 'Hotels & Motels' | 'Plastics' | 'Sugar & Artificial Sweeteners' | 'UK Investment Trusts' | 'Pet Food Manufacturing' | 'Self-Storage REITs' | 'Retail - Drugs without Grocery' | 'Medical Equipment Wholesale' | 'Household Appliances' | 'Optical Goods Stores' | 'Dairy Products' | 'Testing Laboratories' | 'Natural Gas Distribution' | 'Multiline Insurance & Brokers (NEC)' | 'Stationary Fuel Cells' | 'Special Foods & Wellbeing Products' | 'Retail & Mortgage Banks' | 'Specialized REITs (NEC)' | 'Managed Healthcare (NEC)' | 'Gaming Machine Operators' | 'Personal Care Products Retailers' | 'Technology Consulting & Outsourcing Services' | 'Food Ingredients' | 'Electronic Equipment & Parts (NEC)' | 'Meat Processing' | 'Office Real Estate Rental & Development' | 'Portable Motors & Generators' | 'Industrial Machinery & Equipment Wholesale' | 'Sporting & Outdoor Goods' | 'Private Equity' | 'Corporate Financial Services (NEC)' | 'Non-Paper Containers & Packaging (NEC)' | 'Airport Operators' | 'Agriculture Support Services' | 'Trade & Business Publishing' | 'Pump & Pumping Equipment' | 'Cosmetics & Perfumes' | 'Personal Care Services' | 'Hospitals, Clinics & Primary Care Services' | 'Power Charging Stations' | 'Home Furnishings Retailers (NEC)' | 'Tobacco (NEC)' | 'Uranium Mining' | 'Cable Service Providers' | 'School, College & University (NEC)' | 'Spacecraft Manufacturing' | 'Financial & Commodity Market Operators & Service Providers (NEC)' | 'Wireless Telecommunications Services (NEC)' | 'Electric Scooters & Bicycles' | 'Casinos' | 'Sports & Outdoor Footwear' | 'Waste Management, Disposal & Recycling Services' | 'Broadcasting Equipment' | 'New Car Dealers' | 'Water & Related Utilities (NEC)' | 'Proprietary & Advanced Pharmaceuticals' | 'Residential Real Estate Rental & Development' | 'Hedge Funds' | 'Automotive Parts & Accessories Retailers' | 'Property & Casualty Reinsurance' | 'Miscellaneous Specialty Retailers (NEC)' | 'Scientific & Precision Equipment' | 'Doors & Window Frames' | 'Coffee & Tea' | 'Internet Security & Transactions Services' | 'Veterinary Drugs' | 'Generic Pharmaceuticals' | 'Storage Devices' | 'NFC & RFID Systems' | 'Construction Machinery' | 'Construction Supplies & Fixtures (NEC)' | 'Renewable IPPs' | 'Cloud Computing Services' | 'Medical Equipment' | 'Office Furniture' | 'Brewers (NEC)' | 'Heavy Machinery & Vehicles Wholesale' | 'Hospitality REITs' | 'Property Insurance' | 'Medical Software & Technology Services' | 'Metal Service Centers' | 'Household Electronics (NEC)' | 'Solar Electric Ultilities' | 'Life & Health Insurance (NEC)' | 'Aluminum (NEC)' | 'Marine Freight & Logistics (NEC)' | 'Doctor's Office' | 'Commercial Food Services' | 'Distillers & Wineries (NEC)' | 'Petroleum Refining' | 'Residential & Long-Term Care' | 'Wealth Management' | 'Market Research' | 'Bio Medical Devices' | 'Wireless Telecoms Service Providers' | 'Lottery Operators' | 'Semiconductor Testing Equipment & Service' | 'Consumer Goods Conglomerates' | 'Diversified Mining' | 'Health Insurance' | 'Rare Earth Minerals' | 'Output Devices' | 'Health Food Stores' | 'Diversified Industrial Goods Wholesale' | 'Alternative Medicine' | 'Watches' | 'Veterinary Medical Equipment & Supplies' | 'Wires & Cables' | 'Photographic Equipment' | 'Movie Theaters & Movie Products' | '3D Printers' | 'Computer & Electronics Retailers (NEC)' | 'Portable Satellite Navigation' | 'Cement & Concrete Manufacturing' | 'Iron, Steel Mills & Foundries' | 'Automotive Batteries' | 'Satellite Service Operators' | 'Sailing Yachts & Motorboats' | 'Arms & Ammunitions Manufacturing' | 'Newspaper Publishing' | 'Oil Pipeline Transportation' | 'Alternative Electric Utilities' | 'Commercial Leasing' | 'Blockchain Technology (Software)' | 'Food Wholesale' | 'Bread & Bakery Product Manufacturing' | 'Auto & Truck Manufacturers (NEC)' | 'Drone Manufacturing' | 'Nursery & Garden Centers' | 'Oil & Gas Drilling (NEC)' | 'Air Freight' | 'Heavy Trucks' | 'Snack Food & Non-chocolate Confectionary' | 'Deep Sea Freight' | 'Fertilizers' | 'Personal & Car Loans' | 'Medical & Diagnostic Laboratories' | 'Forest & Wood Products (NEC)' | 'Consumer Publishing (NEC)' | 'Airport Operators & Services (NEC)' | 'Diversified Investment Services' | 'Carbonated Soft Drinks' | 'Switchgear' | 'Commodity Chemicals Wholesale' | 'Welding & Soldering Equipment' | 'Compliance & Investor Communication' | 'Leisure & Recreation (NEC)' | 'Online Job portals' | 'Tires & Rubber Products (NEC)' | 'Women's Apparel Retailers' | 'Commercial Loans' | 'Adventure Sports Facilities & Ski Resorts' | 'Brokerage Services' | 'Freight Logistics' | 'Mobile Application Software' | 'Book & Magazine Retailers' | 'Copper Ore Mining' | 'Cafés' | 'Fire' | 'Semiconductor Machinery Manufacturing' | 'Wind Systems & Equipment' | 'Ethanol Fuels' | 'Lighting Fixtures' | 'Toys & Games Retailers' | 'Recreational Pharmaceuticals' | 'Floor Covering Retailers' | 'Industrial Valve Manufacturing' | 'Energy Drinks' | 'Search Engines' | 'Electrical Transmission & Grid Equipment' | 'Commercial Equipment' | 'Pet & Pet Supplies Retailers' | 'Natural Gas Utilities (NEC)' | 'Glass Containers & Packaging' | 'Cleaning Services' | 'Footwear Wholesale' | 'Cigars & Cigarette Manufacturing' | 'Medical Monitoring Systems' | 'Security & Surveillance' | 'Consumer Goods Rental' | 'Locomotive Engines & Rolling Stock' | 'Home Healthcare Services' | 'Medical Prosthetics' | 'Residential Real Estate Services' | 'Purification & Treatment Equipment' | 'Maintenance & Repair Services' | 'Timber REITs' | 'Metal Containers & Packaging' | 'Glasses, Spectacles & Contact lenses' | 'Container & Packaging Material Wholesale' | 'LNG Transportation & Storage' | 'Heavy Buses & Coaches' | 'Insurance - Automobile' | 'Data Processing Services' | 'Content & Site Management Services' | 'Auto & Truck Parts Wholesale' | 'Coke Coal Mining' | 'Builder Merchants' | 'Coloring Agents' | 'Appliance & Houseware Wholesale' | 'Nonferrous Metal Processing' | 'Professional Sports Venues' | 'Footwear Retailers' | 'Discount Stores without Grocery' | 'Amusement Parks and Zoos' | 'Servers & Systems' | 'Medical Devices & Implants' | 'Life & Health Reinsurance' | 'Kitchen Cabinets' | 'Adhesive & Epoxy' | 'Automotive Body Parts' | 'Universities' | 'Branding & Naming' | 'Civil Engineers & Architects' | 'Construction Supplies' | 'Leisure Products Wholesale' | 'Funeral Services' | 'Oil Related Services' | 'Natural Gas Pipeline Transportation' | 'Motorcycles & Scooters' | 'Sanitary Products' | 'Medical Farming' | 'Pubs, Bars & Night Clubs' | 'Advertising Agency' | 'Microfinancing' | 'Independent Power Producers (NEC)' | 'Accounting & Tax Preparation' | 'Fishing & Farming (NEC)' | 'Internet & Mail Order Discount Stores' | 'Knitwear' | 'Vegan & Vegetarian Food Manufacturing' | 'Automotive Accessories' | 'Industrial Components' | 'Breakfast Cereal Manufacturing' | 'Medical Supplies' | 'Telecommunication Construction' | 'Rating Agencies' | 'Ball & Roller Bearings' | 'Electrical Components' | 'Gold (NEC)' | 'Marketing Consulting Services' | 'Auto & Truck Wholesale' | 'Wineries' | 'Outsourcing & Staffing Services' | 'Chocolate & Confectionery' | 'VOIP Services' | 'Exhibition & Conference Services' | 'Elevator & Conveying Equipment' | 'Department Stores (NEC)' | 'Land Division & Subdivision' | 'Plays & Concert Production' | 'Reinsurance (NEC)' | 'Movie, TV Production & Distribution' | 'Resort Operators' | 'Computer Hardware & Software Retailers' | 'Jewelry & Watch Retailers' | 'Machine Learning & Artificial Intelligence (AI) Services' | 'Interior Design Services' | 'Wood Products' | 'Entertainment Production Equipment & Services' | 'Security Services' | 'Drug Retailers (NEC)' | 'Men's Apparel Retailers' | 'Iron Ore Mining' | 'Plumbing Fixtures & Fittings' | 'Office Equipment (NEC)' | 'Point of Sale Systems' | 'Human Resources Consulting Services' | 'Railway Freight Operators' | 'Automobiles & Multi Utility Vehicles' | 'Parking Lot Operators' | 'Birth Control Products' | 'Electric Power Plant Construction' | 'Laser Equipment' | 'Men's Clothing' | 'Office Supplies & Stationery Stores' | 'Industrial Gases' | 'Bottled Water & Ice' | 'Casualty Insurance' | 'Fishing & Farming Wholesale' | 'Sports & Outdoors Retailers' | 'Carpets & Curtains' | 'Unconventional Oil & Gas Production' | 'Oil & Gas Storage' | 'Geophysical Surveying & Mapping Services' | 'Primary Aluminum Production' | 'Power & Communications Network Construction' | 'Yarn Goods' | 'Pulp Mills' | 'Inland Water Freight' | 'Water & Sewage Construction' | 'Electric Equipment Wholesale' | 'Organic Farming' | 'Medical Imaging Systems' | 'Residential Builders - Multifamily Homes' | 'Renewable Energy Services' | 'Book Publishing'
    - `indexMemberships` IndexMembers[]
    - `incorporatedCountry` 'USA' | 'ARG' | 'CYM' | 'AUS' | 'MEX' | 'FRA' | 'LUX' | 'GBR' | 'CAN' | 'TWN' | 'VGB' | 'CHL' | 'BMU' | 'ISR' | 'NLD' | 'IND' | 'IRL' | 'ESP' | 'DEU' | 'BRA' | 'ZAF' | 'JPN' | 'PRI' | 'CHN' | 'BHS' | 'JEY' | 'MHL' | 'PAN' | 'SWE' | 'SGP' | 'KOR' | 'ITA' | 'BGD' | 'CHE' | 'CUW' | 'TUR' | 'PER' | 'IDN' | 'CYP' | 'DNK' | 'BEL' | 'COL' | 'FIN' | 'MUS' | 'GGY' | 'NOR' | 'PHL' | 'LBR' | 'GRC' | 'HKG' — The country code of the incorporated company's Instrument.
    - `isOptionsEnabled` boolean — The ability to trade options for this equity instrument. Default is false, meaning it is not possible to trade options for this instrument.
    - `longOnly` boolean — The ability to short an Instrument. Default is true, meaning it is not possible to short the instrument.
    - `exchangeNickelSpread` boolean — If true, a limit order for this Instrument must be in increments of $0.05
    - `close` number — The most recent closing price of the Instrument.
    - `enableExtendedHoursNotionalStatus` string — The instruments eligibility for extended hours notional trading. This will default to INACTIVE.
    - `fundamentalDataModel` FundamentalDataModel, nullable
      - `id` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
      - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
      - `openPrice` number — Most recent opening price of the instrument.
      - `bidPrice` number — The current price buyers are prepared to pay for a security.
      - `askPrice` number — The current price sellers are prepared to sell a security.
      - `lowPrice` number — The lowest price in the current trading day.
      - `highPrice` number — The highest price in the current trading day.
      - `fiftyTwoWeekLowPrice` number — The lowest price of the instrument in the past 52 weeks.
      - `fiftyTwoWeekHighPrice` number — The highest price of the instrument in the past 52 weeks.
      - `cumulativeVolume` number — Cumulative Volume is a running total of daily trade volume. This measures the cumulative inflow and outflow of trading volume for the instrument. Measured in quantity of shares.
      - `marketCap` number — The total market cap of the instrument measured in USD.
      - `peRatio` number — The Price-earnings ratio for the instrument.
      - `dividendYield` number — The percentage of a company's share price that is payed out in dividends each year.
      - `earningsPerShare` number — The earnings per share of the instrument measured in USD. EPS is company's profit divided by the outstanding shares of its common stock.
      - `dividend` number — The annual dividend amount paid out per share measured in USD.
      - `sharesOutstanding` number — The total shares outstanding for the instrument. Shares outstanding are all the shares of an instrument that have been authorized, issued and purchased by investors.
      - `timeLastUpdate` string — The last time the instruments data was updated.
      - `bookValuePerShare` string — The book value per share of the instrument measured in USD. The BVPS is the ratio of equity available to common shareholders divided by the number of outstanding shares.
      - `cashFlowPerShare` string — The cash flow per share measured in USD. Cash flow per share is the after-tax earnings plus depreciation on a per-share basis that functions as a measure of a firm's financial strength.
      - `operatingIncome` string — The operating income of an instrument measured in USD. Operating income is an accounting figure that measures the amount of profit realized from a business's operations after deducting operating expenses such as wages, depreciation, and cost of goods sold.
      - `pbRatio` string — The Price-to-Book ratio of the instrument measured USD per share. The Price-to-Bok ratio measures the market valuation of an Instrument relative to its book value.
      - `volumeMovingAverage10Day` number — The volume moving average of the last 10 days for the instrument measured in quantity of shares.
      - `volumeMovingAverage25Day` number — The volume moving average of the last 25 days for the instrument measured in quantity of shares.
      - `volumeMovingAverage50Day` number — The volume moving average of the last 50 days for the instrument measured in quantity of shares.
      - `priceMovingAverage50Day` number — The price moving average of the last 50 days for the instrument measured in (USD) per share.
      - `priceMovingAverage150Day` number — The price moving average of the last 150 days for the instrument measured in (USD) per share.
      - `priceMovingAverage200Day` number — The price moving average of the last 200 days for the instrument measured in (USD) per share.
      - `roe` string — Return on equity of the instrument measured as a fraction, multiply by 100 to get percentage value. ROE is a measure of financial performance calculated by dividing net income by shareholders' equity.
      - `percentchangeWTD` number — The percentage change between the most recent market closing price and the closing price at the week start.
      - `percentchangeMTD` number — The price percentage change for the instrument Month to Date.
      - `percentchangeYTD` number — The price percentage change for the instrument Year to Date.
      - `percentchange4week` number — The price percentage change for the instrument in last 4 Weeks.
      - `percentchange13week` number — The price percentage change for the instrument in last 13 Weeks.
      - `percentchange26week` number — The price percentage change for the instrument in last 26 Weeks.
      - `percentchange52week` number — The price percentage change for the instrument in last 52 Weeks.
      - `percentchange5day` number — The 5 Day Price Percent Change is the percentage change in the company's stock price over the last 5 tradable (business) days.
      - `percentchangeYTDrelsnp` number — The percentage change in price since the close of the last trading day of the previous year as compared to the change in price of the S&P 500 during that same period.
      - `percentchange5weekrelsnp` number — The percentage change in price over the last four weeks as compared to the change in price of the S&P 500 during that same period
      - `percentchange13weekrelsnp` number — The percentage change in price over the last thirteen weeks as compared to the change in price of the S&P 500 during that same period
      - `percentchange26weekrelsnp` number — The percentage change in price over the last twenty six weeks as compared to the change in price of the S&P 500 during that same period.
      - `percentchange52weekrelsnp` number — The percentage change in price over the last fifty two weeks as compared to the change in price of the S&P 500 during that same period.
    - `type` 'EQUITY' | 'ETF' | 'ETN' | 'ADR' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' — The classification of the Instrument.
    - `url` string — URL for the investor site of the instrument.
    - `closePrior` number — The instruments closing price of the prior trading day.
    - `image` string — A publicly hosted image of the instruments logo.
    - `isPTP` boolean — True, if the Instrument is a publicly traded partnership (PTP).
    - `averageLendingRate` number — 30-day average of daily lending rates. Available only for Fully Paid Securities Lending Partners.
  - OptionInstrumentDetails
    - `id` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `symbol` string — The Option OSI symbol
    - `type` 'EQUITY' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' | 'DEBT' | 'OPTION' | 'CRYPTO' — The classification of the instrument.
    - `name` string — A friendly name of the Instrument, like the Company name for an equity
    - `exchange` string — The stock exchange the instrument is listed on.
    - `orderSizeMax` number — The maximum share amount for any order of this Instrument.
    - `orderSizeMin` number — The minimum share amount for any order of this Instrument.
    - `orderSizeStep` number — Increment amount on order of this Instrument.
  - MutualFundInstrumentDetails
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `name` string — A friendly name of the Instrument, like the Company name for an equity
    - `orderSizeMax` number — The maximum share amount for any order of this Instrument.
    - `orderSizeMin` number — The minimum share amount for any order of this Instrument.
    - `orderSizeStep` number — Increment amount on order of this Instrument.
    - `id` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `instrumentType` 'EQUITY' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' | 'DEBT' | 'OPTION' | 'CRYPTO' — The classification of the instrument.
    - `exchange` string — The stock exchange the instrument is listed on.
    - `status` 'ACTIVE' | 'INACTIVE' | 'CLOSE_ONLY' | 'HALTED' — The current status of the instrument.
    - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.
    - `CUSIP` string — CUSIP stands for `Committee on Uniform Securities Identification Procedures`. A CUSIP number identifies most financial instruments, including: stocks of all registered U.S. and Canadian companies, commercial paper, and U.S. government and municipal bonds. The CUSIP system facilitates the clearance and settlement process of securities. CUSIP numbers consist of nine characters (including letters and numbers) that uniquely identify a company or issuer and the type of financial instrument. A similar system is used to identify foreign securities (`CUSIP International Numbering System or CINS`). CINS employs the same nine character identifier as CUSIP, but also contains a letter in the first position to signify the issuer's country or geographic region.
    - `settlementDays` integer — Number of days for the instrument to settle
  - DebtInstrumentDetails
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `name` string — A friendly name of the Instrument, like the Company name for an equity
    - `orderSizeMax` number — The maximum share amount for any order of this Instrument.
    - `orderSizeMin` number — The minimum share amount for any order of this Instrument.
    - `orderSizeStep` number — Increment amount on order of this Instrument.
    - `id` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `instrumentType` 'EQUITY' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' | 'DEBT' | 'OPTION' | 'CRYPTO' — The classification of the instrument.
    - `exchange` string — The stock exchange the instrument is listed on.
    - `status` 'ACTIVE' | 'INACTIVE' | 'CLOSE_ONLY' | 'HALTED' — The current status of the instrument.
    - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.
    - `CUSIP` string — CUSIP stands for `Committee on Uniform Securities Identification Procedures`. A CUSIP number identifies most financial instruments, including: stocks of all registered U.S. and Canadian companies, commercial paper, and U.S. government and municipal bonds. The CUSIP system facilitates the clearance and settlement process of securities. CUSIP numbers consist of nine characters (including letters and numbers) that uniquely identify a company or issuer and the type of financial instrument. A similar system is used to identify foreign securities (`CUSIP International Numbering System or CINS`). CINS employs the same nine character identifier as CUSIP, but also contains a letter in the first position to signify the issuer's country or geographic region.
    - `settlementDays` integer — Number of days for the instrument to settle

---

[API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/versions/9fced6d0ac41/schema)
