Questrade API

https://www.questrade.com/api/documentation/
Admin
The Questrade API allows developers to create their own fully featured trading and analytical...
Tokens:20,560
Snippets:185
Trust Score:9.3
Update:2 months ago
Show doc for...
Tokens:
Raw
### Retrieve account activities request

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-activities

Example GET request to fetch activities for a specific account within a defined time range.

```http
GET https://api01.iq.questrade.com/v1/accounts/26598145/activities?startTime=2011-02-01T00:00:00-05:00&endTime=2011-02-28T00:00:00-05:00&
```

--------------------------------

### GET Accounts JSON Response

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts

Example of the JSON structure returned by the accounts endpoint.

```JSON
 {
      "accounts": [
          {
              "type": "Margin",
              "number": "26598145",
              "status": "Active",
              "isPrimary": true,
              "isBilling": true,
              "clientAccountType": "Individual"
          }
      ]
 }
```

--------------------------------

### Sample Accounts Response

Source: https://www.questrade.com/api/documentation/getting-started

Example JSON response containing account details.

```json
  {
	"accounts": [
		{
		    "type": "Margin"
            "number":"26598145",
		    "status": "Active",
		    "isPrimary": true,
		    "isBilling": true,
		    "clientAccountType: "Individual"
		},
		...
	],
	"userId": 3000124
}   
```

--------------------------------

### GET account executions response

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-executions

Example JSON response containing a list of execution records for the requested account.

```json
{
    "executions": [
         {
              "symbol": "AAPL",
              "symbolId": 8049,
              "quantity":   10,
              "side":  "Buy",
              "price": 536.87,
              "id": 53817310,
              "orderId": 177106005,
              "orderChainId": 17710600,
              "exchangeExecId": "XS1771060050147",
              "timestam":  2014-03-31T13:38:29.000000-04:00,
              "notes":  "",
              "venue":  "LAMP",
              "totalCost":   5368.7,
              "orderPlacementCommission": 0,
              "commission":    4.95,
              "executionFee": 0,
              "secFee": 0,
              "canadianExecutionFee": 0,
              "parentId": 0,
           }
      ]
 }
```

--------------------------------

### Retrieve account positions request

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-positions

Example of the HTTP GET request to fetch positions for a specific account ID.

```http
 
GET https://api01.iq.questrade.com/v1/accounts/26598145/positions
   

```

--------------------------------

### GET account executions request

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-executions

Example request to retrieve executions for a specific account ID.

```http
GET https://api01.iq.questrade.com/v1/accounts/26598145/executions
```

--------------------------------

### Sample Token Response

Source: https://www.questrade.com/api/documentation/getting-started

Example JSON response received after redeeming a refresh token.

```json
 
     {
       “access_token”: “C3lTUKuNQrAAmSD/TPjuV/HI7aNrAwDp”  ,
       "token_type": "Bearer" ,
        "expires_in": 300,
       "refresh_token": "aSBe7wAAdx88QTbwut0tiu3SYic3ox8F",
        "api_server": "https://api01.iq.questrade.com"
     }           
         
```

--------------------------------

### GET symbols/search request

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/symbols-search

Example of a GET request to search for symbols starting with the prefix 'BMO'.

```http
GET https://api01.iq.questrade.com/v1/symbols/search?prefix=BMO
```

--------------------------------

### GET /v1/markets

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/markets

Retrieves a list of supported markets and their associated configuration details.

```APIDOC
## GET /v1/markets

### Description
Retrieves information about supported markets.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/markets

### Response
#### Success Response (200)
- **markets** (Complex) - List of Quote records.

#### Response Example
{
   "markets": [
	{
		"name": "TSX",
		"tradingVenues": [
			"TSX",
			"ALPH",
			"CHIC",
			"OMGA",
  		    "PURE"
                    ],
		"defaultTradingVenue": "AUTO",
		"primaryOrderRoutes": [
			"AUTO"
		],
		"secondaryOrderRoutes": [
			"TSX",
		    "AUTO" 
		],
		"level1Feeds": [
			"ALPH",
			"CHIC",
			"OMGA",
			"PURE",
		    "TSX"
		],
		"extendedStartTime": "2014-10-06T07:00:00.000000-04:00",
		"startTime": "2014-10-06T09:30:00.000000-04:00",
		"endTime": "2014-10-06T16:00:00.000000-04:00",
		"currency": "CAD",
		"snapQuotesLimit": 99999
	   }
      ]
}
```

--------------------------------

### Retrieve Markets Request

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/markets

Perform a GET request to fetch the list of supported markets.

```http
GET https://api01.iq.questrade.com/v1/markets
```

--------------------------------

### Retrieve account balances request

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-balances

Example request to fetch balances for a specific account ID.

