DeFi Balance Sheets

/timeseries/defi-balance-sheets

The DeFi balance sheets endpoint has been released as a CM Labs project. Breaking changes may be introduced with minimal notice. Please exercise caution given the endpoint's experimental nature.

Coin Metrics collects various data from DeFi protocols and we serve this data in the form of DeFi balance sheets from our /timeseries/defi-balance-sheets API endpoint.

Protocol Coverage

The protocols covered in our DeFi balance sheets endpoint are listed below:

Protocol Ticker Start Date

Protocol	Ticker	Start Date
Aave V2	`aave_v2_eth`	2020-12-01
Compound V2	`compound_v2_eth`	2019-05-17

Aave V2

aave_v2_eth

2020-12-01

Compound V2

compound_v2_eth

2019-05-17

Endpoint Response

The /timeseries/defi-balance-sheets endpoint returns time series data for each DeFi protocol requested. The response is formatted as follows:

Field Description

Field	Description
`defi_protocol`	DeFi protocol name.
`block_height`	Height of the underlying blockchain's block (number of confirmed blocks since Genesis block).
`time`	The time in ISO 8601 date-time format. Always with nanoseconds precision.
`assets_total_usd`	The valuation of total assets, in USD value, that have been allocated to the protocol.
`assets_total_count`	The count of unique assets allocated to the protocol.
`assets`	An array of summary info associated with each asset allocated to the protocol, including asset, which represents the ticker of the constituent asset; total_units, which represents the total units of the constituent asset in this protocol; total_usd, which represents the total USD value that asset represents; and total_share, which represents the ratio of total USD valuation of that asset relative to the total USD valuation of the assets allocated to the protocol.
`loans_lent_total_usd`	The amount, in USD, that the protocol has lent out to users of the platform. Protocols like AAVE loan user deposits to borrowers. As a reminder, our balance sheet takes the perspective of the protocol itself. Since these loans are expected to be repaid to the protocol, they fall into the assets column as a type receivable.
`tvl_total_usd`	The Total Value Locked (TVL) of the protocol. TVL differs from Total Assets, as it represents the assets that are within the protocol and have not been lent out. In other words, the difference between TVL and Total Assets represents the aggregate value of loans made by the protocol.
`liabilities_total_usd`	The total value, in USD, of liability tokens issued by the protocol. Liability tokens are issued to users that have deposited cryptoassets into the protocol, similar to capital deposited by customers at a bank. These are tokens exclusively minted by DeFi protocols and usually follow specific nomenclature standards. For example, AAVE issues a-tokens like aUSDC, whereas compound issues c-tokens like cUSDC.
`liabilities_total_count`	The total count of different types of liabilities issued by the protocol. For example, if AAVE were to exclusively issue aUSDC and aUSDT, this field would return a value of 2.
`liabilities`	An array showcasing summary information associated with each liability issued by the protocol, including asset, which represents the ticker of the constituent liability; total_units, which represents the total units of the constituent asset in this protocol; total_usd, which represents the total USD value that asset represents; and share, which represents the ratio of total USD valuation of that liability relative to the total USD valuation of the assets allocated to the protocol.
`net_working_capital_usd`	Net Working Capital represents the difference between TVL (tvl_total_usd) and Total Liabilities (liabilities_total_usd). This ratio can be interpreted as a measure of the protocol’s ability to meet its short-term obligations, such as the repayment of its liabilities (e.g. a-tokens).
`protocol_utilization_ratio`	The Protocol Utilization Ratio represents the ratio of loans made by the protocol (loans_lent_total_usd) divided by its liabilities (liabilities_total_usd). As such, it is intended to represent how much the protocol is being used. In lending protocols, for example, this metric would reflect how efficiently the protocol is generating loans with its deposited capital.
`liquid_supply_ratio`	The Liquid Supply Ratio represents the ratio between TVL (tvl_total_usd) and Total Liabilities (liabilities_total_usd). In lending protocols, for example, this can be interpreted as the percentage of the supply allocated to the protocol that is liquid and can be used for loans.
`current_ratio`	If users make the assumption that a DeFi lender's liabilities (deposited capital from Aave users) can mostly be considered short-term liabilities, then the current ratio can be conservatively approximated by TVL (tvl_total_usd) / Total Liabilities (liabilities_total_usd), which is the same as the Liquid Supply Ratio above.
`debt_to_assets_ratio`	The Debt to Assets Ratio represents the ratio between Total Liabilities (liabilities_total_usd) and Total Assets (assets_total_usd). For many protocols, especially lending platforms, this ratio is expected to always be close to 1 given the dynamics of DeFi loans.

defi_protocol

DeFi protocol name.

block_height

Height of the underlying blockchain's block (number of confirmed blocks since Genesis block).

time

The time in ISO 8601 date-time format. Always with nanoseconds precision.

assets_total_usd

The valuation of total assets, in USD value, that have been allocated to the protocol.

assets_total_count

The count of unique assets allocated to the protocol.

assets

An array of summary info associated with each asset allocated to the protocol, including asset, which represents the ticker of the constituent asset; total_units, which represents the total units of the constituent asset in this protocol; total_usd, which represents the total USD value that asset represents; and total_share, which represents the ratio of total USD valuation of that asset relative to the total USD valuation of the assets allocated to the protocol.

loans_lent_total_usd

The amount, in USD, that the protocol has lent out to users of the platform. Protocols

like AAVE loan user deposits to borrowers. As a reminder, our balance sheet takes the

perspective of the protocol itself. Since these loans are expected to be repaid to the

protocol, they fall into the assets column as a type receivable.

tvl_total_usd

The Total Value Locked (TVL) of the protocol. TVL differs from Total Assets, as it

