Stop Market
Overview
Token prices change at any time, including outside the hours you are at a screen. Without an order in place, acting on a price movement means either monitoring the market and swapping manually, or accepting the price available when you next check.
Manual monitoring has practical limits. A price alert still requires reaching a device, connecting a wallet, and completing a swap, and the price can move further while that happens.
Acting on a price condition is straightforward where the tokens are held for you. This order type is standard on centralised exchanges, and an on-chain service that takes custody can do the same: a contract holding your tokens can watch a price and swap what it holds. Either way, the tokens have to leave your wallet first.
Doing it without custody is the harder problem. If the tokens stay in your wallet, you remain free to move, spend or swap them at any time, so the order cannot rely on having them. It has to be carried out against whatever balance is available at the moment the condition is met.
A Stop Market order works that way. You set the price that should trigger the swap in advance, based on third-party price data, and the order is automatically triggered for execution at the prevailing market price when the specified price condition is met, without requiring you to be present. Your tokens stay in your wallet the whole time the order rests, and the decision is made before the market moves rather than at the moment it does.
What is KyberSwap’s Stop Market?
A Stop Market is an order type that automatically triggers a token swap for execution when two conditions are met: its price reaches a trigger price you set in advance as determined by Oracle price data, and the swap can return at least your accepted Min. Receive.
You set two things in advance: the price that should trigger the swap — the trigger price — and the slippage you are willing to accept, which fixes Min. Receive, the least the swap can return. Your order is checked against the Oracle price, is automatically triggered for execution once both conditions hold, without further confirmation.
The two conditions do different jobs. The trigger price decides when the order becomes executable. Min. Receive decides whether the swap goes through at that moment — if the swap would return less than that amount, the order is not executed, and it keeps retrying until the conditions are met.

What are the benefits of a Stop Market?
The price level is set in advance. The trigger price defines how far the market can move before the swap is triggered, and it is decided before the market moves at all.
The worst acceptable outcome is set in advance too. Min. Receive is the least the swap can return. If the market cannot offer at least that much, the swap is not executed.
Your tokens stay in your wallet. Nothing is locked or transferred to KyberSwap while the order rests, so the tokens remain available to use. Because they are not locked, an order covers only the balance available when it executes — see What happens if your balance changes?.
Placing and cancelling are free. You are only charged when an order actually executes.
How is a Stop Market different from a Limit Order?
Both order types rest until the market moves. The difference is what each one sets: a Limit Order sets the rate it trades at; a Stop Market order sets the price level at which the order is triggered for execution.
Where you set the price
Any rate
Below the current price
How it is executed
A taker, who chooses to trade at your rate
Triggered for execution and routed on-chain through the KyberSwap Aggregator, once all conditions are met.
Executes at
Exactly the rate you set
The market price available at the execution time, less the fee, when the trigger price is reached, never below your Min. Receive Amount
Certainty of execution
Takers must consider the order's size, gas fees, and personal profit margin before deciding to fill an order
Triggers once the trigger price is reached; and executes when the swap returns at least your Min. Receive Amount and network gas are within an executable range.
Certainty of price
The rate is fixed when you create the order
Depends on the market price at the execution time, with the min amount out protection.
Fee
No fee for the order maker — the taker pays the gas
A fee on execution, covering the protocol fee and gas fee.
How Stop Market works
What are the steps?