```http
GET https://api01.iq.questrade.com/v1/accounts/26598145/balances
```

--------------------------------

### Order Notification Response

Source: https://www.questrade.com/api/documentation/streaming

Example structure for order notification messages.

```json
{"orders": [...], "accountNumber": XXXXXXXX}
```

--------------------------------

### Account positions JSON response

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-positions

Example of the JSON structure returned by the positions endpoint.

```json
 
{
     "positions": [
           {
                "symbol": "THI.TO",
                "symbolId": 38738,
                "openQuantity": 100,
                "currentMarketValue": 6017,
                "currentPrice": 60.17,
                "averageEntryPrice": 60.23,
                "closedPnl": 0,
                "openPnl": -6,
                "totalCost": false,
                "isRealTime": "Individual",
                "isUnderReorg": false
           }
      ]
 }
   
```

--------------------------------

### GET historical market data request

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/markets-candles-id

Example of a GET request to retrieve candlestick data for a specific symbol ID within a defined time range and interval.

```http
GET https://api01.iq.questrade.com/v1/markets/candles/38738?startTime=2014-10-01T00:00:00-05:00&endTime=2014-10-20T23:59:59-05:00&interval=OneDay
```

--------------------------------

### GET symbols/search

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/symbols-search

Retrieves symbol(s) using several search criteria.

```APIDOC
## GET symbols/search

### Description
Retrieves symbol(s) using several search criteria.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/symbols/search

### Parameters
#### Query Parameters
- **prefix** (String) - Optional - Prefix of a symbol or any word in the description.
- **offset** (Integer) - Optional - Offset in number of records from the beginning of a result set.

### Request Example
GET https://api01.iq.questrade.com/v1/symbols/search?prefix=BMO

### Response
#### Success Response (200)
- **symbols** (Complex) - List of EquitySymbol elements.

#### Response Example
{
	"symbol": [
		{
			"symbol":  "BMO",
			"symbolId":  9292,
			"description":  "BANK OF MONTREAL",
			"securityType": "Stock",
			"listingExchange": "NYSE",
			"isTradable":  true,
			"isQuotable":  true,
			"currency":  "USD"
		},
		{
			"symbol":  "BMO.PRJ.TO",
			"symbolId":  9300,
			"description":  "BANK OF MONTREAL CL B SR 13",
			"securityType":  "Stock",
			"listingExchange":  "TSX",
			"isTradable":  true,
			"isQuotable":  true,
			"currency":  "CAD"
		}
	]
}
```

--------------------------------

### Sample HTTP Rate Limit Headers

Source: https://www.questrade.com/api/documentation/rate-limiting

Example of the HTTP response headers returned by the API to indicate remaining request capacity and reset time.

```http
 HTTP/1.1 200 OK
   Content-Length: 123
   Content-Type: application/json; charset=utf-8
   Date: Fri, 18 Aug 2014 22:17:16 GMT
   X-RateLimit-Remaining: 100
   X-RateLimit-Reset: 1300286940
```

--------------------------------

### Markets JSON Response

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/markets

Example structure of the JSON response containing market details and trading configurations.

```json
{
   "markets": [
	{
		"name": "TSX",
		"tradingVenues": [
			"TSX",
			"ALPH",
			"CHIC",
			"OMGA",
  		    "PURE"
                    ]
		"defaultTradingVenue": "AUTO",
		"primaryOrderRoutes": [
			"AUTO"
		],
		"secondaryOrderRoutes": [
			"TSX",
		    "AUTO" 
		],
		"level1Feeds": [
			"ALPH",
			"CHIC",
			"OMGA",
			"PURE",
		    "TSX"
		],
		"extendedStartTime": "2014-10-06T07:00:00.000000-04:00",
		"startTime": "2014-10-06T09:30:00.000000-04:00",
		"endTime": "2014-10-06T16:00:00.000000-04:00",
		"currency": "CAD",
		"snapQuotesLimit": 99999
	   },
		...
      ]
}
```

--------------------------------

### GET accounts/:id/balances

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-balances

Retrieves per-currency and combined balances for a specified account.

