💵Manage Positions

GET /lender/positions

Provides real-time position monitoring

Query Parameters

Parameter
Required
Type
Description

lenderWallet

Yes

string

Lender wallet address.

status

No

string

Filters by status of the position: open, closed, liquidated or all. It’s All by default.

includeInactionable

No

boolean

Include positions that cannot be acted upon. It’s False by default.

Headers

Header
Required
Type
Description

x-api-key

Yes

string

API key

Content-Type

Yes

string

application/json

Request Example

GET https://lavarave.wtf/api/sdk/v1.0/lender/positions?lenderWallet=Ahtpvhub1Z2z3y1RUYPDb7iUkv2J9fYByWWaitPeQXVp&status=open

Response Fields

Field
Type
Description

onChainStatus

string

Current on-chain status of the position transaction. For detailed information, refer to the Position Lifecycle section.

isActionable

boolean

Boolean indicating whether the position can be acted upon.

status

string

Current status of the position: active, sold, sold by take profit, repaid, liquidated or failed.

openTimestamp

string

ISO datetime when the position was opened.

closeTimestamp

string

ISO datetime when the position was closed. For open positions, this shows "1970-01-01T00:00:00.000Z".

quoteToken

object

Metadata of the token being borrowed.

Contains:

  • address

  • name

  • symbol

  • decimals

collateralToken

object

Metadata for the collateral token.

Contains:

  • address

  • name

  • symbol

  • decimals

initialBorrowQuote

string

Amount borrowed when the position was opened in quote token.

initialMarginQuote

string

Initial margin provided by the user when opening the position in quote token.

apr

number

Annual interest rate for this offer in percentage form, e.g. 169.

lastInterestCollectTimestamp

string

ISO datetime of the last interest collection. Only present when auto-collect occurred, otherwise not included in the response.

initialPositionBase

string

The size of the position in collateral tokens when it was opened.

closePositionQuote

string

The size of the position in quote token when it was closed. Only present for closed & liquidated positions. Shows "0" for active and failed positions.

currentPrice

string

When position = active, this shows the current price of the collateral token in quote token terms. When position = closed, this shows the price at the time of closing.

positionLtv

number

Current Loan-to-Value ratio as decimal (e.g., 0.75 = 75%).

positionAddress

string

Address of the position.

offerAddress

string

Address of the loan offer.

traderAddress

string

Wallet address of the trader.

entryPrice

number

Price at which the position was opened.

interestAccrued

number

Total interest accrued on this position.

liquidationPrice

number

Price at which the lender may liquidate the position.

offerCreatedAt

string

ISO datetime when the original loan offer was created.

updatedAt

number

UNIX timestamp of the last update to this position record.

takeProfitPrice

string

Price at which the take profit order will attempt to sell the position. Only present when a take profit price is set for this position.

positionValue

(Beta)

object

Calculated position value object containing current valuation and PnL. This field is in beta testing and may change in future releases.

Response Example

{
  "onChainStatus": "EXECUTED",
  "isActionable": true,
  "status": "active",
  "openTimestamp": "2025-06-21T20:09:46.000Z",
  "closeTimestamp": "1970-01-01T00:00:00.000Z",
  "quoteToken": {
    "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "name": "USD Coin",
    "symbol": "USDC",
    "decimals": 6
  },
  "collateralToken": {
    "address": "5UUH9RTDiSpq6HKS6bp4NdU9PNJpXRXuiw6ShBTBhgH2",
    "name": "TROLL",
    "symbol": "TROLL",
    "decimals": 6
  },
  "initialBorrowQuote": "1983.75",
  "initialMarginQuote": "1250",
  "apr": 169,
  "lastInterestCollectTimestamp": "2025-07-21T02:49:47.000Z",
  "initialPositionBase": "216548.227914",
  "closePositionQuote": "0",
  "currentPrice": "0.0211537163",
  "positionLtv": 0.4350626813191232,
  "positionAddress": "Aq8fpvRW2qBURRcxyyJ99VUmDmJNxNhnbMuQMJFbBSMa",
  "offerAddress": "EbvPQqzarjTUV5cTXuUz9MjQEHb8MMfpTsoRFH6YQREg",
  "traderAddress": "5zX5TajSP6qM36FTgsxapYJKniGi19cV3ztPEG4zSUSJ",
  "entryPrice": 0.014933163070188006,
  "interestAccrued": 9.185034246575343,
  "liquidationPrice": 0.010225769481491157,
  "offerCreatedAt": "2025-04-21T03:55:52.248Z",
  "updatedAt": "2025-06-21T20:09:46.000Z",
  "positionValue": {
    "valueInQuoteToken": 4580.799778560497,
    "pnlInQuoteToken": 1337.8647443139216
  }
}
PreviousBalance CheckNextGlossary

Last updated