PApassiv
Trading

Get equity symbol quotes

Changed on

Returns a maximum of 10 quotes from the brokerage for the specified symbols and account.

The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint.

This endpoint is not a substitute for a market data provider. Frequent polling of this endpoint may result in the disabling of your keys

This endpoint does not work for options quotes.

get/accounts/{accountId}/quotes

Request

Path parameters

accountIdstring uuid required

Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.

Example:917c8734-8470-4a3e-a18f-57c3f2ee6631

Query parameters

userIdstring required

SnapTrade User ID. This is chosen by the API partner and can be any string that is a) unique to the user, and b) immutable for the user. It is recommended to NOT use email addresses for this property because they are usually not immutable.

Example:snaptrade-user-123
userSecretstring required

SnapTrade User Secret. This is a randomly generated string and should be stored securely. If compromised, please rotate it via the rotate user secret endpoint.

Example:adf2aa34-8219-40f7-a6b3-60156985cc61
symbolsstring required

List of Universal Symbol IDs or tickers to get quotes for. When providing multiple values, use a comma as separator. Maximum of 10 values allowed

use_tickerboolean

Should be set to True if symbols are comprised of tickers. Defaults to False if not provided.

Response

OK

last_trade_pricenumber

The most recent trade price from the brokerage.

bid_pricenumber

The most recent bid price from the brokerage.

ask_pricenumber

The most recent price from the brokerage.

bid_sizenumber

The most recent bid size from the brokerage.

ask_sizenumber

The most recent ask size from the brokerage.

Example response

[
  {
    "symbol": {
      "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"
        }
      ]
    },
    "last_trade_price": 8.74,
    "bid_price": 8.43,
    "ask_price": 8.43,
    "bid_size": 260,
    "ask_size": 344
  }
]

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

    • 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

    • breaking

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

    • breaking

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

    • breaking

      the response's property type changed from integer 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

    • 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 integer for status

    • breaking

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