Skip to main content

IRM rate curves

GET 
/v1/data/lending/irm

Return sampled borrow and deposit rate curves for one or more markets.

Each curve is a series of (utilization, borrowRate, depositRate) points spanning 0% to 100% utilization. Rates are APR % (e.g. 5.5 = 5.5% APR).

Supported protocols: aave, aave_v4, compound_v2, compound_v3, morpho (including Lista), euler_v2, silo, fluid, gearbox, dolomite.

Caching: IRM parameters are quasi-static and cached server-side for 1 hour. Computed curves are also cached (keyed by market UIDs + data-point count).

Plain-text reference — GET /v1/data/lending/irm

Parameters

ParameterInTypeRequiredDescription
marketUidsquerystringyesComma-separated market UIDs, e.g. AAVE_V3:1:0xa0b8...
dataPointsqueryintegernoNumber of curve sample points (1–20, default 20)

Response 200

FieldTypeDescription
successTrue
dataobjectInformational payload. null when the endpoint only builds calldata.
data.countintegerNumber of markets returned
data.itemsobject[]The result set for this response.
data.items[].marketUidstringUnique market identifier (lenderKey:chainId:address)
data.items[].protocolaave, aave_v4, compound_v2, compound_v3, morpho, euler_v2, … (10 values)IRM model type
data.items[].lenderKeystring
data.items[].chainIdstringEVM chain id, as a decimal string. See the ChainId schema.
data.items[].underlyingAddressstring
data.items[].marketNamestring
data.items[].pointsobject[]Sampled rate curve. Length = dataPoints + 1 (includes u=0 and u=1).
data.items[].points[].utilizationnumberUtilization ratio (0–1)
data.items[].points[].borrowRatenumberVariable borrow rate (APR %, e.g. 7.67 = 7.67%)
data.items[].points[].depositRatenumberDeposit/supply rate (APR %, e.g. 3.30 = 3.30%)
actionsnull

Example response

{
  "success": true,
  "data": {
    "count": 1,
    "items": [
      {
        "marketUid": "SPARK:100:0x2a22f9c3b484c3629090feed35f17ff8f88f76f0",
        "protocol": "aave",
        "lenderKey": "SPARK",
        "chainId": "100",
        "underlyingAddress": "0x2a22f9c3b484c3629090feed35f17ff8f88f76f0",
        "marketName": "Spark USDC.e",
        "points": [
          {
            "utilization": 0.95,
            "borrowRate": 7.67,
            "depositRate": 3.3
          }
        ]
      }
    ]
  }
}

Request​

Responses​

Rate curves per market