DocsTasks

Limit order

Buy or sell once, when the market cap reaches a level you pick.

The Limit order task form: buy or sell, the market-cap level and its direction. No task is created.

A limit order waits until the price reaches a number you pick, then buys or sells. Here the number is the token's market cap in US dollars. It trades once and then it is done.

Use it to:

  • sell when the market cap rises above a goal (a take profit);
  • sell when it falls below a floor (a stop-loss);
  • buy when it drops to a lower level.

Set it up#

  1. Open the token's terminal and click New task on the Tasks panel.
  2. Under Task type, pick Limit order. It is in the Automate group.
  3. Choose Buy or sell. The default is Sell.
  4. Enter the Market cap level in USD.
  5. Set Trade when the target: rises above the level or falls below the level.
  6. Choose the Amount type and the Amount per trade (see below).
  7. Under Wallets, pick All wallets, By role or Choose wallets.
  8. Click Create task, or tick Start immediately and click Create & start.
The Limit order form: the market cap level and what to trade

The form and the card work the same for every task: see How tasks run. While it waits, the card's Orders section shows the order and the live market cap.

Settings that matter#

  • Amount type — what Amount per trade means. For a buy: SOL per wallet or % of wallet balance. For a sell: % of tokens held or % of supply.
  • Amount per trade — the amount for each wallet. A percentage cannot go above 100.
  • Wallets — All wallets uses every wallet of this token, By role every wallet with the roles you tick. Both include wallets added before the order fires. Sells skip wallets with no tokens. The dev wallet stays out unless you turn on its switch.
  • Wallets to use — which of the chosen wallets trade when the order fires. The default, Every wallet, uses all of them. Take turns, Random wallet, Biggest holder, Smallest holder and Richest wallet each use only one.
  • Start delay and Run for (Advanced) — wait before the order starts watching, and stop watching after a while. Empty Run for = wait until it fires.
  • Slippage (Advanced) — how far the fill may move from the quote. Default 5 %.
It can fire the moment you start it

The order checks a level, not a crossing. If the market cap is already past your level when the task starts, it trades right away. For example, a sell that waits for "rises above $50,000" sells at once when the market cap is already $60,000. See Real funds & confirms.

The fill is not exactly your level

When the level is reached, the task sends a normal market trade. On a fast-moving token the price can be past your level by the time it lands, within your Slippage. Every trade pays network fees and the platform fee, and it cannot be undone.

All settings#

Every option on the Limit order form

limit_order
  • Buy or sellchoicedefault Sell
    BuySell
  • Market cap levelnumberrequired
    Place the order when market cap reaches this value in USD.
  • Trade when the targetchoicedefault rises above the level
    Use rises above for take profit or a breakout; falls below for a stop-loss or a lower buy price.
    rises above the levelfalls below the level
  • Amount typechoicedefault SOL per wallet
    SOL per wallet% of wallet balance
  • Amount per tradenumberrequireddefault 0.1
    Amount for each wallet on every trade, using the amount type above. Percentages cannot exceed 100.
  • Wallets to usechoicedefault Every wallet
    Choose which selected wallets trade each time.
    Take turnsRandom walletBiggest holderSmallest holderRichest walletEvery wallet
  • Start delaynumberdefault 0 ms
    Wait this long before the first trade.
  • Run fornumberoptional
    End this long after the start delay; empty = until done.
  • Max supply per walletnumberdefault 0 %0–100 %
    Hard ceiling: a wallet already holding this % of supply is skipped instead of buying more. 0 = off.
  • Slippagenumberdefault 5 %0.01–50 %

Troubleshooting#

  • The order never fires — check Trade when the target: "rises above" for a goal higher than now, "falls below" for a lower one. Check that the chosen wallets hold the token (sell) or SOL (buy).
  • "No routable pool" — the task cannot find a pool to price the token. It fails instead of guessing.
  • "… of … wallet trades confirmed; remaining trades failed or need reconciliation" — some wallets traded and some did not. The task stops. Check the wallets' balances before you start it again, so the ones that already traded do not trade twice.

See also#