Skip to main content

Enumerate available lenders

GET 
/v1/data/lending/lenders

Lightweight enumeration of every (chainId, lenderKey) pair that has data for the requested chains, sorted by tvlUsd descending.

Use this endpoint to discover the lender keys to page through GET /v1/data/lending/latest, which is hard-capped at 20 lender keys per request.

GET /v1/data/lending/lenders?chains=1,8453            → enumerate keys
GET /v1/data/lending/latest?chains=1,8453&lenders=k1,…,k20    → page 1
GET /v1/data/lending/latest?chains=1,8453&lenders=k21,…,k40   → page 2
Plain-text reference — GET /v1/data/lending/lenders

Parameters

ParameterInTypeRequiredDescription
chainsquerystring[]yesChain IDs to query (repeatable, CSV also accepted)
lendersquerystring[]noFilter by lender keys (repeatable, CSV also accepted). Defaults to all lenders. See the LenderId schema for the full set of accepted values.
maxRiskScorequeryintegernoMax risk score (1–5). Defaults to 4.
minTvlquerynumbernoFilter out lender entries with tvlUsd below this USD threshold. Applied as a HAVING clause after aggregation. Returns 400 if non-numeric.
countqueryintegernoOptional cap on the number of items returned.

Response 200

FieldTypeDescription
successTrue
dataobjectEnumeration of available (chainId, lenderKey) pairs sorted by tvlUsd descending.
data.countintegerNumber of items returned
data.itemsobject[]Lender entries sorted by tvlUsd descending
data.items[].chainIdstringEVM chain id, as a decimal string. See the ChainId schema.
data.items[].lenderInfoobjectProtocol/lender metadata (name, logo).
data.items[].lenderInfo.keystringLender key identifier
data.items[].lenderInfo.namestringHuman-readable lender name
data.items[].lenderInfo.logoURIstringLender logo URL
data.items[].tvlUsdnumberΣ totalDepositsUsd − Σ totalDebtUsd over the lender's markets on this chain
data.items[].lastFetchednumberEpoch ms of latest snapshot
actionsnull

Example response

{
  "success": true,
  "data": {
    "count": 1,
    "items": [
      {
        "chainId": "1",
        "lenderInfo": {
          "key": "AAVE_V3",
          "name": "Aave V3",
          "logoURI": "https://raw.githubusercontent.com/1delta-DAO/protocol-icons/main/lender/aave_v3.webp"
        },
        "tvlUsd": 1234567890.12,
        "lastFetched": 1.0
      }
    ]
  }
}

Request​

Responses​

Available lenders sorted by TVL