API Reference

Open position by token mint (auto-resolves best offer)

post
https://api.lavarage.xyz/api/v1/positions/open-by-token

Builds an open position transaction by token mint instead of requiring a specific offer public key. The server automatically resolves the best matching offer for the requested token and side. This is the recommended integration path for partners.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Token mint address you want to trade (base58)

string
required

User wallet address (signer)

string
required

smallest units of quote token, as a positive integer string (max 20 digits)

number
required
1.1 to 100

Leverage multiplier

string
enum
required

Position direction

Allowed:
string

Optional. Quote token mint (default: WSOL for LONG, USDC for SHORT)

integer
1 to 10000
Defaults to 50

Slippage tolerance in basis points

integer
≥ 10000

Optional. Astralane MEV-protect tip in lamports

Responses

404

No active offer found for the requested token and side

Updated 3 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?