```APIDOC
## GET accounts/:id/balances

### Description
Retrieves per-currency and combined balances for a specified account.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/accounts/:id/balances

### Parameters
#### Path Parameters
- **id** (String) - Required - Account number.

### Response
#### Success Response (200)
- **perCurrencyBalances** (Complex) - List of account records.
- **combinedBalances** (Complex) - List of Balance records.
- **sodPerCurrencyBalances** (Complex) - List of Balance records.
- **sodCombinedBalances** (Complex) - List of Balance records.
- **currency** (Enumeration) - Currency of the balance figure.
- **cash** (Double) - Balance amount.
- **marketValue** (Double) - Market value of all securities in the account.
- **totalEquity** (Double) - Equity as a difference between cash and marketValue.
- **buyingPower** (Double) - Buying power for that particular currency side.
- **maintenanceExcess** (Double) - Maintenance excess for that particular side.
- **isRealTime** (Boolean) - Whether real-time data was used.

### Response Example
{
    "perCurrencyBalances": [
        {
             "currency": "CAD",
              "cash": 243971.7,
              "marketValue": 6017,
              "totalEquity": 249988.7,
              "buyingPower": 496367.2,
              "maintenanceExcess": 248183.6,
             "isRealTime": false
        },
        {
             "currency": "USD",
             "cash": 198259.05,
             "marketValue": 53745,
             "totalEquity": 252004.05,
             "buyingPower": 461013.3,
             "maintenanceExcess": 230506.65,
            "isRealTime": false
         }
    ],
        "combinedBalances": [...],
        "sodPerCurrencyBalances": [...],
       "sodCombinedBalances": [...]
}
```

--------------------------------

### GET symbols/:id

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/symbols-id

Retrieves detailed information about one or more symbols.

```APIDOC
## GET symbols/:id

### Description
Retrieves detailed information about one or more symbol.

### Method
GET

### Endpoint
/v1/symbols/:id

### Parameters
#### Query Parameters
- **id** (integer) - Optional - Internal symbol identifier. Mutually exclusive with ‘ids’ parameter.
- **ids** (Complex) - Optional - Comma-separated list of symbol ids.
- **names** (Complex) - Optional - Comma separated list of symbol names.
- **name** (String) - Optional - Symbol name

### Response
#### Success Response (200)
- **symbols** (Array) - List of symbol details
- **symbol** (String) - Symbol that follows Questrade symbology
- **symbolId** (Integer) - Symbol identifier
- **prevDayClosePrice** (Double) - Closing trade price from the previous trading day
- **highPrice52** (Double) - 52-week high price
- **lowPrice52** (Double) - 52-week high price
- **averageVol3Months** (Integer) - Average trading volume over trailing 3 months
- **averageVol20Days** (Integer) - Average trading volume over trailing 20 days
- **outstandingShares** (Integer) - Total number of shares outstanding
- **eps** (Double) - Trailing 12-month earnings per share
- **pe** (Double) - Trailing 12-month price to earnings ratio
- **dividend** (Double) - Dividend amount per share
- **yield** (Double) - Dividend yield
- **exDate** (DateTime) - Dividend ex-date
- **marketCap** (Double) - Market capitalization
- **optionType** (Enumeration) - Option type
- **optionDurationType** (Enumeration) - Option duration type
- **optionRoot** (String) - Option root symbol
- **optionContractDeliverables** (Complex) - Option contract deliverables
- **optionExerciseType** (Enumeration) - Option exercise style
- **listingExchange** (Enumeration) - Primary listing exchange
- **description** (String) - Symbol description
- **securityType** (Enumeration) - Security type
- **optionExpiryDate** (DateTime) - Option expiry date
- **dividendDate** (DateTime) - Dividend declaration date
- **optionStrikePrice** (Double) - Option strike price
- **isQuotable** (Boolean) - Indicates whether the symbol is actively listed
- **hasOptions** (Boolean) - Indicates whether the symbol is an underlying option
- **currency** (String) - Currency code
- **minTicks** (Complex) - List of MinTickData records
- **industrySector** (Enumeration) - Industry sector classification
- **industryGroup** (Enumeration) - Industry group classification
- **industrySubGroup** (Enumeration) - Industry subgroup classification

### Response Example
{
    "symbols": [
	{
		"symbol": "AAPL",
		"symbolId": 8049,
		"prevDayClosePrice": 102.5,
		"highPrice52": 102.9,
		"lowPrice52": 63.89,
		"averageVol3Months": 43769680,
		"averageVol20Days": 12860370,
		"outstandingShares": 5987867000,
		"eps": 6.2,
		"pe": 16.54,
		"dividend": 0.47,
		"yield": 1.84,
		"exDate": "2014-08-07T00:00:00.000000-04:00",
		"marketCap": 613756367500,
		"listingExchange": "NASDAQ",
		"description": "APPLE INC",
		"securityType": "Stock",
		"isQuotable": true,
		"hasOptions": true,
		"minTicks": [
			{
				"pivot": 0,
				"minTick": 0.0001
			}
		],
        "industrySector": "BasicMaterials",
        "industryGroup": "Steel",
        "industrySubGroup": "Steel"
	}
    ]
}
```

--------------------------------

### Order Response JSON

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-orders

Example structure of the JSON response containing a list of order objects.

