Skip to main content
BlackSwan’s trust model translates a wallet’s on-chain lending behavior into a structured credit profile. Every wallet that has interacted with the BlackSwan protocol receives a trust ratio — a numeric score that maps to a credit tier and informs the APR offered to that borrower. If you’re building lending applications on top of BlackSwan, this page explains the scoring system so you can make informed decisions about how to use and surface credit data.

​
Trust Ratio

The trust ratio is a score on a 0 to 10,000 scale, derived entirely from on-chain behavior. A higher score indicates a stronger credit history. The score is recalculated as new on-chain events occur — repayments, defaults, new loans — so it reflects a wallet’s current standing, not just a historical snapshot. You can fetch a wallet’s trust ratio via the Reputation API endpoint or the getReputation SDK method.

​
Credit Tiers

The trust ratio maps to one of five credit tiers, each carrying a label that summarizes the wallet’s credit standing:

​
APR

A wallet’s credit tier directly determines the APR it qualifies for when borrowing through the BlackSwan protocol. The relationship is straightforward: higher trust tier = lower APR. Tier A borrowers receive the most favorable rates, while Tier E borrowers face higher rates that reflect their limited or risky credit history. APR values are returned in basis points (bps). To convert to a percentage, divide by 1000 — for example, 142 bps = 0.142%. You can retrieve the current APR for any wallet using the APR API endpoint or the getAPR SDK method.

​
Factors in Trust Ratio

The trust ratio is computed from a combination of on-chain signals. The four primary input categories are:
  • Repayment history — Whether past loans were repaid on time, late, or not at all
  • Loan volume — The total value and number of loans the wallet has participated in
  • Time active — How long the wallet has been active on the BlackSwan protocol
  • Default count — The number of defaults recorded against the wallet
The exact weighting applied to each factor is proprietary and subject to change as the protocol evolves. What you can rely on is the output: the trust ratio, tier, and APR are the stable, queryable values your application should consume.
You can use trust model data directly to drive lending logic in your application. For example, gate loan offers to wallets above a minimum tier, display personalized APR quotes before a borrower commits, or surface a borrower’s trust ratio as social proof in your UI. The Credit Dashboard API returns the trust ratio, tier, and APR in a single call — making it easy to power all three use cases at once.