Order flow auctions allow you to batch and auction orders. The primary things you need to know are creating, modifying, and deleting auctions.
Why do I have to create auctions?
To access DFlow liquidity, you must create auctions for all token pairs you want to support and for all order size ranges you want to support.
E.g. if you want to support trading for ETH-USDC and ETH-BTC, you must create at least one auction for each token pair. If you want to tranche your orders by notional value, you can create multiple auctions with non-overlapping order size ranges (i.e. $100-2,500, $2,500-$5,000, $5,000-$15,000 etc.). See Best Practices below for more information.
DFlow Dashboard is the primary interface for you to create, modify, and delete auctions. In the future, DFlow will release an SDK for users who want programmatic access.
To create auctions on DFlow Chain, you'll need the Keplr browser extension and deposit USDC to your DFlow account. DFlow Chain currently uses Solana as an on-ramp so you must transfer USDC from a Solana account. Transfer is also done using the Dashboard.
Each auction on DFlow Chain costs 0.99 USDC to deploy. DFlow will cover all initial auction creation costs.
DFlow Dashboard offers two ways for you to create auctions. The Single mode is recommended for newcomers to explore auction parameters while the Multiple mode is recommended for creating bulk auctions.
The inputs on this page correspond to the parameters defined in Auction parameters.
You can create many auctions at once by importing a CSV that follows the below standards.
See below for valid CSV values for each parameter.
|Auction parameter||Example values||Description|
- Check out Supported networks for valid values.
|The network where you're originating order flow.|
|Base||- The base token.|
- EVM auctions can specify the native token using the value
- Make sure you verify token address is legit using an explorer like this one for Ethereum
|Quote||The quote token.|
|Notional size||- |
- This value is in USD
- At least $500,000
|The amount of order flow to sell.|
|Order size min||- |
- This value is in USD and is inclusive
- Specify at most two decimals
|The lower end of the order size range on the order flow.|
|Order size max||- |
- This value is in USD and is exclusive
- Specify at most two decimals
|The upper end of the order size range on the order flow.|
|Delivery period||- |
|This is the maximum delivery period per auction epoch.|
|Fee payer mode||- |
- The two options are
|The entity who sends the swap transaction on EVM networks or Solana. The transaction sender is also the transaction fee payer. Note on EVM networks, when MM is selected, the market maker will receive a reimbursement for the network gas costs from the swap order. Instead of signing a transaction, EVM users will sign a message, meaning they do not need to hold native tokens to swap.|
|Client auction ID||This is an tracking ID for your auction to be displayed publicly.|
When you have a winning auction, you can begin delivering orders for execution to the winner of the auction. Market maker liquidity is confined to parameters specified by the auction. That is, by bidding for and winning an auction, a market maker agrees to fill orders for a specific token pair (i.e. base / quote) up to a certain amount (i.e. notional size) over a specific time period (i.e. delivery period) for orders within a range (i.e. min / max).
Orders are routed to auctions based on the token pair and order size. If there is an auction of valid token pair and order size, it is considered a match. If there is no match, you have to create auctions to support that token pair and/or order size.
Overlapping order size range
It is strongly advised to create auctions that do not have overlapping order size ranges. If ETH-USDC Auction A is for sizes between $0 and $1,000, it is not recommended you create another ETH-USDC auction for sizes between $500 and $5,000. In the case there are overlapping auctions, the order will be routed to the auction of the lower ID (i.e. created first).
The DFlow Dashboard will print a warning before you deploy your auctions. Overlapping auctions have a lower probability of receiving bids from market makers.
You can modify or delete auctions to solve the overlapping order size range issue.
DFlow auctions are highly configurable and below are some recommendations for setting each parameter. All fields are modifiable after auction creation.
Estimating flow rate
DFlow auctions specify a flow rate (i.e. amount of orders delivered over a certain period of time) to the market maker. It is optimal for earnings if you consistently deliver the stated
notional sizebut you are not punished for failing to deliver. By the end of an auction epoch, unrealized bids will be returned to the market maker and over time, market makers will price in the realized flow rate.
|Auction parameter||Recommended value|
|DFlow requires at least $500,000. The value you specify is dependent on the token pair's trading volume on your platform. This value should be considered in relation to the length of the auction's delivery period too. For example, if you specify $1 million and your delivery period is 1 day, you are expected to deliver around $30 million for the month. As a reminder, |
|Setting the optimal order size range is dependent on your platform's user base and strategy. If |
DFlow auctions are designed to run perpetually. If you do not want to operate an auction anymore or to fix an overlapping order size range issue, you can delete the auction using the DFlow Dashboard.
Reminders when deleting an auction:
Deleting an auction means orders that match the auction will no longer be routed to market maker liquidity and you won't receive payments for qualifying orders.
Deleting an auction in the middle of delivery means you will forfeit any unrealized payments. Payments are paid out pro-rata based on the auction's notional size. For example, if you specified the auction should deliver $1,000,000 and only delivered $600,000, you will receive 60% of the payment.
Updated about 1 month ago
When you are finished setting up your auctions, you can start sending orders to DFlow.