Set your trigger price and maximum slippage. The trigger price is when the swap should be executable; the slippage setting fixes Min. Receive, the least the swap can return. Both are shown before you sign.
Approve the token, then sign. If the token has not been approved yet, your wallet first asks you to approve it - a one-time on-chain transaction per token per chain, which requires gas. Creating the order itself is a free signature and sends no on-chain transaction. Your order is then checked against the Oracle price, and your tokens stay in your wallet.
The trigger price is reached. That is the first condition met.
A route is checked. The KyberSwap Aggregator looks for a route that returns at least your Min. Receive. If none does, the swap is not submitted and the order waits in Retrying.
The swap is submitted on-chain. The network gas is covered by the fee, which is deducted from the tokens you receive.
Apart from a first-time token approval, only the last step touches the chain. You can edit or cancel at any point before it, free of charge and without sending an on-chain transaction.
What decides where an order is executed?
The trigger price is set below the current price. If you want to set a trigger price above the current one, consider a Limit Order instead — it fills at exactly the rate you set, with no slippage and no fee.
For an order to be executed, conditions have to hold at the same time.
The Oracle price reaches your trigger price, or falls below it — as determined by third-party price data. This triggers the order.
The swap returns at least your Min. Receive. This decides whether it goes through.
Network gas is within an executable range. The fee covers the on-chain execution cost, so an attempt is skipped if gas would take up too much of it, and resumes once gas settles.
Min. Receive is calculated based on your trigger price, maximum slippage, and fees. It is shown on the review screen before signing and represents the minimum you’ll receive if your order is executed.
Your order is checked against the Oracle price — third-party price data published on-chain — every 5 seconds, so there is a short delay between the market reaching your level and the order being triggered.
The second condition is the one that varies. The Oracle price is a reference price rather than one you can trade at, so what a swap actually returns moves with liquidity and with how fast the market is moving. When the Oracle price has reached your trigger but a swap cannot yet return your Min. Receive, the order shows as Retrying — it stays in your Active Orders, your tokens stay in your wallet, and it is checked again on each cycle until it is executed, expires, or you cancel it.
Example
The Oracle price for ETH is 2,500 USDC on Ethereum. You set a trigger of 2,000 with 2% maximum slippage, so selling 1 ETH gives a Min. Receive of 1,957 USDC — 2% below your trigger and after the fee.
ETH falls and the Oracle price reaches 2,000, so the first condition is met and the order is triggered. But the market is moving quickly, and at that moment a swap would return only 1,940 USDC. That is below your Min. Receive, so nothing is submitted and the order shows as Retrying.
The order is checked again on each cycle. A short time later the market steadies and a swap returns 1,973 USDC — above your Min. Receive — so it executes at that price. You receive more than the minimum, your tokens stayed in your wallet throughout, and nothing was cancelled.
A spike in network gas can cause the same wait, for the same reason.
Which price does a Stop Market monitor?
A Stop Market evaluates the trigger price against an Oracle price, powered by Chainlink — a reference price published on-chain, drawn from many sources rather than from any single liquidity pool. Because of that, a manipulated pool price would not, on its own, necessarily trigger an order. For background on how Oracles work, see Oracles.
For further details, you can refer to Chainlink documentation: https://docs.chain.link/data-feeds.
What are the Stop Market statuses?

Active
The order is being monitored and the trigger price has not been reached.
Triggered
The trigger price has been reached and the swap is being submitted.
Retrying
The trigger price was reached but the swap has not gone through. The order stays in Active Orders and is checked again on the same schedule as every other order. For more details on how Retrying works, you can refer to .
Executed
The order has been filled and is complete. The tokens received are in your wallet. An order that filled against a reduced balance is also Executed — see What happens if your balance changes?.
Partial Executed
Your balance covered only part of the order. That part was swapped and the remainder was cancelled.
Cancelled
You cancelled the order before it was executed.
Expired
The order reached its expiry without the trigger price being reached.
What happens if your balance changes?
Your tokens are not locked while a Stop Market rests, so the balance available to the order can change after you create it. The same applies to your token approval (allowance): if you revoke or lower the allowance amount, the order can use only what the approval still covers.
You can place multiple orders for the same token, as long as their combined amounts do not exceed your wallet balance. To place additional orders, you can reduce the amount of an existing order or cancel it.
An order is executed only once, for the smallest of three amounts: the order amount, your wallet balance at that moment, and your token approval (allowance).
If your balance and approval both cover the order, the whole amount is swapped and the order is Executed.
If your balance or approval covers only part of it, that part is swapped and the remainder is cancelled. The order is Partial Executed and does not run again.
If there is no balance or no approval at all, nothing is swapped and nothing is cancelled. The order stays in your Active Orders and can still execute later, once the token is back in your wallet and approved, until it expires.
For example: You place an order to swap 1 ETH, and approve 1 ETH for it. What happens then depends on what is actually there at the moment the order is executed.
At the moment it executes
What happens
1 ETH in your wallet, 1 ETH approved
All 1 ETH is swapped. The order is Executed.
0.2 ETH in your wallet, 1 ETH approved
Your balance is the smallest of the three, so 0.2 ETH is swapped and the remaining 0.8 ETH is cancelled. The order is Partial Executed.
1 ETH in your wallet, 0.2 ETH approved
Now the approval is the smallest, and the result is the same: 0.2 ETH is swapped and the remaining 0.8 ETH is cancelled. The order is Partial Executed.
No ETH in your wallet or no approval
Nothing is swapped and nothing is cancelled. The order stays Active until it expires.
In both Partial Executed rows, the order is finished. Moving the ETH back into your wallet, or raising the approval again, does not restart it.
Supported tokens, chain and fees
Which tokens can be used with a Stop Market?
The token being used has to meet two conditions.
It has a Chainlink price feed on the chain you are using. A Stop Market order depends on continuous price monitoring, so a token without a feed cannot be used. View the list of supported tokens by Chainlink here: https://data.chain.link/feeds?categories=Crypto.
KyberSwap has added it to the supported list for Stop Market orders. A price feed on its own is not enough — each token is also mapped on the KyberSwap side before it becomes available.
Which chains are supported?
Stop Market is available on Supported Exchanges And Networks.
What is the fee structure?
Placing, editing, and cancelling a Stop Market are free. A fee is charged only when an order executes, and it is deducted from the tokens you receive.
For the fee structure, you can refer to: Fee Schedule.
The fee that applies to your order is shown on the order form and again in the review screen before you confirm, as an amount in the tokens you are receiving.
Last updated
Was this helpful?