```json
{
	"orders": [
		{
			"id": 173577870,
			"symbol": "AAPL",
			"symbolId":  8049,
			"totalQuantity":  100,
			"openQuantity":  100,
			"filledQuantity":  0,
			"canceledQuantity": 0,
			"side": "Buy",
			"type": "Limit",
			"limitPrice": 500.95,
			"stopPrice": null,
			"isAllOrNone": false,
			"isAnonymous": false,
			"icebergQty": null,
			"minQuantity": null,
			"avgExecPrice": null,
			"lastExecPrice": null,
			"source": "TradingAPI",
			"timeInForce": "Day",
			"gtdDate":  null,
			"state": "Canceled",
			"clientReasonStr": "",
			"chainId": 173577870,
			"creationTime": 2014-10-23T20:03:41.636000-04:00,
			"updateTime": 2014-10-23T20:03:42.890000-04:00,
			"notes": "",
			"primaryRoute": "AUTO",
			"secondaryRoute": "",
			"orderRoute": "LAMP",
			"venueHoldingOrder": "",
			"comissionCharged": 0,
			"exchangeOrderId": "XS173577870",
			"isSignificantShareHolder":  false,
			"isInsider":  false,
			"isLimitOffsetInDollar": false,
			"userId": 3000124,
			"placementCommission":  null,
			"legs": [],
			"strategyType": "SingleLeg",
			"triggerStopPrice": null,
			"orderGroupId": 0,
			"orderClass":  null,
			"mainChainId": 0
		},
		...
	]
}
```

--------------------------------

### GET symbols/:id/options

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/symbols-id-options

Retrieves an option chain for a particular underlying symbol.

```APIDOC
## GET symbols/:id/options

### Description
Retrieves an option chain for a particular underlying symbol.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/symbols/:id/options

### Parameters
#### Path Parameters
- **id** (Integer) - Required - Internal symbol identifier.

### Response
#### Success Response (200)
- **symbols** (Complex) - List of ChainPerExpiryDate elements.

#### Response Example
{
    "options": [
	{
		"expiryDate": "2015-01-17T00:00:00.000000-05:00",
		"description": "BANK OF MONTREAL",
		"listingExchange": "MX",
		"optionExerciseType": "American",
		"chainPerRoot": [
		    {
			"root": "BMO",
			"chainPerStrikePrice": [
				{
					"strikePrice": 60,
					"callSymbolId": 6101993,
					"putSymbolId": 6102009
				},
				{
					"strikePrice": 62,
					"callSymbolId": 6101994,
					"putSymbolId": 6102010
				},
				{
					"strikePrice": 64,
					"callSymbolId": 6101995,
					"putSymbolId": 6102011
				}
	            ],
		       "multiplier": 100
		      }
	       ]
        }
     ]
}
```

--------------------------------

### Execution Notification Response

Source: https://www.questrade.com/api/documentation/streaming

Example structure for execution notification messages, which include both orders and executions.

```json
{"orders" : [...], "executions" : [ ...], "accountNumber" : XXXXXXXX}
```

--------------------------------

### Retrieve option chain request

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/symbols-id-options

Example request to fetch the option chain for a symbol with ID 9291.

```http
GET https://api01.iq.questrade.com/v1/symbols/9291/options
```

--------------------------------

### Account balances JSON response

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-balances

Example JSON structure returned by the balances endpoint, containing per-currency and combined balance details.

```json
 {
     "perCurrencyBalances": [
         {
              "currency": "CAD",
               "cash": 243971.7,
               "marketValue":  6017,
               "totalEquity":  249988.7,
               "buyingPower": 496367.2,
               "maintenanceExcess": 248183.6,
              "isRealTime": false
         },
         {
              "currency": "USD",
              "cash": 198259.05,
              "marketValue":  53745,
              "totalEquity":  252004.05,
              "buyingPower":  461013.3,
              "maintenanceExcess":  230506.65,
             "isRealTime": false
          }
     ],
         "combinedBalances": [
                 ...
     ],
         "sodPerCurrencyBalances": [
                 ...
     ],
        "sodCombinedBalances": [
                 ...
     ]
 }
```

--------------------------------

### Symbol Details JSON Response

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/symbols-id

Example of the JSON structure returned when querying symbol information.

