ℹ️dLIMIT Guide

Introduction To Limit Orders

A limit order is a tool from CeFi in which users can buy or sell assets at a specified price or better, instead of relying on the market price at the time of execution. In a limit order, while the price is guaranteed, the order being executed is not - limit orders will be executed only if the price meets the order qualifications.

Quickswap has integrated the dLIMIT protocol, powered by Orbs, that brings this order type to DeFi in a decentralised manner. Users can use this tool to create decentralised limit orders by following the directions below.

The dLIMIT protocol for DEXs ensures that limit orders are executed at an optimal price and at fair fees, in a decentralised and reliable manner.

How To Set Up A Limit Order

  1. Go to the exchange page and select the limit order option.

  1. Select the “From” and “To” tokens you wish to trade. In this example we chose USDC and ETH respectively, meaning we want to buy ETH with USDC.

  1. Enter the amount you wish to trade. Notice the limit price will show the current market price which will then estimate the output amount of destination tokens (ETH)

  1. Set the desired limit price. Trades will ONLY be executed when the available market price is better than or equal to the limit price. The destination token output amount will update accordingly. Press “Approve”.

In the example below, we wish to buy ETH when the price is $1,900 or better. The amount of ETH received will be equal or greater than 0.2368 ETH. Only bids equal or better than this amount will be eligible to fill the order. This amount takes into account gas costs and fees.

Important note: As the fees are paid from the output token amount, the limit price includes the gas & trading fees and so users should take this into account when setting up the price. For example, a very small order’s gas fees can total a very large percentage of the order output, reflecting an actual limit price that is not competitive with the spot market price.

  1. Press “Place order”. Double check your order details, accept the disclaimer and press “Confirm order”.

  1. Once the transaction is through, you will be able to see your order in the order history section, under “Open orders”. Users can set up real-time notifications to get an alert when their limit order gets filled using the Open DeFi Notification Protocol.

  1. Open orders can be canceled at any time by expanding the order and clicking the “Cancel Order” button.

Things To Take Into Consideration

  • Your order may not be executed if the available market price is worse than the limit price you have set.

  • The trades are based on a decentralised protocol that utilises off-chain takers which compete to fill orders. These takers are entitled to request a fee, which the protocol removes for the winning taker from the output tokens.

  • Takers may take into account gas fees for your transactions when setting their fees, which may result in fluctuations in the fee amounts.

  • When specifying a limit price, users will see in the UI the minimum amount of destination tokens they will receive if the order is filled. Only takers making bids equal or better than this amount will be eligible to fill the order. This amount takes into account gas costs and trading fees.

How Does The dLIMIT Protocol Work?

The dLIMIT protocol defines two main actors:

Makers

The first entity in the dLIMIT protocol are DEX traders that submit new orders to the dLIMIT EVM contract. They set all order parameters including the limit price. The dLIMIT contract enforces these requirements in a trustless manner.

Takers

Incentivised third-party participants that monitor all live orders and submit bids on the best path to execute their next segment. The dLIMIT contract selects the best bid and guarantees that the path that provides the best price to makers is the one executed.

The protocol has been designed such that the presence of one honest taker (i.e, a taker who charges only reimbursement for gas fees) should result in an output amount that is as close as possible to spot market prices.

Powered By Orbs

The dLIMIT protocol is developed by Orbs and powered by Orbs’ L3 technology.

Orbs Network has many independent validators running Proof-of-Stake consensus with over $100 million staked. The network has been running in mainnet since 2019. All Orbs Network validators are takers and participate as honest bidders in the protocol, guaranteeing that orders are executed 24/7 with high redundancy and best price.

Troubleshooting & FAQ

Still unsure of something? Having trouble with your order? Be sure to check the FAQ section, or join the telegram support group.

Additional Resources

You can find more information about dLIMIT in the following links:

PreviousHow To SwapNextdTWAP Guide

Last updated