file-userExecute adjustment balance

# 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.

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
chevron-right
200

成功

application/json
bizCodestringOptional

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

codestringOptional

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

msgstringOptional

Status Description.

tminteger · int64Optional

Processing Time (Milliseconds)

tracestringOptional

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

msgParamsstringOptional

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.

dataobjectOptional

Response body.

okbooleanOptional

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

failbooleanOptional

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

post
/external-system-credit-limit-adjustment
200

成功

Last updated