> For the complete documentation index, see [llms.txt](https://lavarage.gitbook.io/lavarage/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lavarage.gitbook.io/lavarage/platform/lavarage-api/lavaos-documentation/offers-v2.md).

# Offers v2

### <mark style="color:green;">GET</mark> /offers/v2

Retrieves all available loan offers.

#### Query Parameters

<table><thead><tr><th width="167">Parameter</th><th width="109">Required</th><th width="111">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>includeTokens</code></td><td>No</td><td>boolean</td><td>Include detailed token metadata such as <code>address</code>, <code>name</code>, <code>symbol</code>, <code>decimals</code>, <code>logoURI</code>, <code>currentPrice</code> &#x26; <code>currentPriceLastUpdated</code>. It's False by default.</td></tr><tr><td><code>inactiveOffers</code></td><td>No</td><td>boolean</td><td>Include inactive offers in the response. It's False by default.</td></tr><tr><td><code>includeRawData</code></td><td>No</td><td>boolean</td><td>Include raw on-chain offer account data. It's False by default.</td></tr><tr><td><code>tags</code></td><td>No</td><td>string</td><td>Specified tag for loan offers.</td></tr></tbody></table>

#### Headers

<table><thead><tr><th width="167">Header</th><th width="110">Required</th><th width="113">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>x-api-key</code></td><td>Yes</td><td>string</td><td>API key</td></tr></tbody></table>

#### Example Request

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

#### Response Fields

<table><thead><tr><th width="175">Field</th><th width="111">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>publicKey</code></td><td>string</td><td>Address of the loan offer.</td></tr><tr><td><code>programId</code></td><td>string</td><td>Identifier for the smart contract program managing the offer.</td></tr><tr><td><code>apr</code></td><td>number</td><td>Annual interest rate for this offer in percentage form, e.g. 169.</td></tr><tr><td><code>maxExposure</code></td><td>string</td><td>Maximum lending amount for this loan offer in quote token.</td></tr><tr><td><code>currentExposure</code></td><td>string</td><td>Current amount in quote token that is borrowed against this loan offer.</td></tr><tr><td><code>nodeWallet</code></td><td>string</td><td>Address of the lender for this loan offer.</td></tr><tr><td><code>active</code></td><td>boolean</td><td>Boolean indicating whether the offer is currently available for borrowing.</td></tr><tr><td><code>quoteToken</code></td><td>object</td><td><p>Metadata of the token being borrowed. This object is only included when <code>includeTokens</code> query parameter is set to True.</p><p></p><p>Contains:</p><ul><li><code>address</code></li><li><code>name</code></li><li><code>symbol</code></li><li><code>decimals</code></li><li><code>logoURI</code></li><li><code>currentPrice</code></li><li><code>currentPriceLastUpdated</code></li></ul></td></tr><tr><td><code>collateralToken</code></td><td>object</td><td><p>Metadata of the collateral token. This object is only included when <code>includeTokens</code> query parameter is set to True.<br></p><p>Contains:</p><ul><li><code>address</code></li><li><code>name</code></li><li><code>symbol</code></li><li><code>decimals</code></li><li><code>logoURI</code></li><li><code>currentPrice</code></li><li><code>currentPriceLastUpdated</code></li></ul></td></tr><tr><td><code>priceVsQuote</code></td><td>string</td><td>Current price of the collateral token denominated in the quote token.</td></tr><tr><td><code>maxLeverage</code></td><td>number</td><td>Maximum leverage multiplier available for this offer. Currently capped at 4x.</td></tr><tr><td><code>maxOpenPerTrade</code></td><td>string</td><td>Maximum amount that can be borrowed in a single trade from this offer.</td></tr><tr><td><code>availableForOpen</code></td><td>string</td><td>Current amount available for new positions from this offer.</td></tr><tr><td><code>tags</code></td><td>array</td><td>Specified tag for loan offers. Can be empty array if no tags are assigned.</td></tr><tr><td><code>openLTV</code></td><td>string</td><td>Maximum loan-to-value ratio at which new positions can be opened. This should be equivalent to <code>1 / maxLeverage</code>.</td></tr><tr><td><code>createdAt</code></td><td>string</td><td>ISO datetime when this offer was created.</td></tr><tr><td><code>updatedAt</code></td><td>number</td><td>UNIX timestamp when this offer was updated.</td></tr><tr><td><code>account</code></td><td>object</td><td><p>Account metadata. This object is only included when <code>includeRawData</code> query parameter is set to True.<br><br>Contains:</p><ul><li><code>apr</code></li><li><code>collateralType</code></li><li><mark style="color:blue;"><code>maxBorrow</code></mark>  (This field is soon to be deprecated ⚠️) </li><li><code>maxExposure</code></li><li><code>currentExposure</code></li><li><code>nodeWallet</code></li></ul></td></tr><tr><td><mark style="color:blue;"><code>maxBorrow</code></mark></td><td>string</td><td>Should be ignored - this field is soon to be deprecated. ⚠️</td></tr></tbody></table>

#### Response Example

```json
{
  "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"
  }
}
```