represents the assets that are within the protocol and have not been lent out. In other

words, the difference between TVL and Total Assets represents the aggregate value of

loans made by the protocol.

liabilities_total_usd

The total value, in USD, of liability tokens issued by the protocol. Liability tokens are

issued to users that have deposited cryptoassets into the protocol, similar to capital deposited by customers at a bank. These are tokens exclusively minted by DeFi

protocols and usually follow specific nomenclature standards. For example, AAVE

issues a-tokens like aUSDC, whereas compound issues c-tokens like cUSDC.

liabilities_total_count

The total count of different types of liabilities issued by the protocol. For example, if

AAVE were to exclusively issue aUSDC and aUSDT, this field would return a value of 2.

liabilities

An array showcasing summary information associated with each liability issued by the

protocol, including asset, which represents the ticker of the constituent liability;

total_units, which represents the total units of the constituent asset in this protocol;

total_usd, which represents the total USD value that asset represents; and share,

which represents the ratio of total USD valuation of that liability relative to the total USD valuation of the assets allocated to the protocol.

net_working_capital_usd

Net Working Capital represents the difference between TVL (tvl_total_usd) and

Total Liabilities (liabilities_total_usd). This ratio can be interpreted as a

measure of the protocol’s ability to meet its short-term obligations, such as the

repayment of its liabilities (e.g. a-tokens).

protocol_utilization_ratio

The Protocol Utilization Ratio represents the ratio of loans made by the protocol

(loans_lent_total_usd) divided by its liabilities (liabilities_total_usd). As such, it is intended to represent how much the protocol is being used. In lending protocols, for example, this metric would reflect how efficiently the protocol is generating loans with its deposited capital.

liquid_supply_ratio

The Liquid Supply Ratio represents the ratio between TVL (tvl_total_usd) and Total

Liabilities (liabilities_total_usd). In lending protocols, for example, this can be

interpreted as the percentage of the supply allocated to the protocol that is liquid and

can be used for loans.

current_ratio

If users make the assumption that a DeFi lender's liabilities (deposited capital from

Aave users) can mostly be considered short-term liabilities, then the current ratio can be

conservatively approximated by TVL (tvl_total_usd) / Total Liabilities

(liabilities_total_usd), which is the same as the Liquid Supply Ratio above.

debt_to_assets_ratio

The Debt to Assets Ratio represents the ratio between Total Liabilities

(liabilities_total_usd) and Total Assets (assets_total_usd). For many

protocols, especially lending platforms, this ratio is expected to always be close to 1

given the dynamics of DeFi loans.

A sample of DeFi balance sheet data in json format is provided below.

{
  "data" : [ {
    "defi_protocol" : "protocol1",
    "block_height" : "15821368",
    "time" : "2022-10-25T00:00:00.000000000Z",
    "assets_total_usd" : "5206858775.8887",
    "assets_total_count" : "5",
    "liabilities_total_usd" : "5207569174.7343",
    "liabilities_total_count" : "4",
    "loans_lent_total_usd" : "1643900213.0442",
    "tvl_total_usd" : "3562958562.8445",
    "net_working_capital_usd" : "-1644610611.8898",
    "assets" : [ {
      "asset" : "asset1",
      "total_units" : "16642572.299665700155624691",
      "loans_lent_units" : "3034432.558303788296351088",
      "tvl_units" : "13608139.741361911859273603",
      "total_usd" : "9421036.866",
      "loans_lent_usd" : "1717733.3218",
      "tvl_usd" : "7703303.5442",
      "total_share" : "0.001809",
      "loans_lent_share" : "0.001045",
      "tvl_share" : "0.002162"
    }, {
      "asset" : "asset2",
      "total_units" : "3.451110208332495257",
      "tvl_units" : "3.451110208332495257"
    }, {
      "asset" : "asset3",
      "total_units" : "1745617.903650065714276",
      "tvl_units" : "1745617.903650065714276",
      "total_usd" : "148378761.035",
      "tvl_usd" : "148378761.035",
      "total_share" : "0.028497",
      "tvl_share" : "0.091645"
    }, {
      "asset" : "asset4",
      "total_units" : "82725.553558289864058706",
      "loans_lent_units" : "31738.572718926909253698",
      "tvl_units" : "50986.980839362954805008"
    }, {
      "asset" : "asset5",
      "total_units" : "924683.504980413732672045",
      "loans_lent_units" : "482347.607737316633044131",
      "tvl_units" : "442335.897243097099627914",
      "total_usd" : "1243286021.2045",
      "loans_lent_usd" : "648541944.1693",
      "tvl_usd" : "594744077.0352",
      "total_share" : "0.238779",
      "loans_lent_share" : "0.394514",
      "tvl_share" : "0.166924"
    } ],
    "liabilities" : [ {
      "asset" : "liability1",
      "total_units" : "16642568.377251250315561367",
      "total_usd" : "9421034.6455",
      "total_share" : "0.001809"
    }, {
      "asset" : "liability2",
      "total_units" : "3.451110208332495257"
    }, {
      "asset" : "liability3",
      "total_units" : "930352212.629909",
      "total_usd" : "930289317.7994",
      "total_share" : "0.298642"
    }, {
      "asset" : "liability4",
      "total_units" : "925062.111387555686554298",
      "total_usd" : "1243795077.6017",
      "total_share" : "0.238844"
    } ],
    "protocol_utilization_ratio" : "0.315676",
    "liquid_supply_ratio" : "0.684189",
    "current_ratio" : "0.684189",
    "debt_to_assets_ratio" : "1.000137"
  } ]
}

PreviousDecentralized Exchange Data NextDeFi FAQs

Last updated 25 days ago