Position Partial Repay

POST /positions/partial-repay

Reduces leverage and liquidation risk by partially repaying loan obligations.

Headers

Header	Required	Type	Description
x-api-key	Yes	string	API key

Example Request

POST https://lavarave.wtf/api/sdk/v1.0/positions/partial-repay

Request Body Fields

Field	Required	Type	Description
positionId	Yes	string	Address of the position.
repaymentBps	Yes	number	Percentage in basis points of the position to be repaid. Range: 100-9900
quoteToken	Yes	string	Address of the token being borrowed.
userPubKey	Yes	string	Wallet address of the trader.
partnerFeeRecipient	No	string	Partner wallet address to receive fees.
profitFeeMarkup	No	string	This field is outdated and should be avoided. ⚠️

Response Fields

Field	Type	Description
transaction	string	Base58 encoded serialized transaction ready for signing.
quoteResponse (Beta)	object	Additional quote information. Should be ignored for now - this field is not currently used in integration.

Request Body Example

{
  "positionId": "u29ftYd7vfAAxHSk2hbLRsHcdC3SfcgFUdh2HxmVU1m",
  "partnerFeeRecipient": "6JfTobDvwuwZxZP6FR5JPmjdvQ4h4MovkEVH2FPsMSrF",
  "repaymentBps": 5000,
  "quoteToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "userPubKey": "Ahtpvhub1Z2z3y1RUYPDb7iUkv2J9fYByWWaitPeQXVp"
}

Response Example

{
  "transaction": "base58_encoded_serialized_transaction"
}