dreamBot Builder

The dreamBot Builder turns a trading idea into a running bot in five steps. You pick a ready-made strategy, tune it, and get a config file for the open-source dreamDEX bot kit or for DreamFly. Then you run the bot yourself, on Railway or on your own machine.

Open it from the dreamBot tab in the app:

AppWhat you can build
app.dreamdex.io/dreambot-builderSpot and Event Contracts bots, for testnet or mainnet
app.testnet.dreamdex.io/dreambot-builderThe same, plus Perps bots for the testnet

The builder never sees your key. It writes a config with a PRIVATE_KEY=0x... placeholder, and you add the key yourself wherever the bot runs. dreamDEX doesn't host, run or monitor your bot.

What you can build

Build your ownDeploy DreamFly
What it isOne strategy from the bot kit, tuned by you, that you can grow into your own codeA ready-made bot: a model of a fruit fly's brain picks which strategy to run on each market, or to sit out, and learns from the result
MarketsSpot, Event Contracts, and Perps on the testnet appSpot, Event Contracts, and Perps on the testnet app, one network per run
Codedreamdex-bot-kit (TypeScript)dreamdex-dreamfly (Python, with Node for perps and event contracts)
How you watch itIts logsA dashboard in your browser
MoreStrategiesDreamFly

The five steps

  1. Connect wallet. Sign in to the app. For a Perps bot, the builder fills in the wallet you are on as the account the bot will trade.
  2. Strategy. Choose Build your own or Deploy DreamFly. For your own bot, pick a market type (Spot, Event Contracts or Perps) and a strategy. For DreamFly, pick which run: spot, event contracts or perps. See Strategies.
  3. Network. Choose Testnet (practice) or Mainnet, and Dry-run (logs only) or Live (sends real orders). Every new bot starts on testnet in dry-run. A Perps bot has a single choice, the testnet, because there are no perp markets on mainnet.
  4. Tune. Each setting starts at the strategy's own default. Show advanced settings opens the rest. The builder stops you at this step if a setting would keep the bot from starting, such as a DreamFly bot with no dashboard password or a Perps account address that isn't a full 0x address.
  5. Deploy bot. Copy or download your .env, then run the bot on Railway or on your own machine. See Run Your Bot.

The last button, Trade on dreamdex, opens the market your bot trades, so you can watch its orders arrive on the book.

Before you start

  • A wallet for the bot. A Spot or Event Contracts bot trades with the key you give it, so make a new wallet for it and move in only what you want it to trade, plus gas (SOMI on mainnet, STT on testnet). A Perps bot keeps its own key and trades one of your app wallets through Link a Bot.
  • Test funds for testnet. The Quick Start lists the testnet faucets.
  • Somewhere to run it. Railway needs nothing installed. On your own machine, a kit bot needs Node.js 20 or later, and DreamFly needs Python 3.11 or later plus Node.js 20 or later.

Safe by default

  • Non-custodial. Your key stays on the machine or service that runs the bot.
  • Testnet and dry-run first. A dry-run bot logs the orders it would place and sends nothing. Nothing goes live until you switch both settings yourself.
  • Open source. Every strategy is public on GitHub, so you can read each line before you run it.

Automated trading can lose money, including everything a bot's wallet holds, and a strategy can behave in ways you didn't expect. The templates are tools, not investment advice. Start on testnet, then go live on mainnet with small sizes. Use of the builder is governed by the dreamDEX Terms of Service and the bot kit's Repository Legal Disclaimer.