```json
{
    "symbols": [
	{
		"symbol": "AAPL",
		"symbolId": 8049,
		"prevDayClosePrice": 102.5, 
		"highPrice52": 102.9, 
		"lowPrice52": 63.89, 
		"averageVol3Months": 43769680,
		"averageVol20Days": 12860370,
		"outstandingShares": 5987867000, 
		"eps": 6.2,
		"pe": 16.54,
		"dividend": 0.47,
		"yield": 1.84,
		"exDate": "2014-08-07T00:00:00.000000-04:00", 
		"marketCap": 613756367500, 
		"tradeUnit": 1, 
		"optionType": null,
		"optionDurationType": null, 
		"optionRoot": "",
		"optionContractDeliverables": {
			"underlyings": [], 
			"cashInLieu": 0 
		}, 
		"optionExerciseType": null,
		"listingExchange": "NASDAQ", 
		"description": "APPLE INC",
		"securityType": "Stock", 
		"optionExpiryDate": null,
		"dividendDate": "2014-08-14T00:00:00.000000-04:00",
		"optionStrikePrice": null, 
		"isTradable": true,
		"isQuotable": true,
		"hasOptions": true,
		"minTicks": [
			{
				"pivot": 0, 
				"minTick": 0.0001
			},
			{
				"pivot": 1, 
				"minTick": 0.01
			}
		],
             "industrySector": "BasicMaterials", 
             "industryGroup":  "Steel", 
            "industrySubGroup": "Steel"
        	},
		...
	]
}
```

--------------------------------

### Option chain JSON response

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/symbols-id-options

Example JSON response structure containing expiry dates, root symbols, and strike price details.

```json
{
    "options": [
	{
		"expiryDate": "2015-01-17T00:00:00.000000-05:00",
		"description":   "BANK OF MONTREAL",
		"listingExchange":   "MX",
		"optionExerciseType":   "American",
		"chainPerRoot": [
		    {
			"root":   "BMO",
			"chainPerStrikePrice": [
				{
					"strikePrice":   60,
					"callSymbolId":  6101993,
					"putSymbolId":   6102009
				},
				{
					"strikePrice":   62,
					"callSymbolId":   6101994,
					"putSymbolId":   6102010
				},
				{
					"strikePrice":   64,
					"callSymbolId":   6101995,
					"putSymbolId":   6102011
				},
	            			... 
				],
		       	"multiplier":   100
		      }
	       ]
        }
     ]
}
```

--------------------------------

### Symbols search JSON response

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/symbols-search

Example response body containing a list of matching EquitySymbol objects.

```json
{
	"symbol": [
		{
			"symbol":  "BMO",
			"symbolId":  9292,
			"description":  "BANK OF MONTREAL",
			"securityType": "Stock",
			"listingExchange": "NYSE",
			"isTradable":  true,
			"isQuotable":  true,
			"currency":  "USD"
		},
		{
			"symbol":  "BMO.PRJ.TO",
			"symbolId":  9300,
			"description":  "BANK OF MONTREAL CL B SR 13",
			"securityType":  "Stock",
			"listingExchange":  "TSX",
			"isTradable":  true,
			"isQuotable":  true,
			"currency":  "CAD"
		}
	]
}
```

--------------------------------

### GET /v1/markets/quotes

Source: https://www.questrade.com/api/documentation/streaming

Initiates a streaming connection for L1 market data quotes for specified symbols.

```APIDOC
## GET /v1/markets/quotes

### Description
Initiates a streaming connection for L1 market data quotes for specified symbols.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/markets/quotes

### Query Parameters
- **ids** (string) - Required - Comma-separated list of symbol IDs.
- **stream** (boolean) - Required - Must be set to true.
- **mode** (string) - Required - The connection mode, either 'RawSocket' or 'WebSocket'.
```

--------------------------------

### General Error Response

Source: https://www.questrade.com/api/documentation/error-handling

Example of a standard error response when a request cannot be serviced.

```http
  HTTP/1.1 400 Bad Request
  Content-Length: 63
  Content-Type: application/json; charset=utf-8
  Date: Fri, 18 Aug 2014 22:17:16 GMT 
      {
          "code": 3139 ,
           "message": "Invalid route" 
      }   
```

--------------------------------

### Authorized API Request

Source: https://www.questrade.com/api/documentation/getting-started

Example HTTP request to retrieve account information using a Bearer token.

```http
GET /v1/accounts HTTP/1.1
Host: https://api01.iq.questrade.com
Authorization: Bearer C3lTUKuNQrAAmSD/TPjuV/HI7aNrAwDp
```

--------------------------------

### GET https://login.questrade.com/oauth2/authorize

Source: https://www.questrade.com/api/documentation/authorization

Initiates the Implicit Grant OAuth flow by redirecting the user to the Questrade authorization page.

```APIDOC
## GET https://login.questrade.com/oauth2/authorize

### Description
Redirects the user to the Questrade login and authorization page to grant access to your application.

### Method
GET

### Endpoint
https://login.questrade.com/oauth2/authorize

### Parameters
#### Query Parameters
- **client_id** (string) - Required - Your API consumer key obtained from API Center.
- **response_type** (string) - Required - Must be set to 'token'.
- **redirect_uri** (string) - Required - The URL the user should be redirected back to after authorization.
- **scope** (string) - Optional - A comma-delimited list of requested permissions.
```

