WebSocket API

fco.statusHistory

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.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bodyobjectrequired
idstringrequired
methodstringrequired
paramsobjectrequired
fcoIdstringrequired

Conditional-order identifier.

timestampintegerrequired

Response Body

application/json

application/json

Sample Request

wscat -c wss://api.ssi.com.vn/ws/v3/trading -x '{
  "id": "req-0008",
  "method": "fco.statusHistory",
  "params": {
    "fcoId": "7528ac20-a340-4233-8bb7-a2379fc3c638"
  },
  "timestamp": 1755000007000
}'

Sample Response

{
  "id": "req-0008",
  "method": "fco.statusHistory",
  "status": 200,
  "result": {
    "data": [
      {
        "state": "INIT",
        "time": "29/07/2026 09:15:32",
        "code": 200,
        "detail": "Created"
      }
    ]
  },
  "rateLimit": {
    "limit": 100,
    "remaining": 97,
    "resetMs": 860
  }
}

fco.listWS

List conditional orders by account and filters, paginated. No signature required. Required scope: `tradingws:fco:get`.

query.positionWS

Get position information for an account. Equity accounts return `equity`, derivative accounts return `derivative`. No signature required. Required scope: `tradingws:position:get`.