Trade

Search…
Trade
This guide shows how to trade by using the LiquidityPoolFactory function and estimated amount out for a trade, then execute a trade.
QueryTrade
This section shows how to get estimated amount out for a trade.
​CallStatic method provided by ethers.js. callStatic is a useful method that submits a state-changing transaction to an Ethereum node, but asks the node to simulate the state change, rather than to execute it. Our script can then return the result of the simulated state change.
Function
queryTrade(perpetualIndex, traderAddress, amount, referrer, flags)
parameters
type
description
perpetualIndex
number
index of perpetual in the liquidity pool
traderAddress
string
address of trader
amount
number
amount of position to trader, positive for buying and negative for selling. The amount always use decimals 18
referrer
string
address of referrer who will get rebate from the deal
flags
number
flags of the trade is a 32 bit uint value which indicates: (from the highest bit)
close only: only close position during trading
market order: do not check limit price during trading
stop loss: only available in brokerTrade mode
take profit: only available in brokerTrade mode
Flags is a 32 bit uint value which indicates: (from highest bit)
      31               27 26                     7 6              0
     +---+---+---+---+---+------------------------+----------------+
     | C | M | S | T | R | Target leverage 20bits | Reserved 7bits |
     +---+---+---+---+---+------------------------+----------------+
       |   |   |   |   |   ` Target leverage  Fixed-point decimal with 2 decimal digits.
       |   |   |   |   |                      0 means don't automatically deposit / withdraw.
       |   |   |   |   `---  Reserved
       |   |   |   `-------  Take profit      Only available in brokerTrade mode.
       |   |   `-----------  Stop loss        Only available in brokerTrade mode.
       |   `---------------  Market order     Do not check limit price during trading.
       `-------------------  Close only       Only close position during trading.
    For stop loss and take profit, see `validateTriggerPrice` in OrderModule.sol for details.
Return information from queryTrade function
returns
type
description
tradePrice
number
average fill price
totalFee
number
total fee collected from the trader after the trade
cost
number
deposit or withdraw to let effective leverage == assign flag
> 0 if deposit
< 0 if withdraw
Notice
Query the prices, fees and cost when trade against amm.
The trading price is determined by the AMM based on the index price of the perpetual.
This method should return the same result as a 'read-only' trade.
Example
import { LiquidityPoolFactory } from '@mcdex/mai3.js'
const liquidityPool = LiquidityPoolFactory.connect(liquidityPoolAddress, provider)
let { tradePrice, totalFee, cost } = await liquidityPool.callStatic.queryTrade(0, signer.address, toWei("1"), NONE, 12800) // please check permission of sender
Execute Trade
Function
trade(perpetualIndex, traderAddress, amount, limitPrice, deadline, referrer, flags)
parameters
type
description
perpetualIndex
number
index of perpetual in the liquidity pool
traderAddress
string
address of trader
amount
number
amount of position to trader, positive for buying and negative for selling. The amount always use decimals 18
limitPrice
number
worst price the trader accepts
deadline
number
deadline of the trade (unix timestamp)
referrer
string
address of referrer who will get rebate from the deal
flags
number
flags of the trade is a 32 bit uint value which indicates: (from the highest bit)
close only: only close position during trading
market order: do not check limit price during trading
stop loss: only available in brokerTrade mode
take profit: only available in brokerTrade mode
Flags is a 32 bit uint value which indicates: (from highest bit)
      31               27 26                     7 6              0
     +---+---+---+---+---+------------------------+----------------+
     | C | M | S | T | R | Target leverage 20bits | Reserved 7bits |
     +---+---+---+---+---+------------------------+----------------+
       |   |   |   |   |   ` Target leverage  Fixed-point decimal with 2 decimal digits.
       |   |   |   |   |                      0 means don't automatically deposit / withdraw.
       |   |   |   |   `---  Reserved
       |   |   |   `-------  Take profit      Only available in brokerTrade mode.
       |   |   `-----------  Stop loss        Only available in brokerTrade mode.
       |   `---------------  Market order     Do not check limit price during trading.
       `-------------------  Close only       Only close position during trading.
    For stop loss and take profit, see `validateTriggerPrice` in OrderModule.sol for details.
Return information from trade function
returns
type
description
tradeAmount
number
amount of positions actually traded in the transaction. The amount always use decimals 18.
Notice
Trade with AMM in the perpetual, require sender is granted the trade privilege by the trader.
The trading price is determined by the AMM based on the index price of the perpetual.
A successful trade should:
The trade transaction not exceeds deadline;
Current liquidity of amm is enough to make the deal;
to open position:
Trader's margin balance must be greater then or equal to initial margin after trading;
Full trading fee will be charged if trader is opening position.
to close position:
Trader's margin balance must be greater then or equal to 0 after trading;
Trader need to pay the trading fee as much as possible before all the margin balance drained.
Example
Here we take position = 1/-1, limitPrice = 4500, no referrer, user target leverage for example.
// execute trade(): open position with 1 leverage
await ensureFinished(liquidityPool.connect(signer).trade(0, signer.address, toWei("1"), toWei("4500"), Math.floor(Date.now()/1000)+999999, NONE, 12800))
​
// execute trade(): close position with 1 leverage
await ensureFinished(liquidityPool.connect(signer).trade(0, signer.address, toWei("-1"), toWei("3000"), Math.floor(Date.now()/1000)+999999, NONE, 12800))
​
// execute trade(): open position with 2 leverage
await ensureFinished(liquidityPool.connect(signer).trade(0, signer.address, toWei("1"), toWei("4500"), Math.floor(Date.now()/1000)+999999, NONE, 25600))
​
// execute trade(): close position with 2 leverage
await ensureFinished(liquidityPool.connect(signer).trade(0, signer.address, toWei("-1"), toWei("3000"), Math.floor(Date.now()/1000)+999999, NONE, 25600))
​
// execute trade(): open position without automatically deposit. make sure your marginAccount is safe.
await ensureFinished(liquidityPool.connect(signer).trade(0, signer.address, toWei("1"), toWei("4500"), Math.floor(Date.now()/1000)+999999, NONE, 0))
​
// execute trade(): close position without automatically withdraw. make sure your marginAccount is safe.
await ensureFinished(liquidityPool.connect(signer).trade(0, signer.address, toWei("-1"), toWei("3000"), Math.floor(Date.now()/1000)+999999, NONE, 0))
​
// execute trade(): market price with 1 leverage
await ensureFinished(liquidityPool.connect(signer).trade(0, signer.address, toWei("1"), toWei("3000"), Math.floor(Date.now()/1000)+999999, NONE, 0x40000000+12800))
​
// execute trade(): close only. make sure you have position to close
await ensureFinished(liquidityPool.connect(signer).trade(0, signer.address, toWei("-1"), toWei("3000"), Math.floor(Date.now()/1000)+999999, NONE, 0x80000000+12800))
Sample Code
​Trade​
Re-Margin
Collateral
Last modified 9mo ago
Copy link
On this page
QueryTrade
Function
Example
Execute Trade
Function
Example
Sample Code