WebSocket API

query.position

Get position information for an account. Equity accounts return equity, derivative accounts return derivative. No signature required.

Required scope: tradingws:position:get.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bodyobjectrequired
idstringrequired
methodstringrequired
paramsobjectrequired
accountNostringrequired

Trading account to fetch position information for.

clientIdstring | nulloptional

The 6-digit customer identifier at SSI. If the account number is 003C123888, clientId = 123888.

querySummarybooleanoptional

If true, returns a derivative position summary. If false, returns each position in detail. Only applies to derivative accounts.

timestampintegerrequired

Response Body

application/json

application/json

Sample Request

wscat -c wss://api.ssi.com.vn/ws/v3/trading -x '{
  "id": "req-0009",
  "method": "query.position",
  "params": {
    "accountNo": "0901351",
    "querySummary": true
  },
  "timestamp": 1755000008000
}'

Sample Response

{
  "id": "req-0009",
  "method": "query.position",
  "status": 200,
  "result": {
    "equity": [
      {
        "accountNo": "0901351",
        "symbol": "SSI",
        "quantity": "1000",
        "sellableQuantity": "1000"
      }
    ],
    "derivative": null
  },
  "rateLimit": {
    "limit": 100,
    "remaining": 96,
    "resetMs": 840
  }
}

fco.statusHistoryWS

Get the status-change history of a conditional order (`fcoId`). No signature required. If the request fails OR the history list is empty, the response carries `error.code: "FCO_ERROR"` (unlike `fco.orderbook`/`fco.list`, which still treat an empty list as success). Required scope: `tradingws:fco:get`.

query.maxBuySellWS

Get the maximum buy/sell quantity by account, symbol, and price. No signature required. Required scope: `tradingws:maxBuySell:get`.