Order types: stop
What it does
Section titled “What it does”A stop waits until the price reaches your trigger, then sells like a limit order.
- Stop-loss: sells if the price falls to your trigger.
- Take-profit: sells if it rises to your trigger.
- One cancels the other: one order with both a low and a high trigger; whichever comes first sells the whole order.
- Stop-limit: a stop with your own “never sell below” price.
It fires only when both an oracle price and the pool’s opening price for the block have reached the trigger. The pool’s opening price is the previous block’s close, so nobody can push it and push it back inside one block. Once it fires, a large stop fills in parts over several blocks, and the later parts don’t need the trigger again.
Stops exist only for markets with an oracle price feed.
When to use it
Section titled “When to use it”- To limit a loss, or take a profit, without watching the market.
- On larger, deeper markets, where pushing the price is expensive.
What you pay
Section titled “What you pay”- The order fee on each part, like any trade. See fees.
- An execution fee per part, within your cap (0.0011 ERG a part by default). Kadia’s settler charges only what the fill costs: a stop filled on its own pays about the miner fee, and the rest comes back in your payout.
What can go wrong
Section titled “What can go wrong”- On thin markets a stop can be triggered by a deliberate price push; set stops further from the price on small pools. Checking the oracle too makes a push much more expensive, but not impossible.
- It waits while its price feed is stale or new. A stop needs a fresh oracle price, and a feed’s observation period must be over. The app tells you when a feed is still in its observation period. If the feed stops updating, the stop pauses.
- Your “never sell below” is yours to set. The app never fills it in for you. Every part is also paid at least the oracle price, less a slippage limit you choose (2% by default).
- Bridged coins. A feed for a bridged coin reports the original coin’s price. If the bridge itself fails, that price no longer matches the bridged token’s. You can choose to sell on a bridge warning, but the app offers it only when every feed the market’s stops read is a bridged feed. For example, ERG/tBTC doesn’t get it today, because one of its two feeds isn’t bridged.
- A settler may leave it out of a batch, and nothing forces it in. Kadia’s settler fills stops that have fired first.
- No fill before expiry means a refund.
Technical details
Sources: kadia-dex docs/guide/how-it-works.md, docs/guide/fees.md and the order-type decisions in docs/decisions/ at commit 7ce1595 (7ce159587dc8c0bd78d6a5fbe0f7f8e7dde3920e).