执行外部系统调额

External System Credit Limit Adjustment

post

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.

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: 200Optional

Remarks information, in JSON format.

Responses

200

成功

application/json

post

HTTPcURLJavaScriptPython

POST /api/cats-gateway/external-system-credit-limit-adjustment HTTP/1.1
Host: prewppc-3.cmfbl.com
trace: text
companyId: 1
timestamp: 1
Content-Type: application/json
Accept: */*
Content-Length: 102

{
  "tradeType": 81,
  "accountId": 15,
  "sortType": "desc",
  "sortFieldName": "orderTime",
  "accountCurrency": "USDT"
}

200

成功

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