gitwtfhub

wtf is dreamdex-bot-kit?

somnia-chain/dreamdex-bot-kit — explained in plain English

Analysis updated 2026-05-18

5TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

A starter kit with a shared client and five ready-to-run strategies for building automated trading bots on Somnia's on-chain order book, DreamDEX.

Mindmap

mindmap
  root((dreamBot Kit))
    What it does
      Trading bot starter kit
      Shared client library
      Five ready strategies
    Tech stack
      TypeScript
      Python
      Solidity
    Use cases
      Market making
      Grid and TWAP trading
      Edge analytics
    Audience
      DeFi developers
      Bot builders

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

Why would anyone build with this?

REASON 1

Get a dry-run trading bot logging orders on DreamDEX testnet in about a minute using the quickstart script.

REASON 2

Clone and configure one of five built-in strategies: market-making, grid, momentum, mean-reversion, or TWAP.

REASON 3

Measure whether a market-making strategy has a real edge once trading costs are factored in.

REASON 4

Run a bot 24/7 using a session key that can trade but cannot withdraw funds.

What's in the stack?

TypeScriptPythonSolidityWebSocket

How it stacks up

somnia-chain/dreamdex-bot-kitagentigris/agentfundalange/tinyclaude
Stars555
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity4/55/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 5min

Not audited, not financial advice, test on Shannon testnet with small amounts before using a funded mainnet key.

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

Wtf does this do

DreamBot Kit is a starter kit for building automated trading bots on DreamDEX, an on-chain order book exchange built on the Somnia blockchain. It gives developers a shared client library available in both TypeScript and Python, five ready to run trading strategies, documentation for keeping a bot running continuously, and cleaned up source code from the top performing bots in an earlier DreamDEX trading competition. No prior knowledge of DreamDEX itself is assumed, since the protocol's own documentation lives elsewhere and this kit simply links to it and shows working code on top of it. The shared client library handles the repetitive parts of talking to the exchange, such as authentication, REST and WebSocket connections, placing orders, and managing transaction nonces, so each strategy can just import it instead of rebuilding that logic. The simplest strategy included is called starter, where a user only has to edit a single decision making function, while the other five, covering market making, grid trading, momentum, mean reversion, and a time weighted execution algorithm, are each fully built out with their own explanation of the tradeoffs involved. Beyond the strategies, the kit also includes a technique demo showing how to batch several actions into one transaction, and a separate analysis tool that measures whether a market making strategy is actually profitable once real trading costs are accounted for. Getting a bot running takes about a minute using a guided setup script that asks a few questions and writes a safe configuration file, after which the bot runs in a dry run mode that only logs what it would do without sending real transactions. A separate read only script can check a wallet's balances and the live order book before anything is risked. The kit defaults to Somnia's testnet, and the README recommends testing there with small amounts before ever pointing a bot at the real network. The project is licensed under MIT but comes with an explicit disclaimer: this is educational reference code, it has not been audited, it is not financial advice, and anyone using it is responsible for their own keys, settings, and any funds a bot might lose.

Yoink these prompts

Prompt 1
Help me run the quickstart script to get a dry-run DreamDEX bot working on testnet.
Prompt 2
Explain the difference between the market-making, grid, and TWAP strategies in this kit.
Prompt 3
Show me how to set up a session key so my bot can trade without holding withdrawal rights.
Prompt 4
Walk me through switching a DreamDEX bot from testnet dry-run to live mainnet trading.

Frequently asked questions

wtf is dreamdex-bot-kit?

A starter kit with a shared client and five ready-to-run strategies for building automated trading bots on Somnia's on-chain order book, DreamDEX.

What language is dreamdex-bot-kit written in?

Mainly TypeScript. The stack also includes TypeScript, Python, Solidity.

What license does dreamdex-bot-kit use?

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

How hard is dreamdex-bot-kit to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is dreamdex-bot-kit for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.