Risk Unit Transfer(TRADE)
API Description
When specified risk unit LTV thresholds and/or the relevant product transfer out rules are met, the Risk Unit Transfer API allows users to perform the following:
- Transfer of assets from margin collateral accounts to spot accounts with the same Spot UID. This endpoint is accessible via each of the credit/collateral accounts with its API Key or parent account .
Please Note: To transfer funds out of the Institutional Loan Risk Unit, first transfer to the spot wallet using the dedicated Risk Unit Transfer API. After that, use the Universal Transfer API to move the assets to an account outside of the risk unit.
For all other designated use cases shown below, please use the Universal Transfer API.
- Transfer assets between Credit Account and other Margin Collateral Accounts within the risk unit without LTV restrictions. Please see Universal Transfer API, this needs to be done via master account API key.
- Transfers between Spot collateral account and accounts outside of the risk unit.
HTTP Request
POST /sapi/v1/margin/loan-group/transfer-out
Request Weight
1(IP)
Request Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| subEmail | STRING | NO | subEmail can be credit account or collateral account |
| asset | STRING | YES | Asset Name , USDT or USDC |
| amount | DECIMAL | YES | Transfer amount of the asset. The real transferred amount = min(risk unit max transfer amount, collateral account max transfer amount). |
Response Example
None
Error Code Description:
- -27025 : Please try again until the previous transaction is completed.
- -27026 : Receiver UID is not within the Institutional Loan risk unit.
- -27027 : The receiver UID margin wallet has not been enabled.
- -27028 : Exceed the max transfer out amount, which is min(Risk Unit max transfer out, Collateral Account max transfer out). Risk Unit max transfer out can be checked via “Query Risk Unit Details (USER_DATA)” API endpoint.
- -27029 : Institution loan collateral accounts can only transfer assets to other collateral accounts’ margin accounts within the same risk unit.