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.

One order can hold up to five market-cap levels, each with its own amount. On a sell that waits for a rise they are named TP1 to TP5 (take profit 1 to 5). Each level trades once.

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. Leave the target at the market cap. You enter the levels in step 7.
  5. Set Trade when the target: rises above the level or falls below the level.
  6. Choose the Amount type (see below). For a sell the default is % of the whole bag.
  7. Under Levels, enter a Market cap (USD) and an Amount for each level. Click Add level for another one, up to five.
  8. Under Wallets, pick All wallets, By role or Choose wallets.
  9. 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 each level's Amount means. For a buy: SOL per wallet or % of wallet balance. For a sell: % of the whole bag, % of tokens held or % of supply.
  • % of the whole bag — a percentage of everything the order's wallets hold together, sold from the biggest wallet first. This gives fewer, bigger sells. For example, 30 % of a bag held as 500, 300 and 200 tokens sells 300 tokens from the first wallet in one trade, not 30 % from each of the three wallets. It reads every wallet that holds the token, so Wallets to use is hidden.
  • Levels — up to five, each with a market cap in USD and an amount. No two levels may have the same market cap. A percentage cannot go above 100. Each level sizes off what the wallets hold when it fires. With two sells at 50 %, TP2 sells half of what TP1 left, a quarter of the starting bag. To sell everything at the last level, give it 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 — for the other amount types, which of the chosen wallets trade when a level fires. The default, Every wallet, uses all of them. Take turns, Random wallet, Biggest holder, Smallest holder and Richest wallet each use only one. To give each wallet its own levels, make one order per wallet.
  • 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. With several levels, every level already passed trades at the start. 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
  • 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
  • Levelslevelsrequired
    Each level trades once, when the market cap in USD reaches it, its own amount in the amount type above. Up to 5 levels; each sizes off what the wallets hold when it fires.
  • 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#