🌐 SuperSafe API Backend

SuperSafe uses its own backend (api.supersafe.cool) to provide real-time token price data with 24h variation tracking across multiple blockchains.

Overview

SuperSafe API is a robust, scalable REST API that monitors token prices from multiple EVM blockchains, stores historical data, and provides 24-hour price variation analysis.

Technology	Description
FastAPI	Modern Python web framework
PostgreSQL	Primary database with high precision decimals
Redis	Caching layer + Celery broker
Celery	Background task processing

---

Interactive Documentation

• Swagger UI: https://api.supersafe.cool/docs
• ReDoc: https://api.supersafe.cool/redoc

---

Core Endpoints

Health Check

GET /api/v1/health

Verifies system status.

{
  "status": "healthy",
  "timestamp": "2025-08-05T10:16:47.612743Z",
  "version": "1.0.0",
  "database_status": "healthy", 
  "redis_status": "healthy"
}

Statistics

GET /api/v1/stats

Gets data fetching statistics.

{
  "total_fetches": 1440,
  "successful_fetches": 1438,
  "tokens_monitored": 5,
  "avg_fetch_duration_seconds": 0.74
}

---

Token Price Endpoints

GET /tokens/price24h

Gets token prices with 24-hour comparison.

URL: GET /api/v1/tokens/price24h?chain_id=CHAIN_ID&limit=LIMIT

Parameters:

• chain_id (query, optional) - Network ID (5330=SuperSeed, 10=Optimism, 56=BSC)
• limit (query, optional) - Maximum tokens to return (default: 100)

Response:

{
  "data": [
    {
      "chain_id": 5330,
      "token_address": "0x6ea1ffcbd7f5d210db07d9e773862b0512fa219b",
      "symbol": "SUPR",
      "name": "Superseed",
      "price_now": "0.002265340000000000",
      "price_24h_ago": "0.002180450000000000",
      "change_abs": "0.000084890000000000",
      "change_pct": 3.89,
      "market_cap": "1600079.32",
      "holders": 5172,
      "has_24h_data": true
    }
  ],
  "total_count": 3,
  "has_24h_data_count": 1,
  "timestamp": "2025-08-05T10:16:22.473704"
}

GET /tokens/:address/price24h

Gets 24h price data for a specific token.

URL: GET /api/v1/tokens/:address/price24h?chain_id=CHAIN_ID

Parameters:

• address (path, required) - Token contract address
• chain_id (query, optional) - Network ID

Response:

{
  "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "chain_id": 1,
  "price_now": 1.0015,
  "price_24h_ago": 1.0002,
  "symbol": "USDC",
  "name": "USD Coin"
}

GET /tokens

Lists all monitored tokens.

URL: GET /api/v1/tokens?chain_id=CHAIN_ID

---

Supported Networks

Network	Chain ID	Status
SuperSeed	5330	✅ Active
Optimism	10	✅ Active
BSC	56	✅ Active
Ethereum	1	✅ Active
Base	8453	✅ Active

---

Features

• 🌐 Multichain support: SuperSeed + Optimism + BSC + Ethereum + Base
• 🕐 Real-time monitoring: Price fetching every minute
• 📊 24h comparison: Current vs 24h ago prices with percentage changes
• 📈 Historical data: Multi-period charts (24h, week, month)
• 🚀 High performance: Redis caching + PostgreSQL
• 📖 Auto-documentation: Swagger UI + ReDoc

---

Document Status: ✅ Updated December 27, 2025
Version: v3.0.2+