Response fields
array of objectsA list of Universal Symbol objects that match the given query.
objectUniquely describes a single security + exchange combination across all brokerages.
idstring (format: uuid)Unique identifier for the symbol within SnapTrade. This is the ID used to reference the symbol in SnapTrade API calls.
symbolstringThe security's trading ticker symbol. For example "AAPL" for Apple Inc. We largely follow the Yahoo Finance ticker format(click on "Yahoo Finance Market Coverage and Data Delays"). For example, for securities traded on the Toronto Stock Exchange, the symbol has a '.TO' suffix. For securities traded on NASDAQ or NYSE, the symbol does not have a suffix.
raw_symbolstringThe raw symbol is symbol with the exchange suffix removed. For example, if symbol is "VAB.TO", then raw_symbol is "VAB".
descriptionstring or nullA human-readable description of the security. This is usually the company name or ETF name.
currencyobjectThe currency in which the security is traded.
idstring (format: uuid)Unique identifier for the currency. This is the UUID used to reference the currency in SnapTrade.
codestringThe ISO-4217 currency code for the currency.
namestringA human-friendly name of the currency.
exchangeobjectThe exchange on which the security is listed and traded.
idstring (format: uuid)Unique ID for the exchange in SnapTrade.
codestringA short name for the exchange. For standardized exchange code, please us the mic_code field.
mic_codestringThe Market Identifier Code (MIC) for the exchange.
namestringThe full name of the exchange.
timezonestringThe timezone for the trading hours (start_time and close_time) of the exchange.
start_timestringThe time when the exchange opens for trading.
close_timestringThe time when the exchange closes for trading.
suffixstring or nullThe suffix to be appended to the symbol when trading on this exchange. For example, the suffix for the Toronto Stock Exchange is .TO. See UniversalSymbol->symbol and UniversalSymbol->raw_symbol for more detail.
typeobjectThe type of security. For example, "Common Stock" or "ETF".
idstring (format: uuid)Unique identifier for the security type within SnapTrade. This is the ID used to reference the security type in SnapTrade API calls.
codestringA short code representing the security type. For example, "cs" for Common Stock. Here are some common values:
ad- ADRbnd- Bondcs- Common Stockcef- Closed End Fundcrypto- Cryptocurrencyet- ETFoef- Open Ended Fundps- Preferred Stockrt- Rightstruct- Structured Productut- Unitwi- When Issuedwt- Warrant
descriptionstringA human-readable description of the security type. For example, "Common Stock" or "ETF".
is_supportedbooleanThis field is deprecated and should not be used. Please reach out to SnapTrade support if you have a valid usecase for this.
figi_codestring or nullThis identifier is unique per security per trading venue. See section 1.4.1 of the FIGI Standard for more information. This value should be the same as the figi_code in the figi_instrument child property.
figi_instrumentobject or nullFinancial Instrument Global Identifier (FIGI) information for the security. See OpenFIGI for more information.
figi_codestring or nullThis identifier is unique per security per trading venue. See section 1.4.1 of the FIGI Standard for more information.
figi_share_classstring or nullThis enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, AAPL has a different FIGI for each exchange/trading venue it is traded on. The figi_share_class is the same for all of these FIGIs. See section 1.4.3 of the FIGI Standard for more information.
currenciesarray of objectsThis field is deprecated and should not be used. Please reach out to SnapTrade support if you have a valid usecase for this.
idstring (format: uuid)Unique identifier for the currency. This is the UUID used to reference the currency in SnapTrade.
codestringThe ISO-4217 currency code for the currency.
namestringA human-friendly name of the currency.
1[2{3"id": "2bcd7cc3-e922-4976-bce1-9858296801c3",4"symbol": "VAB.TO",5"raw_symbol": "VAB",6"description": "VANGUARD CDN AGGREGATE BOND INDEX ETF",7"currency": {8"id": "87b24961-b51e-4db8-9226-f198f6518a89",9"code": "USD",10"name": "US Dollar"11},12"exchange": {13"id": "2bcd7cc3-e922-4976-bce1-9858296801c3",14"code": "TSX",15"mic_code": "XTSE",16"name": "Toronto Stock Exchange",17"timezone": "America/New_York",18"start_time": "09:30:00",19"close_time": "16:00:00",20"suffix": ".TO"21},22"type": {23"id": "2bcd7cc3-e922-4976-bce1-9858296801c3",24"code": "cs",25"description": "Common Stock",26"is_supported": true27},28"figi_code": "BBG000B9XRY4",29"figi_instrument": {30"figi_code": "BBG000B9Y5X2",31"figi_share_class": "BBG001S5N8V8"32},33"currencies": [34{35"id": "87b24961-b51e-4db8-9226-f198f6518a89",36"code": "USD",37"name": "US Dollar"38}39]40}41]