config/api_keys.json

{
  "description": "API Keys Configuration for Crypto Intelligence Hub",
  "last_updated": "2026-06-07",

  "block_explorers": {
    "etherscan": {
      "keys": [
        "SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2",
        "T6IR8VJHX2NE6ZJW2S3FDVN1TYG4PYYI45"
      ],
      "env_aliases": ["ETHERSCAN_KEY_1", "ETHERSCAN_KEY_2", "ETHERSCAN_API_KEY"],
      "url": "https://api.etherscan.io/api",
      "rate_limit": "5 req/sec",
      "description": "Ethereum blockchain explorer"
    },
    "bscscan": {
      "key": "K62RKHGXTDCG53RU4MCG6XABIMJKTN19IT",
      "env_aliases": ["BSCSCAN_API_KEY", "BSCSCAN_KEY"],
      "url": "https://api.bscscan.com/api",
      "rate_limit": "5 req/sec",
      "description": "BNB Smart Chain blockchain explorer"
    },
    "tronscan": {
      "key": "7ae72726-bffe-4e74-9c33-97b761eeea21",
      "env_aliases": ["TRONSCAN_API_KEY", "TRONSCAN_KEY"],
      "url": "https://apilist.tronscanapi.com/api",
      "rate_limit": "varies",
      "description": "TRON blockchain explorer"
    }
  },

  "market_data": {
    "coinmarketcap": {
      "keys": [
        "04cf4b5b-9868-465c-8ba0-9f2e78c92eb1",
        "b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c"
      ],
      "env_aliases": ["COINMARKETCAP_KEY_1", "COINMARKETCAP_KEY_2", "COINMARKETCAP_API_KEY"],
      "url": "https://pro-api.coinmarketcap.com/v1",
      "rate_limit": "333 req/day per key",
      "endpoints": {
        "listings": "/cryptocurrency/listings/latest",
        "quotes": "/cryptocurrency/quotes/latest",
        "info": "/cryptocurrency/info"
      },
      "description": "Top cryptocurrency market data platform"
    },
    "coingecko": {
      "key": "${COINGECKO_API_KEY}",
      "env_aliases": ["COINGECKO_API_KEY", "COINGECKO_KEY"],
      "url": "https://api.coingecko.com/api/v3",
      "rate_limit": "free tier / pro with key",
      "description": "CoinGecko market data (optional key reduces 429)"
    },
    "cryptocompare": {
      "keys": [
        "313f415173eb92928568d91eee6fd91d0c7569a56a9c7579181b7a083a740318",
        "e79c8e6d4c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f"
      ],
      "env_aliases": ["CRYPTOCOMPARE_API_KEY", "CRYPTOCOMPARE", "CRYPTOCOMPARE_KEY"],
      "url": "https://min-api.cryptocompare.com/data",
      "rate_limit": "100,000 req/month (free tier)",
      "endpoints": {
        "price": "/pricemultifull",
        "ohlc": "/v2/histohour",
        "news": "/v2/news/",
        "social": "/social/coin/latest"
      },
      "description": "Comprehensive crypto data and news"
    }
  },

  "news": {
    "newsapi": {
      "keys": [
        "968a5e25552b4cb5ba3280361d8444ab",
        "pub_346789abc123def456789ghi012345jkl"
      ],
      "env_aliases": ["NEWSAPI_KEY", "NEWS_API_KEY"],
      "url": "https://newsapi.org/v2",
      "rate_limit": "100 req/day (free)",
      "endpoints": {
        "everything": "/everything",
        "top_headlines": "/top-headlines"
      },
      "description": "General news API (includes crypto)"
    }
  },

  "sentiment": {
    "custom_sentiment_api": {
      "key": "${SENTIMENT_API_KEY}",
      "description": "Custom sentiment analysis API"
    }
  },

  "ai_models": {
    "huggingface": {
      "key": "${HF_TOKEN}",
      "env_aliases": ["HF_TOKEN", "HUGGINGFACE_TOKEN"],
      "url": "https://api-inference.huggingface.co/models",
      "rate_limit": "varies"
    }
  },

  "aggregated_sources": {
    "hf_crypto_resources_api": {
      "name": "Crypto Resources API (HuggingFace Space)",
      "url": "https://really-amin-datasourceforcryptocurrency-2.hf.space",
      "docs_url": "https://really-amin-datasourceforcryptocurrency-2.hf.space/docs",
      "auth_required": false,
      "rate_limit": "unlimited",
      "endpoints": {
        "health": "/status",
        "top_coins": "/api/coins/top",
        "trending": "/api/trending",
        "market_overview": "/api/market",
        "sentiment_global": "/api/sentiment/global",
        "sentiment_asset": "/api/sentiment/asset/{symbol}",
        "resources_stats": "/api/resources/stats",
        "categories": "/api/categories",
        "resources_by_category": "/api/resources/category/{category}",
        "providers": "/api/providers",
        "system_status": "/api/status",
        "rotation": "/api/resources/rotation"
      },
      "verified": true,
      "last_verified": "2026-06-07"
    }
  },

  "notifications": {
    "telegram": {
      "enabled": true,
      "bot_token": "${TELEGRAM_BOT_TOKEN}",
      "chat_id": "${TELEGRAM_CHAT_ID}"
    }
  },

  "environment_variables": {
    "description": "Set these as Hugging Face Space secrets (Settings → Variables and secrets)",
    "required": [
      "CRYPTOCOMPARE_API_KEY",
      "COINMARKETCAP_KEY_1",
      "ETHERSCAN_KEY_1"
    ],
    "recommended": [
      "COINMARKETCAP_KEY_2",
      "ETHERSCAN_KEY_2",
      "BSCSCAN_API_KEY",
      "TRONSCAN_API_KEY",
      "NEWSAPI_KEY",
      "HF_TOKEN",
      "COINGECKO_API_KEY"
    ],
    "variables": [
      "CRYPTOCOMPARE_API_KEY=",
      "COINMARKETCAP_KEY_1=",
      "COINMARKETCAP_KEY_2=",
      "ETHERSCAN_KEY_1=",
      "ETHERSCAN_KEY_2=",
      "BSCSCAN_API_KEY=",
      "TRONSCAN_API_KEY=",
      "NEWSAPI_KEY=",
      "COINGECKO_API_KEY=",
      "HF_TOKEN=",
      "SENTIMENT_API_KEY=",
      "TELEGRAM_BOT_TOKEN=",
      "TELEGRAM_CHAT_ID="
    ]
  }
}