--------------------------------

### GET /v1/time

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/time

Retrieves the current server time in ISO format and Eastern time zone.

```APIDOC
## GET https://api01.iq.questrade.com/v1/time

### Description
Retrieves current server time.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/time

### Response
#### Success Response (200)
- **time** (DateTime) - Current server time in ISO format and Eastern time zone.

#### Response Example
{
    "time": "2014-10-24T12:14:42.730000-04:00"
}
```

--------------------------------

### Order Processing Error Response (No Order Created)

Source: https://www.questrade.com/api/documentation/error-handling

Example of an error response for a trading call where no order was created.

```http
  HTTP/1.1 400 Bad Request
  Content-Length: 63
  Content-Type: application/json; charset=utf-8
  Date: Fri, 18 Aug 2014 22:17:16 GMT
      {
           "code": 3139,
           "message": "Invalid route"
      }  
```

--------------------------------

### GET /v1/notifications

Source: https://www.questrade.com/api/documentation/streaming

Retrieves the port information required to establish a connection for receiving order and execution notifications.

```APIDOC
## GET /v1/notifications

### Description
Retrieves the port number for establishing a streaming connection to receive order and execution notifications.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/notifications

### Query Parameters
- **mode** (string) - Required - The connection mode, either 'RawSocket' or 'WebSocket'.

### Response
#### Success Response (200)
- **streamPort** (integer) - The port number to connect to for the requested mode.
```

--------------------------------

### Market Quote JSON Response

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/markets-quotes-id

Example structure of the JSON response containing quote details for requested symbols.

```json
 {
    "quotes": [
	    {
		  "symbol": "THI.TO",
		  "symbolId": 38738,
		  "tier": " ", 
		  "bidPrice": 83.65, 
		  "bidSize":6500, 
		  "askPrice":  83.67,
		  "askSize": 9100,
		  "lastTradePriceTrHrs": 83.66, 
		  "lastTradePrice": 83.66,
	   	  "lastTradeSize": 3100,
		  "lastTradeTick": "Equal",
		  "lastTradeTime": "2014-10-24T20:06:40.131000-04:00",
		  "volume": 80483500, 
		  "openPrice":  83.66, 
		  "highPrice": 83.86, 
		  "lowPrice": 83.66,
		  "delay": 0, 
		  "isHalted": false
        },
		...
      ]
  }
```

--------------------------------

### Order Processing Error Response (Order Created)

Source: https://www.questrade.com/api/documentation/error-handling

Example of an error response for a trading call that resulted in an order being created.

```http
 HTTP/1.1 200 OK
 Content-Length: 63
 Content-Type: application/json; charset=utf-8
 Date: Fri, 18 Aug 2014 22:17:16 GMT 
      {
           "code": 3054 ,
           "message": "Order was rejected by the exchange" ,
           "orderId": 134353223 ,
           "orders": [
                ...
       ]
     } 
```

--------------------------------

### GET accounts/:id/activities

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls

Retrieve account activities, including cash transactions, dividends, trades, etc. Note that a maximum of 31 days of data can be requested at a time.

```APIDOC
## GET accounts/:id/activities

### Description
Retrieve account activities, including cash transactions, dividends, trades, etc. A maximum of 31 days of data can be requested at a time.

### Method
GET

### Endpoint
accounts/:id/activities

### Parameters
#### Path Parameters
- **id** (String) - Required - The account number

#### Query Parameters
- **startTime** (DateTime) - Optional - The start time of the interval to retrieve orders
- **endTime** (DateTime) - Optional - The end time of the interval to retrieve orders

### Response
#### Success Response (200)
- **activities** (Array) - Array of activity records

#### Response Example
{
   "activities": [
        {
           "tradeDate": "2011-02-16T00:00:00.000000-05:00",
           "transactionDate": "2011-02-16T00:00:00.000000-05:00",
           "settlementDate":  "2011-02-16T00:00:00.000000-05:00",
           "action": "",
           "symbol":  "",
           "symbolId": 0,
           "description": "INT FR 02/04 THRU02/15@ 4 3/4%BAL 205,006 AVBAL 204,966",
           "currency": "USD",
           "quantity": 0,
           "price":  0,
           "grossAmount":  0,
           "commission":  0,
           "netAmount": -320.08,
           "type": "Interest"
         }
      ]
 }
```

--------------------------------

### GET accounts/:id/activities

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-activities

Retrieve account activities, including cash transactions, dividends, trades, etc. Note that a maximum of 31 days of data can be requested at a time.

