# List Account Positions
Retrieves position details for a specific account.
# OpenAPI definition
```json
{
"info": {
"title": "Webull Open API Reference",
"description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
"contact": {
"name": "",
"url": "",
"email": ""
},
"version": "2.0",
"x-logo": {
"url": "static/png/logo.png"
}
},
"servers": [
{
"url": "https://broker-api.sandbox.webull.hk"
}
],
"path": "/broker/assets/positions/list",
"method": "get",
"tags": [
"Assets"
],
"description": "Retrieves position details for a specific account.",
"operationId": "brokerAssetsPositions",
"parameters": [
{
"name": "account_id",
"in": "query",
"description": "Account identifier.",
"required": true,
"schema": {
"type": "String"
},
"example": "LOJOQITOD49R6G9BPQM489CISA"
},
{
"name": "x-app-key",
"in": "header",
"description": "A unique identifier issued to a developer for accessing an application's API.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-app-secret",
"in": "header",
"description": "A unique key issued to developers to access the application's API.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-timestamp",
"in": "header",
"description": "Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-signature-version",
"in": "header",
"description": "Signature algorithm version, default is 1.0.",
"required": true,
"schema": {
"type": "string",
"default": "1.0"
},
"examples": {
"1.0": {
"value": "1.0"
}
}
},
{
"name": "x-signature-algorithm",
"in": "header",
"description": "Signature algorithm, default is HMAC-SHA1.",
"required": true,
"schema": {
"type": "string",
"default": "HMAC-SHA1"
},
"examples": {
"HMAC-SHA1": {
"value": "HMAC-SHA1"
}
}
},
{
"name": "x-signature-nonce",
"in": "header",
"description": "Signature unique random number.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-version",
"in": "header",
"description": "API interface version. Supported values: `v2`, `v3`.",
"required": true,
"schema": {
"type": "string",
"default": "v3"
},
"examples": {
"v3": {
"value": "v3"
}
}
},
{
"name": "x-signature",
"in": "header",
"description": "A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Request successful",
"content": {
"application/json": {
"schema": {
"required": [
"cost_price",
"currency",
"instrument_type",
"last_price",
"option_strategy",
"position_id",
"quantity",
"symbol",
"unrealized_profit_loss"
],
"type": "object",
"properties": {
"position_id": {
"type": "string",
"description": "Position ID",
"example": "N4I4SIM8TJF38KN2TAA0QVVNE9"
},
"currency": {
"type": "string",
"description": "Currency",
"example": "USD",
"enum": [
"CNH",
"HKD",
"USD"
]
},
"quantity": {
"type": "string",
"description": "Quantity of the order. Specifies the number of shares or units to transact.
For US stocks, fractional quantities are allowed and can include decimals.",
"example": "1"
},
"symbol": {
"type": "string",
"description": "Trading symbol of the financial instrument.Represents the unique identifier of the security in the specified market (e.g., ticker symbol for equities or option symbol code for derivatives).",
"example": "AAPL"
},
"option_strategy": {
"type": "string",
"description": "Type of options strategy
• SINGLE: Single-leg options order
• COVERED_STOCK: Covered call (stock + sell CALL)
• STRADDLE: Same strike, same expiry CALL + PUT
• STRANGLE: Different strike, same expiry CALL + PUT
• VERTICAL: Same expiry, different strike, same type (Bull/Bear Spread)
• CALENDAR: Same strike, different expiry, same type
• DIAGONAL: Different strike, different expiry, same type
• COLLAR_WITH_STOCK: Stock + buy PUT + sell CALL
• BUTTERFLY: Buy low + sell 2 mid + buy high (same type)
• CONDOR: Four different strikes, same type
• IRON_BUTTERFLY: Buy low PUT + sell mid PUT + sell mid CALL + buy high CALL
• IRON_CONDOR: Buy low PUT + sell mid-low PUT + sell mid-high CALL + buy high CALL
• RATIO: Same expiry, same option type, unequal leg quantities (e.g. buy 1 low-strike CALL + sell 2 high-strike CALLs)",
"example": "SINGLE",
"enum": [
"SINGLE",
"COVERED_STOCK",
"STRADDLE",
"STRANGLE",
"VERTICAL",
"CALENDAR",
"DIAGONAL",
"COLLAR_WITH_STOCK",
"BUTTERFLY",
"CONDOR",
"IRON_BUTTERFLY",
"IRON_CONDOR",
"RATIO"
]
},
"instrument_type": {
"type": "string",
"description": "Type of financial instrument associated with the request.",
"example": "EQUITY",
"enum": [
"EQUITY",
"OPTION"
]
},
"last_price": {
"type": "string",
"description": "Last Price",
"example": "10.0"
},
"cost_price": {
"type": "string",
"description": "Cost Basis",
"example": "11.12"
},
"unrealized_profit_loss": {
"type": "string",
"description": "Open P&L",
"example": "0.08"
},
"legs": {
"type": "array",
"description": "legs",
"items": {
"required": [
"leg_id",
"symbol"
],
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Trading symbol of the financial instrument.Represents the unique identifier of the security in the specified market (e.g., ticker symbol for equities or option symbol code for derivatives).",
"example": "AAPL"
},
"leg_id": {
"type": "string",
"description": "Leg Id",
"example": "T8HO5CR1CI7MEF4RF9U98JM189"
},
"quantity": {
"type": "string",
"description": "Quantity of the order. Specifies the number of shares or units to transact.",
"example": "4"
},
"option_type": {
"type": "string",
"description": "Type of the option.
• CALL: Right to buy the underlying asset.
• PUT: Right to sell the underlying asset.",
"example": "CALL",
"enum": [
"CALL",
"PUT"
]
},
"option_expire_date": {
"type": "string",
"description": "Option expiration date. Format: yyyy-MM-dd",
"example": "2019-09-20"
},
"option_exercise_price": {
"type": "string",
"description": "Exercise Price",
"example": "11.0"
},
"option_contract_multiplier": {
"type": "string",
"description": "The number of shares corresponding to each option contract",
"example": "100"
},
"option_contract_deliverable": {
"type": "string",
"description": "The number of shares required to exercise each contract",
"example": "100"
},
"expiration_type": {
"type": "string",
"description": "Option expiration types",
"example": "AM"
}
},
"description": "legs",
"title": "BrokerPositionItem"
}
}
},
"title": "BrokerAssetsPositionResult"
},
"examples": {
"Example": {
"description": "Example",
"value": [
{
"currency": "USD",
"quantity": "10.0000000000",
"legs": [
{
"quantity": "1000.0000000000",
"symbol": "AAPL",
"leg_id": "037SCRJQ8G8F60KHJOS8000001"
},
{
"quantity": "10.0000000000",
"symbol": "AAPL",
"leg_id": "037SCRJQ9M8F60KHJOS8000001",
"option_type": "PUT",
"option_expire_date": "2026-11-20",
"option_exercise_price": "330.00",
"option_contract_multiplier": "100.00",
"option_contract_deliverable": "100.00"
}
],
"position_id": "037SCRJQ8A8F60KHJOS8000000",
"symbol": "AAPL",
"option_strategy": "COVERED_STOCK",
"instrument_type": "OPTION",
"cost_price": "347.24",
"last_price": "347.37",
"unrealized_profit_loss": "119.51"
}
]
}
}
}
}
},
"401": {
"description": "Unauthorized: Authentication required",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "UNAUTHORIZED"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Insufficient permission"
}
}
}
}
}
},
"417": {
"description": "A business logic error triggered when the request cannot be processed due to domain-specific constraints.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "INVALID_PARAMETER"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Parameter error, phone"
}
}
}
}
}
},
"500": {
"description": "Internal Server Error.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "SYSTEM_ERROR"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Internal Server Error"
}
}
}
}
}
}
},
"postman": {
"name": "List Account Positions",
"description": {
"content": "Retrieves position details for a specific account.",
"type": "text/plain"
},
"url": {
"path": [
"broker",
"assets",
"positions",
"list"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"disabled": false,
"description": {
"content": "(Required) Account identifier.",
"type": "text/plain"
},
"key": "account_id",
"value": ""
}
],
"variable": []
},
"header": [
{
"disabled": false,
"description": {
"content": "(Required) A unique identifier issued to a developer for accessing an application's API.",
"type": "text/plain"
},
"key": "x-app-key",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) A unique key issued to developers to access the application's API.",
"type": "text/plain"
},
"key": "x-app-secret",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
"type": "text/plain"
},
"key": "x-timestamp",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature algorithm version, default is 1.0.",
"type": "text/plain"
},
"key": "x-signature-version",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature algorithm, default is HMAC-SHA1.",
"type": "text/plain"
},
"key": "x-signature-algorithm",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature unique random number.",
"type": "text/plain"
},
"key": "x-signature-nonce",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) API interface version. Supported values: `v2`, `v3`.",
"type": "text/plain"
},
"key": "x-version",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
"type": "text/plain"
},
"key": "x-signature",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET"
}
}
```