Limit Orders
Set the price, walk away. Return To BTC watches the market 24/7 and fires your order the moment your target hits.
What Is a Limit Order?
A limit order executes only when a token reaches a price you choose. Unlike a market order, it doesn't trade immediately — it waits.
- Buy limit — buy when price drops to or below your target.
- Sell limit — sell when price rises to or above your target.
Useful for entering on dips, taking profit on the way up, or laddering in and out of a position.
Creating a Limit Order
From Trade → Limit Order:
- Pick the token (paste a contract or search).
- Choose Buy or Sell.
- Enter the target price (in BTC or USD).
- Enter the amount (input side for buys, token amount for sells).
- Optionally set an expiry (e.g. 24h, 7d, never).
- Confirm.
You'll get a confirmation card showing the order ID, target, amount, and expiry.
Multiple Targets (Laddering)
You can stack as many limit orders on the same token as you want. Common patterns:
- Buy ladder: 0.5x amount at -10%, 0.3x at -20%, 0.2x at -30%
- Sell ladder: 0.3x at +50%, 0.3x at +100%, 0.4x at +200%
This averages your entry / exit and removes the temptation to time the top.
How Execution Works
Return To BTC polls Spark prices every few seconds. When your price is hit:
- The bot re-validates your wallet balance.
- It fetches a live execution quote (respecting your slippage settings).
- It signs and broadcasts the swap on Spark.
- You get a Telegram receipt with the fill price.
If the price is hit but liquidity isn't enough to fill cleanly within slippage, the order stays active and will retry.
Managing Orders
Orders → Active shows every live order with:
- Token + side + target price
- Amount
- Distance to fill (e.g. "-3.2% away")
- Expiry countdown
- Cancel button
Tap Cancel to remove an order at any time. No fee for cancellation.
Orders → History shows filled and expired orders with full receipts.
Fees
Limit orders pay the same fees as market trades — see Trading → Fees. The 1% integrator fee is charged only on execution, not on placement.
Tips
- Always set a sane expiry. Orders set to "never" can fill years later at prices you no longer want.
- Don't ladder beyond your wallet balance — the latest orders will silently fail if your earlier fills used your liquidity.
- Use Price Alerts alongside limit orders to know why a fill happened (e.g. news, dump, etc.).
Next: DCA →
