🐝 WaspBot

WaspBot is a high-performance, framework‑agnostic trading bot library written in TypeScript, inspired by the architecture of Hummingbot.
It provides the essential building blocks for creating, testing, and running algorithmic trading strategies across multiple exchanges — without binding you to any specific framework or application runtime.

✨ Features

Vanilla TypeScript Library – No frameworks, minimal dependencies.
Exchange Connectors – Plug-and-play modules for CEX and DEX integrations.
Pluggable Strategies – Build, test, and optimize strategies with ease.
Event-Driven Core – Powerful clock and event dispatcher for scheduling and reacting to market data.
Real-Time Market Data – Order books, tickers, candles, and trades.
Order Management – Submit, track, and manage orders with position tracking.
Reusable Utilities – HTTP/WebSocket clients, math helpers, and more.
Extensible – Add new connectors, data sources, or strategies without touching the core.

📦 Installation

# Using npm
npm install wasp-bot

# Using yarn
yarn add wasp-bot

# Using pnpm
pnpm add wasp-bot

⚡️ Getting Started

To run the main WaspBot application:

npm start

To run an example bot, such as the simple-binance-bot:

# Ensure you have a .env file with BINANCE_API_KEY and BINANCE_API_SECRET
npm run example -- examples/simple-binance-bot.ts

Note: Connector examples (e.g., simple-binance-bot.ts) require environment variables like BINANCE_API_KEY and BINANCE_API_SECRET to be set. You can create a .env file in the project root or set them directly in your shell.

Example Scripts Explained:

src/index.ts: The main entry point of the WaspBot application.
examples/arbitrage-bot.ts: Demonstrates a basic arbitrage strategy.
examples/simple-binance-bot.ts: A straightforward example of connecting to Binance and executing trades.

🚀 Quick Start

import { Clock, BinanceConnector, PingPongStrategy, OrderManager } from "wasp-bot";

// 1. Create a clock for scheduling ticks
const clock = new Clock(1000); // tick every 1 second

// 2. Set up an exchange connector (Binance example)
const binance = new BinanceConnector({
  apiKey: process.env.BINANCE_API_KEY!,
  apiSecret: process.env.BINANCE_API_SECRET!,
  testnet: true
});

// 3. Create your order manager
const orderManager = new OrderManager(binance);

// 4. Initialize a strategy
const strategy = new PingPongStrategy({
  connector: binance,
  orderManager,
  tradingPair: "BTC/USDT",
  orderSize: 0.001,
  priceSpread: 0.25 // percentage from mid-price
});

// 5. Wire everything together
clock.onTick(async () => {
  await strategy.tick();
});

// 6. Start the bot
(async () => {
  await binance.connect();
  clock.start();
})();

🛠 Writing Your Own Strategy

Strategies in WaspBot follow a simple interface:

class MyStrategy {
  constructor(private connector, private orderManager) {}

  async tick() {
    // Fetch market data
    const ticker = await this.connector.getTicker("BTC/USDT");

    // Make a decision
    if (ticker.lastPrice < 30000) {
      await this.orderManager.buy("BTC/USDT", 0.001);
    }
  }
}

📡 Supported Exchanges (Planned & Implemented)

Centralized Exchanges (CEX)
- Binance
- KuCoin
- Kraken
Decentralized Exchanges (DEX)
- Uniswap (via Web3 / Ethers.js)
- SushiSwap

🔬 Testing

npm run test

WaspBot/waspbot-ts