Add Margin

info

• Need authentication. Up to 5 requests per second per UID. Requires Earn permission on the API key.
• Adds additional margin (in quoteCoin) to a leveraged position to reduce liquidation risk.
• Orders are processed asynchronously. A successful response means the order was accepted. Use Get Order Info to track order status.
• orderLinkId is used for idempotency — resubmitting the same orderLinkId returns an error indicating the order already exists.
• Only one pending order is allowed per position at a time.

HTTP Request

POST/v5/earn/liquidity-mining/add-margin

Request Parameters

Parameter	Required	Type	Comments
productId	true	string	Product ID
orderLinkId	true	string	User-customised order ID (max 40 characters)
positionId	true	string	Position ID to add margin to. Obtain from Get Position Info
amount	true	string	Amount of quoteCoin to add as margin (e.g. USDT)
quoteAccountType	true	string	Source account for the margin: FUND, UNIFIED

Response Parameters

Parameter	Type	Comments
orderId	string	System-generated order ID
orderLinkId	string	User-customised order ID

---

Request Example

POST /v5/earn/liquidity-mining/add-margin HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1741651200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "productId": "5",
    "orderLinkId": "lm-add-m-01",
    "positionId": "1498",
    "amount": "1000",
    "quoteAccountType": "FUND"
}

Response Example

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "orderId": "91720e72-86f8-4ee7-a22c-47f01a9a14e9",
        "orderLinkId": "lm-add-m-01"
    },
    "retExtInfo": {},
    "time": 1775124668762
}