🌐Offers v2

GET /offers/v2

Retrieves all available loan offers.

Query Parameters

Parameter
Required
Type
Description

includeTokens

No

boolean

Include detailed token metadata such as address, name, symbol, decimals, logoURI, currentPrice & currentPriceLastUpdated. It's False by default.

inactiveOffers

No

boolean

Include inactive offers in the response. It's False by default.

includeRawData

No

boolean

Include raw on-chain offer account data. It's False by default.

tags

No

string

Specified tag for loan offers.

Headers

Header
Required
Type
Description

x-api-key

Yes

string

API key

Example Request

GET https://lavarave.wtf/api/sdk/v1.0/offers/v2?includeTokens=true&inactiveOffers=false&includeRawData=true

Response Fields

Field
Type
Description

publicKey

string

Address of the loan offer.

programId

string

Identifier for the smart contract program managing the offer.

apr

number

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

maxExposure

string

Maximum lending amount for this loan offer in quote token.

currentExposure

string

Current amount in quote token that is borrowed against this loan offer.

nodeWallet

string

Address of the lender for this loan offer.

active

boolean

Boolean indicating whether the offer is currently available for borrowing.

quoteToken

object

Metadata of the token being borrowed. This object is only included when includeTokens query parameter is set to True.

Contains:

  • address

  • name

  • symbol

  • decimals

  • logoURI

  • currentPrice

  • currentPriceLastUpdated

collateralToken

object

Metadata of the collateral token. This object is only included when includeTokens query parameter is set to True.

Contains:

  • address

  • name

  • symbol

  • decimals

  • logoURI

  • currentPrice

  • currentPriceLastUpdated

priceVsQuote

string

Current price of the collateral token denominated in the quote token.

maxLeverage

number

Maximum leverage multiplier available for this offer. Currently capped at 4x.

maxOpenPerTrade

string

Maximum amount that can be borrowed in a single trade from this offer.

availableForOpen

string

Current amount available for new positions from this offer.

tags

array

Specified tag for loan offers. Can be empty array if no tags are assigned.

openLTV

string

Maximum loan-to-value ratio at which new positions can be opened. This should be equivalent to 1 / maxLeverage.

createdAt

string

ISO datetime when this offer was created.

updatedAt

number

UNIX timestamp when this offer was updated.

account

object

Account metadata. This object is only included when includeRawData query parameter is set to True. Contains:

  • apr

  • collateralType

  • maxBorrow (This field is soon to be deprecated ⚠️)

  • maxExposure

  • currentExposure

  • nodeWallet

maxBorrow

string

Should be ignored - this field is soon to be deprecated. ⚠️

Response Example

{
  "publicKey": "EnweNn1hjL1UdX4Zm5fLqrxhas2ftyb91SYDxPPMhcWL",
  "programId": "CRSeeBqjDnm3UPefJ9gxrtngTsnQRhEJiTA345Q83X3v",
  "apr": 99,
  "maxExposure": "407",
  "currentExposure": "13.145187899",
  "nodeWallet": "6riP1W6R3qzUPWYwLGtXEC23aTqmyAEdDtXzhntJquAh",
  "active": true,
  "quoteToken": {
    "address": "So11111111111111111111111111111111111111112",
    "name": "Wrapped SOL",
    "symbol": "SOL",
    "decimals": 9,
    "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
    "currentPrice": "184.64688341",
    "currentPriceLastUpdated": 1753028005752
  },
  "collateralToken": {
    "address": "EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm",
    "name": "dogwifhat",
    "symbol": "$WIF",
    "decimals": 6,
    "logoURI": "https://bafkreibk3covs5ltyqxa272uodhculbr6kea6betidfwy3ajsav2vjzyum.ipfs.nftstorage.link",
    "currentPrice": "1.27439217",
    "currentPriceLastUpdated": 1753027971938
  },
  "priceVsQuote": "0.0069918507",
  "maxLeverage": 3.196,
  "maxOpenPerTrade": "10",
  "availableForOpen": "10.000",
  "tags": [],
  "openLTV": "0.718400",
  "createdAt": "2025-03-05T18:31:40.705Z",
  "updatedAt": 1753027972217,
  "account": {
    "apr": "0.99",
    "collateralType": "EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm",
    "maxExposure": "407000000000",
    "currentExposure": "13145187899",
    "nodeWallet": "6riP1W6R3qzUPWYwLGtXEC23aTqmyAEdDtXzhntJquAh"
  }
}

Last updated