> 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-match.md).

# Offers Match

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

Retrieves all available loan offers for a specific quote-collateral token pair, including additional metadata to help identify the most suitable offer.

#### Query Parameters

<table><thead><tr><th width="174">Parameter</th><th width="110">Required</th><th width="111">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>quoteToken</code></td><td>Yes</td><td>string</td><td>Address of the token being borrowed.</td></tr><tr><td><code>collateralToken</code></td><td>Yes</td><td>string</td><td>Collateral token address</td></tr></tbody></table>

#### Headers

<table><thead><tr><th width="174">Header</th><th width="111">Required</th><th width="112">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 /offers/match?quoteToken=So11111111111111111111111111111111111111112&collateralToken=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
```

#### Response Fields

<table><thead><tr><th width="174">Field</th><th width="110">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 currently 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>string</td><td>Address of the token being borrowed.</td></tr><tr><td><code>collateralToken</code></td><td>string</td><td>Collateral token address</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>metadata</code></td><td>object</td><td><p>Metadata that could be shown to users when there are multiple loan offers for the same quote-collateral token pair.<br><br> Contains:</p><ul><li><code>lowestAPR</code> (the lowest APR amongst all offers)</li><li><code>highestLTV</code> (the highest <code>openLTV</code> amongst all offers)</li><li><code>highestAmountAvailable</code> (the amount of the loan offer with the highest <code>availableForOpen</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
{
  "offers": [
    {
      "publicKey": "GFJrBEkFqjmZ7GxWh34ikFAmG4Dzer18ZSDKUZNLNRSs",
      "programId": "CRSeeBqjDnm3UPefJ9gxrtngTsnQRhEJiTA345Q83X3v",
      "apr": 99,
      "maxExposure": "407",
      "currentExposure": "1.527",
      "nodeWallet": "6riP1W6R3qzUPWYwLGtXEC23aTqmyAEdDtXzhntJquAh",
      "active": true,
      "quoteToken": "So11111111111111111111111111111111111111112",
      "collateralToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "priceVsQuote": "0.0055515097",
      "maxLeverage": 4,
      "maxOpenPerTrade": "200.000",
      "availableForOpen": "405.473",
      "tags": [],
      "openLTV": "0.776245",
      "createdAt": "2025-03-05T18:31:40.705Z",
      "updatedAt": 1754924550797
    },
    {
      "publicKey": "J8QPJ5gzQNoRW2YNxPRF98arN7pju1jAZKNbfvkmCST8",
      "programId": "CRSeeBqjDnm3UPefJ9gxrtngTsnQRhEJiTA345Q83X3v",
      "apr": 59,
      "maxExposure": "300",
      "currentExposure": "0",
      "nodeWallet": "FB3iLhuELvMys6LmS1RAz9a8Gn4Lqna8TdniGDcPprKL",
      "active": true,
      "quoteToken": "So11111111111111111111111111111111111111112",
      "collateralToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "priceVsQuote": "0.0055515097",
      "maxLeverage": 3.284,
      "maxOpenPerTrade": "200.000",
      "availableForOpen": "300.000",
      "tags": [],
      "openLTV": "0.725939",
      "createdAt": "2025-06-03T03:03:49.002Z",
      "updatedAt": 1754924550640
    }
  ],
  "metadata": {
    "lowestAPR": "0.59",
    "highestLTV": 0.7762445231789832,
    "highestAmountAvailable": "200000000000.000"
  }
}
```