arbitrage-loader-cryptoscan v1.0.0

Arbitrage Loader - Cryptoscan

A real-time cryptocurrency arbitrage detection system that monitors price differences between various exchanges (CEX and DEX) and identifies profitable trading opportunities

Current Price: $360 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 monitoring of cryptocurrency prices across multiple exchanges
• Detection of arbitrage opportunities between:
  • CEX to CEX (Centralized Exchanges)
  • DEX to CEX (Decentralized to Centralized Exchanges)
• Configurable spread thresholds for notifications
• WebSocket API for real-time updates
• Spread change triggers to minimize noise

Installation

# Clone the repository
git clone [repository-url]

# Install dependencies
bun install

Usage

Starting the Server

bun start

The server will start on port 3000 by default.

WebSocket API

Connect to the WebSocket server to receive real-time arbitrage opportunities:

Basic Connection

wscat -c ws://localhost:3000/

Filtered Connection with Thresholds

Connect and set spread thresholds to receive only specific opportunities:

# Connect and send threshold configuration
wscat -c ws://localhost:3000/

Setting Spread Thresholds

Send a JSON message after connection to configure spread thresholds:

{
  "thresholds": {
    "spread": {
      "min": 0.1,
      "max": 10
    }
  }
}

This will only show arbitrage opportunities with spreads between 0.1% and 10%.

Listen Endpoint

For a simplified connection with default thresholds (-999% to 999%):

wscat -c ws://localhost:3000/listen

Architecture

Core Components

1. Price Listeners

   • listenCexPrices: Monitors centralized exchange prices
   • listenDexPrices: Monitors decentralized exchange prices

2. Arbitrage Detectors

   • listenCexArbitrage: Detects arbitrage between centralized exchanges
   • listenDexCexArbitrage: Detects arbitrage between DEX and CEX

3. WebSocket Server

   • Handles real-time client connections
   • Manages spread thresholds
   • Broadcasts arbitrage opportunities

Configuration

Key constants in constants.ts:

SPREAD_CHANGE_TRIGGER = 0.05  // Minimum spread change to trigger notification (5%)

API Endpoints:

• CEX Prices: ALL_API_URL
• DEX Prices: DEX_PRICES_URL
• WebSocket Prices: LISTEN_CEX_PRICES_API, LISTEN_DEX_PRICES_API

Message Format

Arbitrage opportunities are broadcast in the following format:

{
  exchangeFrom: string;    // Source exchange
  exchangeTo: string;      // Destination exchange
  symbol: string;         // Trading pair symbol
  priceFrom: string;      // Buy price
  priceTo: string;        // Sell price
  spread: number;         // Percentage profit potential
}

Dependencies

• bignumber.js: Precise numerical calculations
• hono: Web framework
• ws: WebSocket client
• @javeoff/ws-reconnect: WebSocket reconnection handling
• cryptoscan-provider: Price data provider

Development

The project is built with:

• TypeScript
• Bun runtime
• WebSocket for real-time communications
• BigNumber.js for precise calculations

License

ISC