whatisgithub

What is openwhale?

openwhale-org/openwhale — explained in plain English

Analysis updated 2026-05-18

24TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A TypeScript framework for building automated crypto trading strategies, with AI models callable directly inside strategy logic and a web dashboard.

Mindmap

mindmap
  root((openwhale))
    What it does
      Automated trading framework
      Monitor Strategy Executor
      AI-driven decisions
    Tech stack
      TypeScript
      Node.js
      Zod schemas
    Use cases
      Copy trading
      Arbitrage
      AI market making
    Architecture
      Decoupled layers
      Hot-reload strategies
      Trigger system

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a copy-trading bot that mirrors another wallet's trades proportionally with position limits.

USE CASE 2

Write a strategy that asks an AI model whether to buy, sell, or hold based on live market data.

USE CASE 3

Trigger cross-exchange arbitrage trades only when price spread and funding rate conditions align.

What is it built with?

TypeScriptNode.jsZod

How does it compare?

openwhale-org/openwhalecschanhniem/clawpingcub3y0nd/entropic
Stars242424
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity4/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires exchange API credentials, such as a Hyperliquid wallet and private key, to run live trading examples.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

OpenWhale is a TypeScript framework for building automated trading and economic strategies, aimed mainly at crypto markets. It structures a trading system into three independent layers: a Monitor that collects data from exchanges or other sources, a Strategy that contains the rules or AI logic deciding what action to take, and an Executor that carries out the actual trades. Because these layers are decoupled, you can swap one piece, such as replacing a live exchange executor with a mock one for testing, without touching the others. A notable feature is that strategies can call AI language models directly as part of their decision logic. A strategy can receive market data, ask an AI model whether to buy, sell, or hold, using a defined structured response format, and then act on that answer, all inside the same strategy code, with support for several AI providers. Strategies written in TypeScript can also be generated or evolved by AI and compiled and loaded at runtime without restarting the whole system. The trigger system combines scheduled timing, such as running every few minutes, with conditions from multiple monitors at once, for example firing only when a price change and a funding rate condition are both true within a specific time window. This replaces manually written polling loops with a more declarative approach to deciding when a strategy should run. Stated use cases include copy trading, which mirrors another wallet's trades, cross exchange arbitrage, AI driven market making, and automated responses to on chain events. The project is written in TypeScript, runs on Node.js, and includes a web dashboard for managing strategy instances and credentials. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Show me how to write a minimal OpenWhale strategy that buys when price crosses a threshold.
Prompt 2
How do I combine a Cron schedule with a Monitor condition using OpenWhale's trigger system?
Prompt 3
Walk me through wiring an AI model call into an OpenWhale strategy's evaluate function with a structured output schema.
Prompt 4
How would I swap a live exchange executor for a mock one to test an OpenWhale strategy safely?

Frequently asked questions

What is openwhale?

A TypeScript framework for building automated crypto trading strategies, with AI models callable directly inside strategy logic and a web dashboard.

What language is openwhale written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Zod.

What license does openwhale use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is openwhale to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is openwhale for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.