somnia-chain/dreamdex-bot-kit — explained in plain English
Analysis updated 2026-05-18
Get a dry-run trading bot logging orders on DreamDEX testnet in about a minute using the quickstart script.
Clone and configure one of five built-in strategies: market-making, grid, momentum, mean-reversion, or TWAP.
Measure whether a market-making strategy has a real edge once trading costs are factored in.
Run a bot 24/7 using a session key that can trade but cannot withdraw funds.
| somnia-chain/dreamdex-bot-kit | agentigris/agentfund | alange/tinyclaude | |
|---|---|---|---|
| Stars | 5 | 5 | 5 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | moderate | hard | moderate |
| Complexity | 4/5 | 5/5 | 3/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Not audited, not financial advice, test on Shannon testnet with small amounts before using a funded mainnet key.
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.
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.
Mainly TypeScript. The stack also includes TypeScript, Python, Solidity.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.