执行外部系统调额

External System Credit Limit Adjustment

1: When a user places an order within the TradeBoss platform, the platform sends this request to an external system. The external system must respond within 3 seconds, otherwise the TradeBoss platform will consider it as a timeout and cancel the operation. At the same time, it will also send a "Cancel external system credit limit adjustment" request to maintain data consistency with the external system.

2: It is important to note that when calling the "Cancel external system credit limit adjustment" interface, if any exceptions occur or if a correct response is not received, there will be specified retries before aborting subsequent operations.

POSThttps://prewppc-3.cmfbl.com/api/cats-gateway/external-system-credit-limit-adjustment

Header parameters

Body

application/json

thirdServerCode*string

Third-party system customer unique identifier

userName*string

TradeBoss user identity unique identifier

currency*string

Account currency code, standard ISO 3-character currency unit.

bizType*integer

Business types: 1 - Market order open; 2 - Market order close; 10 - Limit price stop order; 11 - Stop loss stop order; 12 - Limit price open

operationType*string

The operation types are OPEN_POSITION for opening a position, NORMAL_CLOSE for normal closing, and ABNORMAL_OVERTRADING for abnormal overtrading. When the operation type is NORMAL_CLOSE or OPEN_POSITION, the amount can only be a positive number. When it is ABNORMAL_OVERTRADING, the amount should be negative. The third-party system can decide whether to continue deducting quotas to complete this transaction or ignore this request.

amount*string

Amount, used in conjunction with operationType.

amountDigits*integer

Amount decimal places.

orderId*integer (long)

Order ID.

requestUniqueNo*string

Request for a unique identifier, multiple requests need to maintain business idempotence.

requestTime*integer (long)

Request initiation timestamp, accurate to the millisecond, 13 digits

ip*string

User IP

metadatastring

Remarks information, in JSON format.

Response

200

成功

Body

application/json

bizCodestring

Module identification code, the service module that ultimately handles the current request, can be empty.

codestring

Status return code, code=0 indicates the current request operation is successful, other codes indicate operation failure.

msgstring

Status Description.

tminteger (int64)

Processing Time (Milliseconds)

tracestring

The global link identifier is consistent with the trace in the request header, which facilitates problem localization.

msgParamsstring

Return the placeholder parameter string in the status description, with multiple parameters separated by commas, used to process variable information in the status description and provide a user-friendly interactive experience.

dataobject

Response body.

okboolean

The operation was successful if true, and failed if false.

failboolean

The operation was successful if false, and failed if true.

Request

JavaScriptCurlPython

const response = await fetch('https://prewppc-3.cmfbl.com/api/cats-gateway/external-system-credit-limit-adjustment', {
    method: 'POST',
    headers: {
      "trace": "text",
      "timestamp": "0",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "tradeType": 81,
      "accountId": 15,
      "sortType": "desc",
      "sortFieldName": "orderTime",
      "accountCurrency": "USDT"
    }),
});
const data = await response.json();

Response

200

{
  "bizCode": "text",
  "code": "text",
  "msg": "text",
  "trace": "text",
  "msgParams": "text",
  "data": {},
  "ok": false,
  "fail": false
}