Reference Data

Get symbol detail

Changed on

Returns the Universal Symbol object specified by the ticker or the Universal Symbol ID. When a ticker is specified, the first matching result is returned. 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. Share classes and preferred series use SnapTrade's canonical dotted form: use HBND.U.TO (not Yahoo's HBND-U.TO), FTN.PR.A.TO (not FTN-PA.TO), and ECF.PRA (not ECF-P-A). Please use the ticker with the proper suffix and canonical share-class notation for the best results.

get/symbols/{query}

Request

  • Base URL
    https://api.snaptrade.com
  • URL
    https://api.snaptrade.com/symbols/{query}
  • Auth
    API key in header Signature and API key in query parameter clientId and API key in query parameter timestamp

Path parameters

querystring required

The ticker or Universal Symbol ID to look up the symbol with.

Response

OK

idstring uuid required

Unique identifier for the symbol within SnapTrade. This is the ID used to reference the symbol in SnapTrade API calls.

symbolstring required

The 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. Share classes and preferred series use SnapTrade's canonical dotted form, for example HBND.U.TO, FTN.PR.A.TO, and ECF.PRA.

raw_symbolstring required

The raw symbol is symbol with the exchange suffix removed. For example, if symbol is "VAB.TO", then raw_symbol is "VAB".

descriptionstring nullable

A human-readable description of the security. This is usually the company name or ETF name.

figi_codestring nullable

This 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.

Example response

{
  "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
  "symbol": "VAB.TO",
  "raw_symbol": "VAB",
  "description": "VANGUARD CDN AGGREGATE BOND INDEX ETF",
  "currency": {
    "id": "87b24961-b51e-4db8-9226-f198f6518a89",
    "code": "USD",
    "name": "US Dollar"
  },
  "exchange": {
    "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
    "code": "TSX",
    "mic_code": "XTSE",
    "name": "Toronto Stock Exchange",
    "timezone": "America/New_York",
    "start_time": "09:30:00",
    "close_time": "16:00:00",
    "suffix": ".TO"
  },
  "type": {
    "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
    "code": "cs",
    "description": "Common Stock",
    "is_supported": true
  },
  "figi_code": "BBG000B9XRY4",
  "figi_instrument": {
    "figi_code": "BBG000B9Y5X2",
    "figi_share_class": "BBG001S5N8V8"
  },
  "currencies": [
    {
      "id": "87b24961-b51e-4db8-9226-f198f6518a89",
      "code": "USD",
      "name": "US Dollar"
    }
  ]
}

Changes

  • efd73af6c911Revision changes
    • breaking

      the response's property type changed from string to no type for status

    • breaking

      the response's property type changed from string to no type for status

  • 07c9022b410aRevision 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