Open a Position

post https://lavarave.wtf/api/sdk/v1.0/positions/open

This endpoint allows users to open a leveraged position by specifying loan details, margin, leverage, and additional instructions.

Body Params

offerId

string

required

The unique identifier of the loan offer being utilized for this position. This should correspond to an offerId from the GET Loan Offers endpoint.

marginSOL

number

required

≥ 1

The amount of collateral being deposited in SOL or USDC.

leverage

number

required

1 to 4

The leverage multiplier applied to the position. For example: "2" means the trader is borrowing 2x the collateral.

partnerFeeRecipient

string

The wallet address (public key) of the partner that will receive any applicable fees for facilitating this trade.

partnerFeeMarkupBps

number

1 to 2000

The markup percentage for the partner fee. For example: "200" represents a 2% markup on the total trade amount (margin + borrow amount) * 0.02.

quoteToken

string

required

The token used for quoting the loan offer, can be SOL or USDC.

slippage

number

required

≥ 1

The maximum acceptable price slippage percentage during the trade execution. Example: "500" indicates a 5% slippage tolerance.

userPubKey

string

required

The public key of the user initiating the trade. This identifies the trader and links the trade to their account.

Headers

x-api-key

string

required

Response