💱New Perp Market Listing

Intent of this page is to serve as a helpful guide to create proposals to list new perp markets or edit parameters of existing markets on mango V4.

Please refer to New Token Listing for fields which are common.

Fields, notes, and some examples

Field
notes
e.g.

group

-

settle_token_index

The index of the an existing listed token in which the PnL would be settled

Usually 0, i.e. USDC

group_insurance_fund

If insurance fund should back this market

true/false

name

Same as token, with additional -PERP as suffix

oracle

-

oracle_config

-

stable_price_model

-

quote_lot_size

0.1$ is the min tick

10

base_lot_size

If btc price is 20k, one base lot would be 2$

100

maint_base_asset_weight

-

init_base_asset_weight

-

maint_base_liab_weight

-

init_base_liab_weight

-

min_funding

-0.05

max_funding

0.05

impact_quantity

orders are walked down until impact quantity is accumulated to find bid/ask required to compute funding rate, If btc price is 20k, 100 would be equivalent to 100 base lots i.e. 200$

100

base_liquidation_fee

liquidation fee for liquidation base lots in a perp position

0.0125 i.e. 1.25%

maker_fee

-0.0001 i.e. 1bps discount

taker_fee

0.0004 i.e. 4bps

fee_penalty

IOC orders are currently always charged a penalty, regardless of been filled or not

5 i.e. 5 native USDC

settle_fee_flat

as settlement is permissionless, settlers are incentivised to receive fixed settlement fees to settle often

100 i.e. 100 native USDC

settle_fee_amount_threshold

distribute settlement fee only if settlement amount is above a threshold

100000000 i.e. 100M native USDCdc, i.e. 100 USDC

settle_fee_fraction_low_health

a percentage fee is paid to the settler when the source account's health is low. That's because the settlement could avoid it getting liquidated: settling will increase its health by actualizing positive perp PnL

0.01 i.e. 1 percent

settle_pnl_limit_factor

PnL settlement limit in comparison to base position value

1 i.e. 100%

settle_pnl_limit_window_size_ts

PnL settlement limit window, after which limit is reset

1 * 60 * 60 i.e. 1hr

maint_overall_asset_weight

weight for full perp market health, if positive

0.95

init_overall_asset_weight

"

0.95

positive_pnl_liquidation_fee

liquidation fee for liquidating positive PnL

0.025 i.e. 2.5%

Last updated