# StableLens

> StableLens is a real-time stablecoin peg stability monitoring platform that tracks 180+ stablecoins across multiple blockchains. It provides stability scores, depeg event detection, price history, and multi-coin comparison through both a web dashboard and a REST API.

Key information:
- Base URL: https://stablelens.io/api/v1
- Authentication: Public endpoints require no key; protected endpoints use the `X-API-Key` header
- Rate Limits: 30 requests/min (public), 60 requests/min (API key, configurable per key)
- Response Format: JSON over HTTPS
- Data Coverage: 180+ stablecoins with minute-level price tracking
- Depeg Detection: Automatic severity classification (minor, moderate, major, critical)

## API Reference

- [API Documentation](https://stablelens.io/docs): Full interactive API reference with all endpoints, parameters, and response examples
- [API Docs (Markdown)](https://stablelens.io/docs.md): AI-readable markdown version of the complete API documentation

## Getting Started

- [Health Check](https://stablelens.io/api/v1/health): Check API and database status — no authentication required
- [Single Token Lookup](https://stablelens.io/docs#ep-token-single): Look up any stablecoin by symbol (e.g. USDT, USDC, DAI) — no authentication required
- [Authentication Guide](https://stablelens.io/docs#authentication): How to authenticate with API keys for protected endpoints

## Endpoints

- [GET /api/v1/health](https://stablelens.io/docs#ep-health): Check API and database status, returns 503 if database is unreachable (public)
- [GET /api/v1/tokens/:symbol](https://stablelens.io/docs#ep-token-single): Look up a single stablecoin by symbol with price, stability score, peg streak, and depeg history (public)
- [GET /api/v1/tokens](https://stablelens.io/docs#ep-tokens-all): List all active stablecoins with current stability metrics (API key required)
- [GET /api/v1/tokens/:symbol/history](https://stablelens.io/docs#ep-history): Historical price snapshots for charting, capped at 30 days and 500 data points (API key required)
- [GET /api/v1/events](https://stablelens.io/docs#ep-events): Depeg events from the last 90 days with filtering and pagination (API key required)
- [GET /api/v1/events/:id](https://stablelens.io/docs#ep-event-detail): Full details for a single depeg event including coin metadata (API key required)
- [GET /api/v1/compare](https://stablelens.io/docs#ep-compare): Multi-coin comparison with stability scores, statistical metrics, and 30-day price history (API key required)
- [POST /api/v1/webhooks](https://stablelens.io/docs#ep-webhooks): Register a webhook to receive depeg alerts, HTTPS URLs only, max 10 per API key (API key required)

## Error Handling

- [Status Codes](https://stablelens.io/docs#status-codes): Complete list of HTTP status codes (200, 201, 400, 401, 404, 405, 409, 429, 503) with descriptions
- [Rate Limits](https://stablelens.io/docs#rate-limits): Rate limiting details for public and API key tiers, plus data export limits

## Integrations

- [Webhook Alerts](https://stablelens.io/docs#ep-webhooks): Register HTTPS webhooks to receive real-time depeg event notifications
- [Price Comparison Tool](https://stablelens.io/compare): Interactive multi-stablecoin price comparison charts on the web dashboard
- [Pricing Plans](https://stablelens.io/pricing): API key plans and subscription details for programmatic access

## Optional

- [StableLens Homepage](https://stablelens.io): Main dashboard with live stablecoin stability overview
- [Pricing](https://stablelens.io/pricing): Subscription plans for API access
- [Full Documentation (Single File)](https://stablelens.io/llms-full.txt): Complete documentation in a single markdown file for LLM context windows