Skip to content

About

Open-source stablecoin intelligence platform — peg/price, FX corridors, risk grading, news. React + tRPC + Drizzle.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Stablecoin Intelligence

The open-source research hub for stablecoins — graded, explained, and tracked in one place.

Stablecoins are the "digital dollars" (and euros, pesos, ringgit, and more) that people use to move money on blockchains. There are hundreds of them, they vary wildly in how safe they are, and figuring out which ones to trust is genuinely hard. Stablecoin Intelligence fixes that.


What is this?

Stablecoin Intelligence tracks 500+ stablecoins and puts everything you'd want to know about them in one searchable, readable place — prices, market sizes, reserve transparency, safety grades, news, and the real-world corridors where people are actually using them.

Every coin gets a plain letter grade (A to D) built from four things: what backs it, how openly it proves its reserves, how tightly it holds its peg, and how mature it is. You don't need to be a financial analyst to read an A or a D.

It's built for three audiences. Newcomers who want to understand what a stablecoin actually is and whether USDT and USDC are the same thing. Traders and treasury teams who need to compare options, monitor peg health, and get early warnings when something wobbles. Developers who want a clean, free data API or want to wire it into an AI assistant.



What you can do

The directory and safety layer

  • Browse 500+ stablecoins in a single de-duplicated list — the same coin doesn't appear four times just because it lives on four blockchains. Filter by chain, currency, backing model, or status.
  • Read a safety grade at a glance. A (strong), B (sound), C (watch), D (high-risk), or UNRATED. Tap through to see exactly why a coin scored the way it did across all four pillars.
  • Open a full coin profile — price chart, reserve breakdown, regulatory timeline, which blockchains and contracts it lives on, issuer info, and links.
  • Check the reserve transparency leaderboard — ranks coins by how openly and how recently they prove what's backing them. On-chain proof beats a quarterly PDF beats "trust us."
  • Compare 2–5 coins side by side — price history, peg behaviour, size, flows, and safety in one view.
  • Build a watchlist — star the coins you care about. Stays on your device when you're signed out, syncs to your account when you sign in.
  • Set a peg alert — enter an email and a drift threshold for any coin; you get notified the moment it starts to wobble.

Market views and lenses

Slice the whole market however you need it:

  • By chain — which blockchains hold the most stablecoin activity
  • By currency — every coin pegged to USD, EUR, JPY, BRL, and more
  • By backing model — fiat-backed, T-bill-backed, crypto-backed, algorithmic, and others
  • By yield — coins that pay you to hold them, tiered from "T-bill rate, low-risk" to "high APY, be careful"

Each view has its own totals and safety distribution so you can read the risk profile of a whole category in seconds.

Market signals and news

  • Four headline indices — Peg Health, Stablecoin Fear & Greed, Corridor Stress, and Emerging-Market Liquidity. A quick pulse on whether the market is calm or stressed.
  • Movers and issuance flow — biggest 7-day market-cap changes, new launches, and a live view of which coins are being minted (created) versus redeemed (cashed out) in the last 24 hours.
  • Breaking news and a daily "drama" feed — a curated strip of the depeg scares, regulatory moves, and events that actually matter. Signal, not noise.
  • Top Voices — notable commentators and what they're saying right now.
  • Risk feeds — recent DeFi hacks and a community panic signal. Early warning of trouble in the wider ecosystem.

The real-world money layer

  • The Dollar Map — a world map of money-transfer corridors showing how stablecoin rates compare to official exchange rates, and which corridors are under stress. Focused on Southeast Asia and emerging markets where this matters most.
  • Company directory — wallets, on/off-ramps, payment orchestrators, liquidity providers, compliance firms. Anyone can submit their company for listing.
  • On/off-ramp directory — licensed ramps, stablecoin debit cards, and payment rails. Answers "how do I actually buy, sell, or spend these?"
  • Regional adoption pages — country views for the Philippines, Indonesia, Malaysia, and Vietnam with local context on how stablecoins are being used for everyday payments and remittances.

Learn and explore

  • Knowledge Centre — a built-in library: a searchable glossary of stablecoin terminology, plain-English databank explainers, and longer research reports. Free for everyone.
  • Regulatory timelines — per-coin chronology of licenses, audits, incidents, and milestones.
  • Site-wide search — Cmd-K command palette to jump to any coin, page, or section instantly.

For developers and AI

  • Free public REST API — clean JSON endpoints at /api/v1 covering list, single coin, safety grade, market stats, by-currency, and by-chain. No login, no key, CORS-open. More detail in docs/REFERENCE.md.
  • Built-in AI tool server (MCP) — an MCP endpoint at /api/mcp that lets AI assistants call the platform directly. Point Claude or any MCP-compatible assistant at it and it can list coins, look one up, get a safety grade, compare coins, or pull market stats.
  • Embeddable safety badge — a drop-in SVG at /embed/safety/:ticker showing any coin's current grade. One line of HTML, works anywhere.

