> For the complete documentation index, see [llms.txt](https://docs.kaiko.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kaiko.com/rest-api/defi-lending-and-borrowing-markets/market-data/lending-protocol-summaries.md).

# Lending protocol summaries

{% hint style="info" %}

### This data is included in the following Kaiko packages:

* **Level 1 & Level 2 Data** \[Level 2 Aggregations Tier]
* **Level 1 & Level 2 Data** \[Level 2 Tick-Level Tier]

*Subscriptions with "DeFi Lending & Borrowing" as the market type.*
{% endhint %}

## What is this endpoint for?

> Protocol summaries list every lending protocol Kaiko covers on a blockchain, with its current total deposits, collateral and borrows in US dollars. Use it to compare protocols at a glance and to find the protocol codes the other lending endpoints take.

```json
{"openapi":"3.1.1","info":{"title":"Kaiko API","version":"2026-10-01"},"tags":[{"name":"Lending","description":"Lending and borrowing protocols (Aave, Compound, Maker): the on-chain events of their markets, read from the protocols' own contracts."}],"servers":[{"url":"https://api.kaiko.io","description":"Production"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Your Kaiko API key. Sent on every request. Never in a query parameter.\n"}},"parameters":{"BlockchainQuery":{"name":"blockchain","in":"query","required":true,"description":"Kaiko blockchain code. An unknown chain is a 404 `unsupported_blockchain`.","schema":{"type":"string","pattern":"^[a-z0-9_]+$"}},"ApiVersionQuery":{"name":"api_version","in":"query","required":false,"description":"Contract version to serve, as a date. Each endpoint serves its newest version released on or before it, so one date pins the whole API. When omitted, the endpoint's oldest version still served is used, so breaking changes only reach clients that raise their date. Append `-preview` (`2027-02-01-preview`) to also be served preview versions, which carry no stability promise. A date in the future, or one resolving to a retired version, returns 400 `unsupported_api_version`. The version served is echoed in `meta.api_version`, and `meta.url` and `meta.next_url` always carry this parameter. No `default` here on purpose: it differs per endpoint, and the request validator would otherwise fill in one date for all of them.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(-preview)?$"}}},"schemas":{"ListLendingProtocolSummariesResponse":{"type":"object","description":"One page of `LendingProtocolSummary` rows.","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/LendingProtocolSummary"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"LendingProtocolSummary":{"type":"object","description":"The latest state of one lending protocol on one chain. Unique on (`blockchain`, `protocol`). Column names are lending.v2's, decided with product on 2026-10-22: an exception to rule 11, so a concept can carry another name in a sibling dataset (the supply rate is `supply_rate` in market-snapshots, `lend_rate` in the metrics datasets and `current_liquidity_rate` in a position's supply leg).","required":["blockchain","protocol","protocol_name","protocol_version","timestamp","num_assets","total_deposited_usd","total_collateral_usd","total_borrowed_usd","total_utilization_ratio","collateral_ratio"],"properties":{"blockchain":{"type":"string","description":"Kaiko blockchain code."},"protocol":{"type":"string","description":"Kaiko protocol code (`aav3`, `aav2`, `cmpd`, `cmp3`, `mkr`)."},"protocol_name":{"type":"string","description":"Protocol family (`aave`, `compound`, `makerdao`)."},"protocol_version":{"type":"string","description":"Protocol version within its family (`v1`, `v2`, `v3`)."},"timestamp":{"type":["string","null"],"format":"date-time","description":"Time of the protocol's latest indexed block. `null` when that block holds no snapshot. ISO 8601 UTC, millisecond precision; always whole seconds (`.000Z`). lending.v2 sent `datetime`, unix seconds."},"num_assets":{"type":["integer","null"],"format":"int64","description":"Active reserves at the protocol's newest indexed block."},"total_deposited_usd":{"type":["string","null"],"format":"decimal","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$","description":"Deposits in USD at the protocol's newest indexed block, at the protocol's own oracle prices."},"total_collateral_usd":{"type":["string","null"],"format":"decimal","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$","description":"Collateral-enabled deposits in USD at the protocol's newest indexed block. `null` on Compound v3."},"total_borrowed_usd":{"type":["string","null"],"format":"decimal","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$","description":"Borrows in USD at the protocol's newest indexed block."},"total_utilization_ratio":{"type":["string","null"],"format":"decimal","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$","description":"`total_borrowed_usd` / `total_deposited_usd`, as a fraction; can exceed 1 on Maker."},"collateral_ratio":{"type":["string","null"],"format":"decimal","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$","description":"`total_collateral_usd` / `total_deposited_usd`, as a fraction. `null` when `total_collateral_usd` is."}}},"Meta":{"type":"object","description":"Metadata of a collection response.","required":["api_version","url","count","next_url"],"properties":{"api_version":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(-preview)?$","description":"Version this endpoint served: its version released on or before the requested `api_version`, or its oldest version still served when the request omitted it. Suffixed `-preview` when a preview version served it."},"url":{"type":"string","format":"uri","description":"Absolute URL of the request that produced this response, as received: path and query string unchanged, defaults not filled in, except `api_version`, which is always present (the version served when the request omitted it). Lets a stored response say what it answers, in the shape it was answered."},"count":{"type":"integer","minimum":0,"description":"Number of items in `data` on this page."},"next_url":{"type":["string","null"],"format":"uri","description":"Absolute URL of the next page, `null` on the last page. It holds only public parameters: the original query with every default made explicit (`api_version` included) and the time bound moved past the last row, plus the dataset's tie-breaker (`after_<key>`) where timestamps can tie. An operation that pages on another keyset (a block position, a snapshot) says so in its description, and its `next_url` carries that keyset's parameters instead."}}},"Problem":{"type":"object","description":"RFC 9457 problem details. Served as application/problem+json.","required":["type","title","status","code"],"properties":{"type":{"type":"string","format":"uri-reference","const":"about:blank","description":"Always `about:blank`; the reason is carried by `code`."},"title":{"type":"string","description":"HTTP reason phrase."},"status":{"type":"integer","minimum":400,"maximum":599,"description":"HTTP status code, repeated for clients that lose the status line."},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence. Do not parse it."},"instance":{"type":"string","format":"uri-reference","description":"Request path and request id, to quote to support."},"code":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable machine-readable reason. Clients branch on this. New values are additive; renaming one is breaking. Values in use: invalid_parameter, unsupported_api_version, missing_api_key, invalid_api_key, not_entitled, history_out_of_entitlement, unknown_instrument, pair_not_covered, unknown_asset, unknown_index, unsupported_blockchain, chain_capability_unsupported, token_not_found, unknown_contract, unknown_protocol, unknown_pool, query_too_large, snapshot_expired, resource_not_found, method_not_allowed, not_acceptable, rate_limited, internal_error, service_unavailable."},"errors":{"type":"array","description":"On 400, one entry per invalid parameter.","items":{"$ref":"#/components/schemas/ParameterError"}}}},"ParameterError":{"type":"object","description":"One invalid parameter in a 400 response.","required":["parameter","detail"],"properties":{"parameter":{"type":"string","description":"Name of the offending parameter."},"detail":{"type":"string","description":"What is wrong with it."}}}},"responses":{"BadRequest":{"description":"Invalid parameter, window or API version.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"Unauthorized":{"description":"Missing or unknown X-Api-Key.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"Forbidden":{"description":"The key is valid but not entitled to this product, instrument or history depth.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotAcceptable":{"description":"The Accept header excludes application/json.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"TooManyRequests":{"description":"Rate limited. Retry after the delay in Retry-After.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"InternalError":{"description":"Unexpected server failure.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"ServiceUnavailable":{"description":"A dependency is down or the data is not available yet.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","minimum":0}}}},"paths":{"/defi/lending/protocol-summaries":{"get":{"operationId":"ListLendingProtocolSummaries","tags":["Lending"],"summary":"What is this endpoint for?","description":"Protocol summaries list every lending protocol Kaiko covers on a blockchain, with its current total deposits, collateral and borrows in US dollars. Use it to compare protocols at a glance and to find the protocol codes the other lending endpoints take.","parameters":[{"$ref":"#/components/parameters/BlockchainQuery"},{"$ref":"#/components/parameters/ApiVersionQuery"}],"responses":{"200":{"description":"One page of `LendingProtocolSummary` rows.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListLendingProtocolSummariesResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"The `blockchain` is not a Kaiko EVM chain (`unsupported_blockchain`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"$ref":"#/components/responses/NotAcceptable"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.kaiko.com/rest-api/defi-lending-and-borrowing-markets/market-data/lending-protocol-summaries.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
