Introduction

Welcome to the Lavarage API — the fastest way to build leveraged trading into any Solana application.

What is Lavarage?

Lavarage is a decentralized leveraged trading protocol on Solana. Users deposit collateral, pick a leverage multiplier (up to 100x on supported pools), and the protocol borrows additional tokens from liquidity providers to open a leveraged position — all settled on-chain.

The API at api.lavarage.xyz lets you do everything the Lavarage frontend can do, programmatically:

• Browse pools — discover available markets, leverage limits, and liquidity
• Open positions — build transactions for leveraged longs and shorts
• Close & manage — close, split, merge, partially sell, or repay positions
• Automate — set take-profit and stop-loss orders that execute server-side
• Export — download trade history as CSV

Base URL

https://api.lavarage.xyz

All API endpoints are prefixed with /api/v1/ except the health check at /health.

Authentication

Most endpoints require an x-api-key header:

curl https://api.lavarage.xyz/api/v1/positions \
  -H "x-api-key: your-api-key-here"

Public endpoints (offers, tokens, health) don't require a key.

Rate Limits

How Positions Work

1. Quote — call /positions/quote to preview the swap and entry price
2. Open — call /positions/open to get an unsigned Solana transaction
3. Sign & Submit — sign the transaction with the user's wallet and submit to the network
4. Monitor — query /positions to track PnL, set TP/SL orders
5. Close — call /positions/close to build the close transaction

All transactions are returned as bs58-encoded VersionedTransaction objects. Your client signs them and submits to the Solana network.

Collateral Units

All amounts are in smallest token units (lamports for SOL, 1e6 for USDC, etc.). Convert to/from human-readable amounts using the token's decimals field:

human_amount = raw_amount / (10 ^ decimals)
raw_amount = human_amount * (10 ^ decimals)

Long vs Short

Next Steps

• Quick Start — open your first position in 5 minutes
• API Reference — full endpoint documentation
• Code Examples — TypeScript, Python, and cURL