Skip to main content
BlackSwan is actively evolving. Version 1.0 ships a complete testnet credit infrastructure stack — REST API, JavaScript and Python SDKs, and smart contracts on Polygon Amoy and Ethereum Sepolia. The roadmap below outlines what’s live today and what’s coming in the next two major releases. Priorities may shift based on community feedback, so check back regularly or follow us on Twitter for the latest updates.

​
v1.0 — Current

Everything listed here is live and available to use today on Polygon Amoy and Ethereum Sepolia.

Credit Dashboard API

Single-call endpoint returning trust ratio, tier, and APR for any wallet.

Reputation API

Granular reputation data including on-chain score and behavioral signals.

APR Calculation

Real-time APR in basis points, derived from a wallet’s credit tier.

Trust Tier Scoring

Five-tier (A–E) credit classification mapped from the 0–10,000 trust ratio.

Loan History

Full on-chain loan history for any wallet, including repayment outcomes.

JavaScript SDK

TypeScript-first SDK with React and Next.js integration support.

Python SDK

Python 3.8+ SDK with FastAPI and Flask integration support.

Amoy + Sepolia Testnet

Deployed and verified contracts on Polygon Amoy and Ethereum Sepolia.

​
v1.1 — Planned

v1.1 brings mainnet support and infrastructure improvements for production-grade applications.
  • Polygon mainnet — Deploy and interact with BlackSwan contracts on Polygon PoS mainnet
  • Ethereum mainnet — Mainnet deployment on Ethereum L1
  • Optimism and Arbitrum support — Expand to leading Ethereum L2 networks
  • Webhook notifications — Subscribe to on-chain events (repayments, defaults, new loans) via HTTP webhooks
  • Rate limit headers — X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After headers on all REST responses

​
v2.0 — Planned

v2.0 focuses on developer experience, scale, and cross-chain capabilities.
  • Production API keys — Managed API keys with per-key rate limits and usage analytics
  • Advanced analytics — Cohort analysis, portfolio-level credit metrics, and trend data
  • Bulk wallet queries — Submit a list of wallet addresses and receive credit profiles in a single request
  • GraphQL API — Flexible querying of credit data with field selection and nested resolves
  • Cross-chain reputation — Unified trust ratio that aggregates behavior across all supported networks
Roadmap timelines are estimates and subject to change. Follow @BlackSwanFi on Twitter for real-time announcements, release previews, and community updates.