```APIDOC
## GET accounts/:id/activities

### Description
Retrieve account activities, including cash transactions, dividends, trades, etc. A maximum of 31 days of data can be requested at a time.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/accounts/:id/activities

### Parameters
#### Path Parameters
- **id** (String) - Required - The account number

#### Query Parameters
- **startTime** (DateTime) - Required - The start time of the interval to retrieve orders
- **endTime** (DateTime) - Required - The end time of the interval to retrieve orders

### Response
#### Success Response (200)
- **activities** (Array) - Array of activity records
- **tradeDate** (DateTime) - Trade date
- **transactionDate** (DateTime) - Transaction date
- **settlementDate** (DateTime) - Settlement date
- **action** (String) - Activity action
- **symbol** (String) - Symbol name
- **symbolId** (uint64) - Symbol ID
- **description** (String) - Description
- **currency** (Enumeration) - Currency
- **quantity** (Double) - The quantity
- **price** (Double) - The price
- **grossAmount** (Double) - Gross amount
- **commission** (Double) - The commission
- **netAmount** (Double) - Net Amount
- **type** (String) - Activity Type

### Response Example
{
   "activities": [
        {
           "tradeDate": "2011-02-16T00:00:00.000000-05:00",
           "transactionDate": "2011-02-16T00:00:00.000000-05:00",
           "settlementDate":  "2011-02-16T00:00:00.000000-05:00",
           "action": "",
           "symbol":  "",
           "symbolId": 0,
           "description": "INT FR 02/04 THRU02/15@ 4 3/4%BAL 205,006 AVBAL 204,966",
           "currency": "USD",
           "quantity": 0,
           "price":  0,
           "grossAmount":  0,
           "commission":  0,
           "netAmount": -320.08,
           "type": "Interest"
         }
      ]
 }
```

--------------------------------

### GET accounts/:id/orders[/:orderId]

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-orders

Retrieves orders for a specified account. You can optionally provide an orderId to retrieve details for a single order.

```APIDOC
## GET accounts/:id/orders[/:orderId]

### Description
Retrieves orders for a specified account. Optionally, a specific order can be retrieved by providing an orderId.

### Method
GET

### Endpoint
/v1/accounts/:id/orders

### Parameters
#### Path Parameters
- **id** (String) - Required - Account number.

#### Query Parameters
- **startTime** (DateTime) - Optional - Start of time range in ISO format. Default is today at 12:00am.
- **endTime** (DateTime) - Optional - End of time range in ISO format. Default is today at 11:59pm.
- **stateFilter** (Enum) - Optional - All, Open, Closed – retrieve all, active or closed orders.
- **orderId** (Integer) - Optional - Retrieve single order details.

### Response
#### Success Response (200)
- **orders** (Complex) - List of order records.

#### Response Example
{
	"orders": [
		{
			"id": 173577870,
			"symbol": "AAPL",
			"symbolId": 8049,
			"totalQuantity": 100,
			"openQuantity": 100,
			"filledQuantity": 0,
			"canceledQuantity": 0,
			"side": "Buy",
			"type": "Limit",
			"limitPrice": 500.95,
			"state": "Canceled",
			"creationTime": "2014-10-23T20:03:41.636000-04:00"
		}
	]
}
```

--------------------------------

### Historical market data JSON response

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/markets-candles-id

Example structure of the JSON response containing a list of candle records with OHLC and volume data.

```json
 {
     "candles": [
         {
             "start": "2014-01-02T00:00:00.000000-05:00",
             "end": "2014-01-03T00:00:00.000000-05:00",
             "low": 70.3,
             "high": 70.78,
             "open": 70.68,
             "close": 70.73,
             "volume": 983609
         },
              ...
      ]
 }
```

--------------------------------

### POST /v1/markets/quotes/strategies

Source: https://www.questrade.com/api/documentation/streaming

Initiates a streaming connection for strategy market data quotes.

```APIDOC
## POST /v1/markets/quotes/strategies

### Description
Initiates a streaming connection for strategy market data quotes.

### Method
POST

### Endpoint
https://api01.iq.questrade.com/v1/markets/quotes/strategies

### Request Body
- **stream** (boolean) - Required - Must be set to true.
- **mode** (string) - Required - The connection mode, either 'RawSocket' or 'WebSocket'.
- **variants** (array) - Required - List of strategy variants to stream.
```

--------------------------------

### GET Accounts Request

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts

The endpoint used to retrieve all accounts associated with the authorized user.

```HTTP
GET https://api01.iq.questrade.com/v1/accounts
```

--------------------------------

### GET /v1/accounts

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts

Retrieves the accounts associated with the user on behalf of which the API client is authorized.

