Trading

trade-order-modify

Modify an existing order.

PUT
/api/v3/trading/order

Authorization

Bearer
AuthorizationBearer <token>

Enter the JWT token in the format Bearer <token>.

In: header

Header Parameters

Content-Typestringrequired

The format of the request body content. Primarily application/json.

User-Agentstringoptional

Information about the client sending the request.

Accept-Languagestringoptional

The desired response language. If this header is absent, the system will default to en

X-Signaturestringrequired

The HMAC-SHA256 signature used to verify the integrity of the request.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bodyobjectrequired
clientModifyIdstring | nulloptional

An order-modification identifier created by the client, used for reconciliation in subsequent responses. This field is optional, but if provided it should be unique to avoid confusion when processing responses. When left empty, the system will automatically generate an order-modification identifier for the customer and return it in the response & streaming.

clientRequestIdstring | nulloptional

The original order identifier created by the client when placing the order. When left empty, the system will not reconcile based on the original order identifier but will instead use `orderId` to determine the order to modify.

orderIdstring | nulloptional

The original order identifier generated by the SSI system.

accountNostringrequired

The trading account number.

pricestring | nulloptional

The modified price of the order. This field may be optional depending on the order type and the exchange's order-modification rules. For example, for an MP (Market Price) order, the price may not need to be provided when modifying the order.

quantitynumber | nulloptional

The modified quantity of the order. This field may be optional depending on the exchange's order-modification rules. For example, some exchanges may allow only price modification but not quantity modification, or vice versa.

deviceIdstringrequired

The identifier of the device sending the order-modification request. Typically the device's MAC address or IMEI.

userAgentstring | nulloptional

Information about the browser or application sending the request.

ipAddressstring | nulloptional

The IP address of the device sending the request.

Response Headers

X-RATELIMIT-LIMITstringoptional

The request limit within the cycle.

X-RATELIMIT-REMAININGstringoptional

The number of requests remaining in the current cycle.

X-RATELIMIT-RESETstringoptional

The time at which the request limit resets.

Response Body

application/json

application/json

curl -X PUT "https://api.ssi.com.vn/api/v3/trading/order" \  -H "Content-Type: application/json" \  -H "X-Signature: sha256=abc123..." \  -H "Content-Type: application/json" \  -d '{    "accountNo": "string",    "deviceId": "string"  }'

Success

{
  "clientRequestId": "string",
  "orderId": "string",
  "orderStatus": "string",
  "clientModifyId": "string",
  "clientCancelId": "string"
}

Invalid request.

{
  "code": "400",
  "msg": "Invalid request"
}