Account Positions

Interface description

• Function description: Query positions according to the account ID.

• Applicable objects: Customers who connect with webull through an open platform.

• Request URL: /openapi/account/positions

• Request method: GET

• Frequency limit: The calling frequency of each AppId is limited to 2 times in 2 seconds.

Parameters

Parameter	Type	Required	Description	Values/Example
account_id	String	Required	Account ID	863417315629211648

Response

Parameter	Type	Required	Description	Values/Example
position_id	String	Required	Position ID	N4I4SIM8TJF38KN2TAA0QVVNE9
quantity	String	Required	Quantity	1
cost_price	String	Required	Cost Basis	11.12
unrealized_profit_loss	String	Required	Open P&L	0.08
items	[]position_item	Required	Details

position_item

Parameter	Type	Required	Description	Values/Example
item_id	String	Required	Item ID	N4I4SIM8TJF38KN2TAA0QVVNE9
side	String	Required	Side	BUY
instrument_id	String	Required	Ticker ID	AAPL
symbol	String	Required	Symbol	AAPL
quantity	String	Required	Number of stocks held	5
available_quantity	String	Required	The number of stocks currently available for trading	4
cost_price	String	Required	Cost Basis	11.12
unrealized_profit_loss	String	Required	Open P&L	0.08
account_tax_type	String	Required	Account Tax Type	GENERAL

Request example

Python

from webullsdkcore.client import ApiClient
from webullsdktrade.api import API

api_client = ApiClient(your_app_key, your_app_secret, Region.JP.value)
api = API(api_client)
res = api.account_v2.get_account_position(account_id)
if res.status_code == 200:
    print("account_position=" + json.dumps(res.json(), indent=4))

Java

HttpApiConfig apiConfig = HttpApiConfig.builder()
        .appKey(Env.APP_KEY)
        .appSecret(Env.APP_SECRET)
        .regionId(Region.jp.name())
        .build();
TradeApiService apiService = new TradeHttpApiService(apiConfig);
AccountPositions accountPositions = apiService.positionsAccount(accountId, pageSize, lastId);

Response

Exception example