Under the hood

This isn't a static list with a coat of paint — it's a live data platform, and the engineering is the point:

  • One honest number per coin. A canonical-merge engine collapses each coin's deployments across every chain into a single row, so market caps and counts are real — not inflated by counting the same asset four times. All ~80 API procedures read from that one source of truth.
  • Safety grades are computed, not typed by hand. Each grade falls out of an open, tested algorithm scoring reserves, backing, peg behaviour, and maturity. The methodology lives in code (shared/safety-score.ts) — auditable and PR-able. No paid placements.
  • Always current. A background scheduler continuously sweeps prices, peg health, mint/redeem flows, and the news pipeline, backed by a snapshot cache so the UI stays fast under load.
  • AI-native by design. A built-in MCP server exposes the same graded, live data to AI assistants — ask Claude "is USDT safe?" and it answers from this platform, not from stale training data.
  • End-to-end type safety. React 19 + tRPC 11 + Drizzle + PostgreSQL — ~80 fully-typed procedures across 23 routers, behind 33 lazy-loaded pages, re-exposed read-only through a free public REST API and the MCP tools.

Architecture, request flow, and the full data model: ARCHITECTURE.md · docs/REFERENCE.md.


Quick start

Prerequisites: Node 20+, pnpm, a PostgreSQL database (local or hosted).

# 1. Install dependencies
pnpm install

# 2. Set up your environment
cp .env.example .env
# Open .env and set POSTGRES_URL to your database connection string.
# That's the only required variable to get running locally.

# 3. Push the database schema
pnpm db:push

# 4. Start the dev server
pnpm dev

Open http://localhost:3000 (the server picks the next free port if 3000 is taken, and prints the URL). You'll see the full platform running on seed data — 516 stablecoins already loaded, no external API keys needed.

Want real market prices? Add a COINGECKO_API_KEY to your .env — the free CoinGecko plan works. Everything else is optional (see Configuration below).


For developers

Stack: React 19 + Vite + TypeScript on the frontend, Express 4 + tRPC 11 + Drizzle ORM + PostgreSQL on the backend. The whole thing ships as a single unified app.

Public REST API — six read-only, no-auth endpoints at /api/v1:

Endpoint What it returns
GET /api/v1/stablecoins Filterable, paginated coin list
GET /api/v1/stablecoins/:ticker One coin + its safety grade
GET /api/v1/stablecoins/:ticker/safety Safety grade and pillars only
GET /api/v1/stats Headline counts, total market cap, backing split
GET /api/v1/currencies Breakdown by peg currency
GET /api/v1/chains Breakdown by chain

MCP AI tool server — JSON-RPC 2.0 at /api/mcp. GET returns the tool manifest; POST handles tools/list and tools/call. Five tools: list_stablecoins, get_stablecoin, get_safety_grade, compare_stablecoins, get_market_stats.

Full API surface, data model, scheduler sweeps, and internal service docs: docs/REFERENCE.md.
Architecture and request flow: ARCHITECTURE.md.


Configuration

It runs on seed data out of the box. POSTGRES_URL is the only hard requirement. The seed JSON ships with 516 verified stablecoins and loads automatically on first run via pnpm db:push + pnpm dev (or set SEED_AUTOLOAD=1 in .env to re-upsert on every boot).

Optional integrations — all configured in .env, all genuinely optional:

What Variables Adds
Real market prices COINGECKO_API_KEY Live prices, sparklines, market caps (free tier works)
Auth and user accounts PRIVY_APP_ID, PRIVY_APP_SECRET, PRIVY_JWKS_ENDPOINT, VITE_PRIVY_APP_ID Sign-in, synced watchlists, admin panel
News and drama feed NEWSAPI_KEY, CRYPTOPANIC_KEY Daily curated news pipeline
FX corridor rates OXR_APP_ID Official exchange rates (Frankfurter free tier is the fallback)
Top Voices strip APIFY_API_TOKEN, X_BEARER_TOKEN Live social commentary feed
Media storage R2_ENDPOINT, R2_BUCKET, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY, CDN_BASE_URL Image uploads (Cloudflare R2)
Upstream catalogue sync STABLECOIN_API_BASE_URL, STABLECOIN_API_KEY Opt-in enrichment — disabled unless the variable is set

See .env.example for the full list with descriptions.


Contributing

PRs welcome. The most useful contributions:

  • New stablecoins or companies — you can submit them through the in-app forms without touching code; they land in a review queue.
  • Safety grade improvements — the methodology lives in shared/safety-score.ts. Open an issue first if you're changing weights.
  • New corridors or regional data — Southeast Asia is the current focus; more regions are welcome.
  • Bug fixes and tests — pnpm test runs Vitest; pnpm check runs the TypeScript check (0 errors required before merging).

License: MIT. Use it, fork it, build on it.

About

Open-source stablecoin intelligence platform — peg/price, FX corridors, risk grading, news. React + tRPC + Drizzle.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages