执行外部系统调额

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.

post

/external-system-credit-limit-adjustment

Header parameters

tracestringrequired

Global Link Identifier.

Example: {{mockTrace}}

companyIdintegerrequired

Company Id,User's company ID

Example: {{companyId}}

timestampnumberrequired

Request initiation timestamp, accurate to the millisecond, 13 digits.

Body

thirdServerCodestringrequired

Third-party system customer unique identifier

userNamestring · max: 48required

TradeBoss user identity unique identifier

currencystring · max: 16required

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

bizTypeintegerrequired

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

operationTypestringrequired

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.

amountstringrequired

Amount, used in conjunction with operationType.

amountDigitsintegerrequired

Amount decimal places.

orderIdinteger · longrequired

Order ID.

requestUniqueNostring · max: 48required

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

requestTimeinteger · longrequired

Request initiation timestamp, accurate to the millisecond, 13 digits

ipstringrequired

User IP

metadatastring · max: 200

Remarks information, in JSON format.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://prewppc-3.cmfbl.com/api/cats-gateway/external-system-credit-limit-adjustment' \
  --header 'trace: text' \
  --header 'companyId: 1' \
  --header 'timestamp: 1' \
  --header 'Content-Type: application/json' \
  --data '{
    "tradeType": 81,
    "accountId": 15,
    "sortType": "desc",
    "sortFieldName": "orderTime",
    "accountCurrency": "USDT"
  }'

200

200

{
  "msgParams": "veniam sit",
  "msg": "anim nisi consectetur sit sed",
  "trace": "laboris",
  "tm": 62,
  "bizCode": "10",
  "code": "100",
  "fail": false,
  "ok": true,
  "data": {}
}

成功