Testnet on Base Sepolia: 1 ZRO here is 0.0001 test ETH.
Docs · Limit orders and automation

Docs · For traders

Limit orders and automation

An order locks your ZRO or tokens in a contract until its condition comes, then trades through the router at the best price. Every order names the least it must get, and no condition can override that. You can cancel at any time and get back whatever hasn't filled.

Every kind of order

OrderSideFills when
LimitBuy or sellThe market pays at least your minimum, after fees
Take profitSellA limit sale above the price now
Stop lossSellA sale would fetch your level or less, and still at least your floor
Trailing stopSellThe value has dropped your chosen share below the highest it reached
Buy on pool / Sell on poolBuy or sellThe token moves from its curve to its pool
Sell when dev sellsSellThe creator has sold the share of their holding you chose
DCABuyIn equal parts, a set time apart

Orders work for tokens launched here, on the curve and on their pool. Pick Limit or TP / SL on the trade card, or open the automation panel for the rest.

Limit orders

Set the level as a market cap and an amount. A buy locks your ZRO, a sale locks your tokens. It lasts 1 hour, 1 day or 7 days, a day if you don't choose. Click a level on the chart's price scale to start an order there.

A worked example

A token is at a market cap of 12,000 ZRO. You place a limit buy of 400 ZRO at 8,000 ZRO. The contract locks 400 ZRO and works out the least number of tokens 400 ZRO must buy at that level, after fees and the 0.04 ZRO run fee. Nothing happens until the market falls far enough that 399.96 ZRO buys at least that many. Then anyone may fill it, and the tokens go straight to your wallet.

A buy has to be more than twice the run fee, so more than 0.08 ZRO.

Take profit and stop loss

On a token you hold, the TP / SL tab sets ways out of a share of your holding, 25%, 50% or 100%:

SettingDefaultWhat it does
Take profit 1+100%Sells when the tokens are worth double
Take profit 2offA second level. Then the first sells 25%, 50% or 75% of the share, 50% if you don't choose
Stop loss−40%Sells when they are worth 40% less. It never sells below half that level
TrailingoffA drop from the high, in percent. See below

Example: your tokens would sell for 40 ZRO now. A stop loss at −40% fires once a sale would fetch 24 ZRO or less, and its floor means it never sells for less than 12 ZRO. If the price crashes through the floor in one move, the order waits rather than selling at any price.

A stop is judged by what the sale really fetches. The contract checks the stop after selling, against the ZRO that actually came back. A fake price can't trigger it, and it can't sell below your floor.

Trailing stops

A trailing stop remembers the most your tokens were worth since you placed it, and sells once they are worth your chosen share less. With a 20% trail, tokens that rise to 200 ZRO and fall back to 160 ZRO sell. The high is raised on chain by whoever runs the keeper, at most every ten seconds, so a spike shorter than that may not count.

Orders on events

OrderDefaultFires when
Sell on poolonThe token graduates. Many traders sell at the move
Sell when dev sells50%The creator holds half or less of what they held when you placed it
Buy on poolup to 2× the pool priceThe token graduates, buying at no more than twice the price its pool opens at

These only work for tokens launched here, because only their curve and creator are known to the contract.

DCA

Spreads a buy over time. Set a total, a number of parts from 2 to 100 (5 if you don't choose), how many minutes apart (10 by default), and the highest market cap you'll pay (three times today's by default). Each part is held to its share of your minimum. A DCA order has no expiry.

Example: 400 ZRO in 5 parts, 10 minutes apart, buys 80 ZRO at a time over 40 minutes. A part waits while the cap is above your limit.

Buying from several wallets

The Wallets tab buys with several of your own wallets at once, each its own trade.

Sale groups

Take profits, a stop loss and a trailing stop on the same tokens share one escrow. Your tokens are locked once, and whichever leg fills first takes its part from the group. The others carry on with what is left. When nothing is left, every leg closes.

  • The site builds a group of up to 4 legs. The contract allows 5.
  • A group from the TP / SL tab lasts 30 days.
  • Cancelling any leg ends the whole group and returns the tokens left, because they belong to the group, not to one leg.

Who fills, and partial fills

Anyone can fill an order and earn the run fee, 0.04 ZRO per order, so no single service has to be trusted. The contract checks the condition and your minimum itself. Submarine runs a keeper that does this, and anyone else may too. See Run a keeper.

An order can fill in parts. Each part is held to its share of your minimum and pays its share of the run fee, rounded up. Every buy moves the price against the next, so a big order at a level close to the market fills as far as its level allows and waits for the rest, as it would on an exchange.

Example: a 400 ZRO order fills 240 ZRO now and 160 ZRO later. The fillers get 0.024 and 0.016 ZRO. Portfolio shows how much has filled and at what average.

Seeing and cancelling

  • Portfolio lists your orders, with how much has filled, the status, and a Cancel button. Cancel all cancels every open one.
  • An order past its expiry that still holds funds shows Get back, which returns them.
  • If your wallet refuses the ZRO an order pays out, the contract holds it for you to withdraw to any address.
  • Each order keeps the fees it was placed under, even if the owner changes them later.
  • A fill trades through the router in your name, so it adds to your volume and rank, gets your rank's discount, shares with your referrer and earns you points, like a trade you made yourself.

The heatmap

The chart can show what has waited at each level and for how long: buys in green, sales in red, brighter the more ZRO. It covers limit orders on Submarine only, not the liquidity in a curve or a pool. Orders waiting on an event have no level, so they aren't drawn. More on The chart.