Syntax

Get positions by symbol

GET /v{version}/accounts/{accountId}/positions/{symbol}

Description

This API endpoint enables you to retrieve a trading account’s outstanding positions in a specific security.

Parameters

Type	Name	Description	Schema	Default
Header	Authorization required	This is the authorization token that you retrieved from the first endpoint (/token).	string
Header	Et-App-Key required	This is your app’s unique key that can be retrieved from the BO Companies widget in Autoshares Trader.	string
Path	accountId required	This is the unique identifier of the trading account whose outstanding positions in a security need to be retrieved.	integer (int32)
Path	symbol required	This is the ticker symbol of the underlying security under which it is listed on the exchange.	string
Path	version required	This is the version of the API. Unless you have multiple versions of Autoshares Trader’s API deployed in your environment, leave it at 1.0.	string	"1"
Query	currency optional	This is the currency in which the underlying security is denominated (use it if you have two securities with the same ticker but denominated in two different currencies).	string
Query	exchange optional	This is the exchange on which the underlying security is listed (use it if you have two securities with the same ticker but listed on two different exchanges).	string

Responses

HTTP Code	Description	Schema
200	Successful request, JSON data containing outstanding positions in the specified security is returned.	< PositionResource > array
401	The access level of the provided authorization token is not sufficient to perform this operation.	No Content
403	The provided Et-App-Key is incorrect.	No Content
422	A validation error occurred while processing the request.	No Content
500	Internal server error	No Content

Produces

• application/json

• text/json