Place Bulk Order

The Bulk Order API allows a client to submit and manage multiple limit orders (both bids and asks) in a single atomic transaction. Eac account can have at most one Bulk Order per market. This API cancels all existing resting liquidity for the market provided and replaces it with the new bulk set of orders (bids and asks). Partial failures (e.g., an order that cannot be posted due to a PostOnly violation) do not revert the transaction — that particular order will simply be skipped or partially placed. Cancelled price levels and sizes will be returned explicitly in the update event. ** NOTE **

Bulk Order Placements with a non-increasing sequence_number will be rejected.
Order updates that reduce size will maintain its position in the matching queue, order updates that increase size will be moved to the end of the matching queue.

Function:

{package}::dex_accounts_entry::place_bulk_orders_to_subaccount

ABI Object:

const functionAbi: MoveFunction = {
  name: "place_bulk_orders_to_subaccount",
  visibility: "private",
  is_entry: true,
  is_view: false,
  generic_type_params: [],
  params: [
    "&signer",
    "0x1::object::Object<{package}::dex_accounts::Subaccount>",
    "0x1::object::Object<{package}::perp_market::PerpMarket>",
    "u64",
    "vector<u64>",
    "vector<u64>",
    "vector<u64>",
    "vector<u64>",
    "0x1::option::Option<address>",
    "0x1::option::Option<u64>",
  ],
  return: [],
};

Parameters:

signer - The account signer
subaccount - The Trading Account object
market - The PerpMarket object
sequence_number - The monotonically increasing number associated with this order
bid_prices - `vector<u64>` - Array of bid prices in chain units
bid_sizes - `vector<u64>` - Array of bid sizes in chain units
ask_prices - `vector<u64>` - Array of ask prices in chain units
ask_sizes - `vector<u64>` - Array of ask sizes in chain units
builder_address - Optional builder address `<Option<address>>`
builder_fees - Optional builder fee `<Option<u64>>`, in units of 0.0001% (basis points × 100; e.g. 1000 = 10 bps = 0.1%, the protocol maximum). The TypeScript SDK takes basis points and does this conversion for you

Time in Force

Bulk Orders are Post-Only limit orders.

Constraints

The transaction aborts unless all of the following hold:

At most 40 price levels per side
bid_prices strictly descending (best bid first) and ask_prices strictly ascending (best ask first)
The best bid is below the best ask; no zero sizes; at least one side non-empty
sequence_number is greater than zero and greater than the previous bulk order’s for this market; a non-increasing sequence number is rejected without aborting the transaction — a rejection event is emitted and the previous ladder stays in place, so check the event rather than the transaction status

Example:

const transaction = await aptos.transaction.build.simple({
  sender: account.accountAddress,
  data: {
    function: `${PACKAGE}::dex_accounts_entry::place_bulk_orders_to_subaccount`,
    typeArguments: [],
    functionArguments: [
      "0x123...abc", // subaccountAddr
      "0x456...def", // marketAddr (PerpMarket object address)
      1, // sequenceNumber (must be monotonically increasing)
      [5690000000, 5680000000, 5670000000], // bidPrices (in chain units), best bid first, strictly descending
      [1000000000, 2000000000, 3000000000], // bidSizes (in chain units)
      [5710000000, 5720000000, 5730000000], // askPrices (in chain units)
      [1000000000, 2000000000, 3000000000], // askSizes (in chain units)
      null, // builderAddress (optional)
      null, // builderFees (optional)
    ],
  },
});

transaction = rest_client.build_transaction(
    sender=account.address(),
    payload={
        "function": f"{PACKAGE}::dex_accounts_entry::place_bulk_orders_to_subaccount",
        "type_arguments": [],
        "function_arguments": [
            "0x123...abc",  # subaccountAddr
            "0x456...def",  # marketAddr (PerpMarket object address)
            1,  # sequenceNumber (must be monotonically increasing)
            [5690000000, 5680000000, 5670000000],  # bidPrices (in chain units), best bid first, strictly descending
            [1000000000, 2000000000, 3000000000],  # bidSizes (in chain units)
            [5710000000, 5720000000, 5730000000],  # askPrices (in chain units)
            [1000000000, 2000000000, 3000000000],  # askSizes (in chain units)
            None,  # builderAddress (optional)
            None,  # builderFees (optional)
        ],
    },
)

Quick Start

Guides

TypeScript SDK

CLI

On-Chain: Reference

On-Chain: Account Management

On-Chain: Order Management

On-Chain: Position Management

On-Chain: Builder Fee

On-Chain: Vault Transactions

Place Bulk Order

Time in Force

Constraints

​Time in Force

​Constraints

Time in Force

Constraints