Manual Repay

info

• When coin is provided and amount is provided, the following validation applies based on repaymentType:
  • ALL: request is rejected if amount exceeds total liability
  • FIXED: request is rejected if amount exceeds fixed-rate liability
  • FLEXIBLE: request is rejected if amount exceeds floating-rate liability
• When coin is provided and amount is not:
  • FLEXIBLE: repays floating-rate liability of that coin only
  • FIXED: repays fixed-rate liability of that coin only
  • ALL: repays all liabilities of that coin (floating-rate first, then fixed-rate)
• When neither coin nor amount is provided, repaymentType must be ALL, then repay all the liabilities; otherwise the request will be rejected.

important

1. When repaying, the system will first use the spot available balance of the debt currency. If that’s not enough, the remaining amount will be repaid by converting other assets according to the liquidation order.
2. If you only want to repay using your spot balance and don't want to trigger currency convert repayment, please refer to Manual Repay Without Asset Conversion
3. Repayment is prohibited between 04:00 and 05:30 per hour. Interest is calculated based on the BorrowAmount at 05:00 per hour.
4. System repays floating-rate liabilities first, followed by fixed-rate
5. Starting Mar 17, 2026 (gradual rollout, fully released on Mar 24, 2026), BYUSDT can be used for repayment.
6. MNT will temporarily not be used for repayment, and repaying MNT liabilities through convert-repay is not supported. However, you may still use Manual Repay Without Asset Conversion to repay MNT using your existing balance.
7. Starting Feb 10, 2026 at 08:00 UTC, UTA Loan manual repayments will be updated to calculate coin-conversion repayment fees using the higher of the collateral or debt asset fee rate and introduce a per-transaction coin-conversion limit of USD 300,000 (Total coin-conversion amount must less than 300,000 USD equivalent) to strengthen stability and risk controls. Please refer to UTA Loan manual repayment update
8. API response behavior based on repaymentType: FIXED: asynchronous; FLEXIBLE: synchronous; ALL: asynchronous

HTTP Request

POST/v5/account/repay

Request Parameters

Parameter	Required	Type	Comments
coin	false	string	coin name, uppercase only
amount	false	string	Repay amount. If coin is not passed in input parameter, amount can not be passed in input parameter
repaymentType	false	string	Repayment type. ALL: repay both fixed-rate and floating-rate liabilities, repaying floating-rate first; FIXED: repay fixed-rate liabilities only; FLEXIBLE: repay floating-rate liabilities only. Default: FLEXIBLE

Response Parameters

Parameter	Type	Comments
result	array	Object
> resultStatus	string	P: Processing SU: Success FA: Failed

Request Example

HTTP

POST /v5/account/repay HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1675842997277
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "coin":"BTC",
    "amount":"0.01"
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.repay(
    coin="BTC",
    amount="0.01"
))

Node.js

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "resultStatus": "P"
    },
    "retExtInfo": {},
    "time": 1756295680801
}