Onchain Reputation API enables you to pass a wallet address, ENS, or Basename, and receive a score between -100 and +100 providing directional indication of its onchain reputation. The API also returns useful metadata informing the reputation score. You would see a score of 0 for a brand-new wallet with zero transaction history.

​
Network support

Positive scores include activity on Base and Ethereum. Negative scores include activity on Base, Bitcoin, and Ethereum.

​
Positive scores

Positive scores indicate that Coinbase’s internal systems found no risk indicators for an address, but do not represent a guarantee the address is safe. Scores closer to +100 reflect a greater quantity, variety, history, and consistency of onchain interactions.

You can use this to assess how crypto-forward a user is (and tailor experiences based on that) and gamify onchain activity.

In addition to the score, the Onchain Reputation API returns the following metadata summarizing onchain activity:

  • Total number of transactions across supported networks
  • Unique days active
  • Longest active streak (days)
  • Current active streak (days)
  • Activity period (days from first address activity to latest address activity)
  • Token swaps performed
  • Bridge transactions performed
  • Lend/borrow/stake transactions performed
  • ENS contract interactions
  • Smart contract deployments

​
Negative scores

Negative scores indicate a potential degree of risk for addresses, with scores closer to -100 indicating a higher quantity and/or recency of risk indications.

The risk score incorporates onchain transaction data (scoped to Coinbase-supported assets) for an address, as well as Coinbase data on fraud, scams, and other malicious transactions. These inputs are processed using machine learning.

In addition to the score, the API returns metadata with detail on the nature of the risk. Combined with other inputs, this can help you decide whether to transact with the address.

​
Prohibited use and disclaimers

The Onchain Reputation API may not be used, in whole or in part, for the purpose of serving as a factor in establishing a person’s eligibility for credit, insurance, employment, housing, or any other purpose under the Fair Credit Reporting Act, 15 U.S.C. § 1681, et seq.

Coinbase does not guarantee the accuracy or completeness of the data provided by the Onchain Reputation API, and Coinbase is not responsible for any failure to identify risks.