Tutorial: Order Matching Bot
Introduction
Order Matching Bots (Matching Bots) are responsible for matching two orders that cross or a taker order against the DAMM. Specifically, this includes:
- Market Orders: Market Buy and Market Sell
- Limit Orders: Limit Buy and Limit Sell
Matching Bots receive a small compensation for each order that they successfully fill.
See ๏ปฟKeepers & Decentralised Orderbook for a technical explanation of how the decentralised orderbook (DLOB) and matching incentives work.
Matching Bots are similar to ๏ปฟTutorial: Order Trigger Bot in that they:
- also maintain a local copy of the Decentralised Limit Orderbook (DLOB);
- do not require the operator to manage collateral; and
- receive a small reward for performing their duties.
Getting Started
The reference implementation of the Order Matching Bot is available here.
Follow the instructions at ๏ปฟKeeper Bots to set the required environment variables and make sure a ClearingHouseUser is initialized.
Start the Matching Bot:
๏ปฟ
Technical Explanation
1. Get nodes from the DLOB that are ready to be filled
Market orders that are sent on the Drift Protocol first go through the ๏ปฟJust-In-Time (JIT) Auctions. After the auction period, Matching Bots step in to fill orders for a small reward.
The DLOB implementation includes a method for getting orders ready to be filled:
2. Filter for Fillable Nodes
To avoid trying to fill orders that aren't ready to be filled, filter out orders that are too small to fill
3. Call fill_order on DriftClient
๏ปฟ




