Skip to main content
BlackSwan is decentralized credit infrastructure built for the next generation of Web3 lending. It transforms raw on-chain activity into actionable credit intelligence — exposing wallet reputation scores, trust ratios, APR recommendations, and full loan history through a suite of REST APIs and developer SDKs. Whether you’re building a lending protocol, a DeFi dashboard, or an underwriting engine, BlackSwan gives you the credit primitives you need without requiring centralized intermediaries.

Quickstart

Get your first credit score in under 2 minutes.

Credit API Reference

Explore every endpoint in the BlackSwan REST API.

JavaScript SDK

Install and initialize the BlackSwan JS SDK.

Python SDK

Install and initialize the BlackSwan Python SDK.

​
What is BlackSwan?

BlackSwan is a protocol-agnostic credit layer for Web3. It reads on-chain data — borrow events, repayments, defaults, wallet age, and activity patterns — and converts that data into standardized credit signals that your application can consume directly. Instead of rebuilding credit scoring logic from scratch, developers integrate BlackSwan once and immediately gain access to:
  • Structured credit tiers (A through F) derived from real lending behavior
  • Dynamic APR recommendations calibrated to a wallet’s risk profile
  • Full loan histories including borrowed amounts, repaid amounts, and default counts
  • Soulbound token (SBT) metadata that anchors reputation on-chain
BlackSwan is designed for teams building decentralized lending apps, credit marketplaces, risk dashboards, and any protocol where trust and borrower history matter. The API is stateless and requires no authentication on testnet — you can start fetching credit data with a single curl command.

​
Key Features

Wallet Reputation

Aggregate on-chain signals into a single, normalized reputation score for any wallet address.

Credit Scores

Tiered credit scores (A–F) derived from real borrowing and repayment history across supported networks.

Trust Ratio

A numeric trust ratio that quantifies creditworthiness on a standardized scale for easy comparison and filtering.

APR Calculation

Risk-adjusted APR recommendations calculated per wallet, ready to plug directly into your lending logic.

Loan History

Complete borrow, repayment, and default records for any wallet, queryable by address and network.

Soulbound Token

On-chain SBT metadata that permanently anchors a wallet’s credit identity to its address.

REST API

Simple, stateless HTTP endpoints that work with any language or framework — no SDK required.

JS & Python SDKs

First-class SDKs for JavaScript/TypeScript and Python with full type support and async-ready interfaces.
Testnet access on Amoy and Sepolia requires no API key. Send requests directly to the API without any authentication headers.