```APIDOC
## GET /v1/accounts

### Description
Retrieves the accounts associated with the user on behalf of which the API client is authorized.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/accounts

### Response
#### Success Response (200)
- **accounts** (Complex) - List of account records.
- **type** (String) - Type of the account (e.g., "Cash", "Margin").
- **number** (string) - Eight-digit account number (e.g., "26598145").
- **status** (Enumeration) - Status of the account (e.g., Active).
- **isPrimary** (Boolean) - Whether this is a primary account for the holder.
- **isBilling** (Boolean) - Whether this account is one that gets billed for various expenses.
- **clientAccountType** (String) - Type of client holding the account (e.g., "Individual").
- **userId** (Integer) - Internal identifier of the user making the request.

#### Response Example
{
  "accounts": [
    {
      "type": "Margin",
      "number": "26598145",
      "status": "Active",
      "isPrimary": true,
      "isBilling": true,
      "clientAccountType": "Individual"
    }
  ]
}
```

--------------------------------

### GET accounts/:id/positions

Source: https://www.questrade.com/api/documentation/rest-operations/account-calls/accounts-id-positions

Retrieves the list of positions currently held in a specified brokerage account.

```APIDOC
## GET accounts/:id/positions

### Description
Retrieves positions in a specified account.

### Method
GET

### Endpoint
https://api01.iq.questrade.com/v1/accounts/:id/positions

### Parameters
#### Path Parameters
- **id** (String) - Required - Account number.

### Response
#### Success Response (200)
- **positions** (Complex) - List of account records.
- **symbol** (String) - Position symbol.
- **symbolId** (Integer) - Internal symbol identifier.
- **openQuantity** (Double) - Position quantity remaining open.
- **closedQuantity** (Double) - Portion of the position that was closed today.
- **currentMarketValue** (Double) - Market value of the position (quantity x price).
- **currentPrice** (Double) - Current price of the position symbol.
- **averageEntryPrice** (Double) - Average price paid for all executions constituting the position.
- **closedPnL** (Double) - Realized profit/loss on this position.
- **openPnL** (Double) - Unrealized profit/loss on this position.
- **totalCost** (Double) - Total cost of the position.
- **isRealTime** (Boolean) - Designates whether real-time quote was used to compute PnL.
- **isUnderReorg** (Boolean) - Designates whether a symbol is currently undergoing a reorg.

#### Response Example
{
     "positions": [
           {
                "symbol": "THI.TO",
                "symbolId": 38738,
                "openQuantity": 100,
                "currentMarketValue": 6017,
                "currentPrice": 60.17,
                "averageEntryPrice": 60.23,
                "closedPnl": 0,
                "openPnl": -6,
                "totalCost": false,
                "isRealTime": "Individual",
                "isUnderReorg": false
           }
      ]
 }
```

--------------------------------

### POST /v1/markets/quotes/options

Source: https://www.questrade.com/api/documentation/streaming

Initiates a streaming connection for option market data quotes based on filters or specific IDs.

```APIDOC
## POST /v1/markets/quotes/options

### Description
Initiates a streaming connection for option market data quotes.

### Method
POST

### Endpoint
https://api01.iq.questrade.com/v1/markets/quotes/options

### Request Body
- **stream** (boolean) - Required - Must be set to true.
- **mode** (string) - Required - The connection mode, either 'RawSocket' or 'WebSocket'.
- **filters** (array) - Optional - List of option filter criteria.
- **optionIds** (array) - Optional - List of specific option IDs.
```

--------------------------------

### Option Quotes Response

Source: https://www.questrade.com/api/documentation/rest-operations/market-calls/markets-quotes-options

Sample JSON response containing a list of Level1OptionData records.

```JSON
{
    “optionQuotes”: [
        {
            “underlying”: ”MSFT”,
            “underlyingId”: 27426,
            “symbol”: ”MSFT20Jan17C70.00”,
            “symbolId”: 7413503,
            “bidPrice”: 4.90,
            “bidSize”: 0,
            “askPrice”: 4.95,
            “askSize”: 0,
            “lastTradePriceTrHrs”: 4.93,
            “lastTradePrice”: 4.93,
            “lastTradeSize”: 0,
            “lastTradeTick”: ”Equal”,
            “lastTradeTime”: ”2015-08-17T00:00:00.000000-04:00”,
            “volume”: 0.
            “openPrice”: 0,
            “highPricehighPrice”: 4.93,
            “lowPrice”: 0,
            “volatility”: 52.374257,
            “delta”: 0.06985,
            “gamma”: 0.01038,
            “theta”: -0.001406,
            “vega”: 0.074554,
            “rho”: 0.04153,
            “openInterest”: 2292,
            “delay”: 0,
           “isHalted”: false,
           “VWAP”: 0
        },
             ...
     ]

 }
```
Tokens:
Raw