Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

submit_market_order

Place a market order with a slippage cap. Convenience wrapper over submit_order.

Market orders are IOC: the unfilled remainder is discarded, and the order reverts entirely if nothing fills. max_slippage is bounded at submission by the per-pair max_market_slippage; the worst acceptable execution price is oracle × (1 ± max_slippage) for bid/ask respectively. See protocol book: perps/2-order-matching §3, §3b.

Signature

def submit_market_order(
    self,
    pair_id: PairId,
    size: float | int | str | Decimal,
    *,
    max_slippage: float | str | Decimal = 0.01,
    reduce_only: bool = False,
    tp: ChildOrder | None = None,
    sl: ChildOrder | None = None,
) -> dict[str, Any]

Example

from dango.exchange import Exchange
from dango.utils.types import Addr, PairId
 
exchange = Exchange(wallet, base_url, account_address=Addr("0x..."))
 
# Buy 0.5 ETH with up to 1% slippage (default)
exchange.submit_market_order(PairId("perp/ethusd"), size="0.5")
 
# Sell 0.5 ETH with up to 0.5% slippage
exchange.submit_market_order(PairId("perp/ethusd"), size="-0.5", max_slippage="0.005")

Parameters

pair_id — PairId.

size — float | int | str | Decimal. Signed quantity (positive = buy, negative = sell). Zero is rejected.

max_slippage — float | str | Decimal, optional. Maximum acceptable slippage as a dimensionless ratio. 0.01 = 1%. Default: 0.01.

reduce_only — bool, optional. Default: False.

tp — ChildOrder | None, optional. Take-profit child order.

sl — ChildOrder | None, optional. Stop-loss child order.

Returns

dict[str, Any] — the BroadcastTxOutcome envelope.

Notes

  • max_slippage is a Dimensionless field — passes through dango_decimal. Precision capped at 6 places.
  • The market order does not carry a client_order_id.

See also