Launching the first Web3 Credit Report API

Cred Protocol
5 min readApr 6, 2023

Cred Protocol is introducing the web3 Credit Report API, which offers in-depth information about the assets, creditworthiness, and history of EVM-compatible web3 accounts of individuals and businesses.

Covering 7 chains and 30 protocols, the report together with the Cred Score API, allows customized risk-based decision-making to be integrated into your platform. Our solution enables enhanced due diligence on >200m scorable user addresses, customized lending terms, and helps bridge the gap between web2 and web3 creditworthiness.

Want to see a Credit Report for your users? Visit our Developer Portal and search any active address

The first Web3 Cred Report

Last week, Cred Protocol announced that individuals could access their web3 Credit Report (Cred Report) through the Cred Protocol Dapp. The Cred Report is an extension of the Cred Score that measures the creditworthiness of an account based on its on-chain activity. The report provides data to inform and support businesses in assessing risk and offering customized lending terms.

The Cred Report ingests data points from across the spectrum of on-chain activity, allowing Cred to assess the behavior of an account and generate a score, regardless of whether a wallet has interacted with a lending protocol before. The Cred Report provides businesses with granular risk assessment information that can improve the qualification of new users, execute enhanced diligence, and offer bespoke lending terms.

The Cred Report is a step towards creating transparency in on-chain behavior and building trust in the DeFi ecosystem, ultimately unlocking access to credit. By providing businesses with the necessary information to perform risk assessments, the Cred Report aims to bridge the gap between web2 and web3 creditworthiness and offer customized lending terms to users.

The Cred Report API

All attributes of the Cred Report are accessible via API, and can be tested out in our Developer Portal.

The Cred Report covers non-lending activity across Ethereum, Arbitrum, Optimism and Polygon as well as lending activity across more than 20 cross-chain lending protocols. In real-time, we extract a snapshot of an accounts current positions and historical activity to develop a comprehensive overview of its creditworthiness.

This data is also put into context against other borrowers across these protocols to determine relative percentiles of the account.

Whilst the lending history is of vital importance for providing insight into prior borrowing behavior, only a small percentage of active wallets have ever borrowed. As a result the non-lending attributes are a key source of information for how accounts should be qualified and risk assessed with a view to their potential future creditworthiness.

Whats in the Report?

At a high level, the report is broken down into:

  1. Credit Factors: The account’s credit factor ratings (that make up the credit score).
  2. Assets: Current account assets (USD) broken down by: total, chain, protocol and ERC20 token(s).
  3. Asset History: The asset history (collateral, debt, deposits) of the account over time.
  4. General report: The non-lending summary of the account aggregated across all the chains we support.
  5. Lending Report: The account’s current, aggregate lending statistics (global summary stats) as well as a detailed break-down by protocol and ERC20 token history.

With this data a business can create a picture of the accounts interactions within the ecosystem and the behavioral patterns that they exhibit.

Whilst lenders can use this information to determine loan terms like loan size and repayment terms, non-lending businesses can also use this information to gain deeper insight into their users on chain activity in order to qualify access to products, bespoke experiences for certain user groups, or offer preferential access to services to users that most closely match their ideal user type.

The Cred Report also provides percentiles for each of the raw data attributes within the report, this important context enables a business to understand where an account sits within the total population of accounts, and accurately cohort customers by the values they exhibit for each metric.

A Deep Dive on the Report

Credit Factors: Puts the account into context by ranking it against a population of accounts on the credit factors that make up the credit score (Borrowing History, Wallet Composition, Wallet Health, Interactions, Trust, New Credit)

Assets: Broken down by total, chain, protocol and ERC20 token that the account has right now in real time

Asset Totals
Assets by Chain
Assets by Protocol
Assets by ERC20 token

Asset History: Provides the asset history (collateral, debt, deposits) of the account over time

General report: Provides a non-lending summary of the account aggregated across all the chains we support

Lending Report: Provides both the account’s current, aggregate lending statistics (global summary stats) as well as a detailed break-down by protocol and ERC20 token history

Aggregate Lending Statistics
Lending by Protocol
Protocol level statistics
Token History on a protocol

Future work and upcoming posts

Cred Protocol remains focussed on quantifying on-chain lending risk at scale, we will continue to develop products that enable businesses across trad-fi and DeFi to understand risk and embed creditworthiness at the heart of their processes.

A focus for us in near future will be to build out the proactive monitoring that our customers will be able to do on their protocols and portfolios, ensuring that risk is embedded at every stage in the product lifecycle. We are also committed to bringing in new sources of data on-chain and off-chain into our products.

If this article has inspired you to build using the Cred Report, then you can create an account on our Developer Portal here

To find out more about Cred please visit our website, subscribe to our mailing list, or join our community on Discord

If you want to hear from us on a specific topic please tweet us @cred_protocol.



Cred Protocol

Cred Protocol is a decentralized credit score that quantifies on-chain lending risk at scale using open, fair and transparent blockchain data.