1.0.0 • Published 7 months ago

coinmarketcap-api-cryptoscan v1.0.0

Weekly downloads
-
License
ISC
Repository
github
Last release
7 months ago

CoinMarketCap API - Cryptoscan

A real-time cryptocurrency price and information tracker that monitors both centralized (CEX) and decentralized (DEX) exchanges.

Current Price: $450 Contacts: https://t.me/dan_cryptoscan

What you get:

  • Free setup into your hosting
  • Free help to integrate app to your server
  • Full access to the codebase and code updates
  • Free updates for app, you can request for free updates via access to issues
  • Full access to Project Time tracking by developers

Features

  • Real-time price monitoring for both CEX and DEX tokens
  • Automatic data refresh based on liquidity groups
  • WebSocket broadcasting of price updates
  • Rate limiting and queue management for API requests
  • Proxy support for reliable data fetching
  • REST API endpoint for grouped coin data

Architecture

Core Components

  1. Price Fetching

    • CEX prices via cryptoscan.pro API
    • DEX prices via CoinMarketCap's dexscan
    • Proxy rotation system for reliable scraping
  2. Data Management

    • File-based storage using FileMap
    • Grouped by symbol and exchange
    • Price change detection and broadcasting
  3. Rate Limiting

    • Concurrent request management (100 concurrent requests)
    • Dynamic update intervals based on liquidity groups:
      • Ultra Low Liquidity: 60 minutes
      • Very Low Liquidity: 10 minutes
      • Low Liquidity: 60 seconds
      • Medium Liquidity: 30 seconds
      • High Liquidity: 10 minutes

API Reference

GET /

Returns all coins grouped by symbol and exchange name.

Response format:

{
  "[symbol]": {
    "[exchangeName]": [
      {
        // coin data
      }
    ]
  }
}

WebSocket Updates

The system broadcasts real-time price updates when changes are detected. Connect to the WebSocket endpoint to receive live updates.

Environment Variables

  • CRYPTOSCAN_API_KEY: API key for proxy service
  • API_KEY: CoinMarketCap API key

Installation

npm install

Running the Project

Development:

npm run start:debug

Production:

npm run start

Tests:

npm test

Dependencies

  • @javeoff/proxy-fetch: Proxy rotation for requests
  • @javeoff/file-map: File-based data storage
  • hono: Web framework
  • jsdom: DOM parsing for scraping
  • p-queue: Queue management
  • bottleneck: Rate limiting
  • groupby-esm: Data grouping utility

License

ISC