🔗Offers Match

GET /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

Parameter
Required
Type
Description

quoteToken

Yes

string

Address of the token being borrowed.

collateralToken

Yes

string

Collateral token address

Headers

Header
Required
Type
Description

x-api-key

Yes

string

API key

Example Request

GET /offers/match?quoteToken=So11111111111111111111111111111111111111112&collateralToken=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

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 currently 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

string

Address of the token being borrowed.

collateralToken

string

Collateral token address

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.

metadata

object

Metadata that could be shown to users when there are multiple loan offers for the same quote-collateral token pair. Contains:

  • lowestAPR (the lowest APR amongst all offers)

  • highestLTV (the highest openLTV amongst all offers)

  • highestAmountAvailable (the amount of the loan offer with the highest availableForOpen)

maxBorrow

string

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

Response Example

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

Last updated