> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decibel.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Place Order

> Place a limit order on the exchange

**Function:**

```
{package}::dex_accounts_entry::place_order_to_subaccount
```

**ABI Object:**

```typescript theme={null}
const functionAbi: MoveFunction = {
  name: "place_order_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",
    "u64",
    "bool",
    "u8",
    "bool",
    "0x1::option::Option<0x1::string::String>",
    "0x1::option::Option<u64>",
    "0x1::option::Option<u64>",
    "0x1::option::Option<u64>",
    "0x1::option::Option<u64>",
    "0x1::option::Option<u64>",
    "0x1::option::Option<address>",
    "0x1::option::Option<u64>",
  ],
  return: [],
};
```

**Parameters:**

* `signer` - The account signer
* `subaccount` - The Trading Account object
* `market` - The PerpMarket object
* `price` - Order price `` `<u64>` ``
* `size` - Order size `` `<u64>` ``
* `is_buy` - True for buy order, false for sell order
* `time_in_force` - Time in force `` `<u8>` ``: 0 = GoodTillCanceled, 1 = PostOnly, 2 = ImmediateOrCancel
* `is_reduce_only` - Whether order can only reduce position size
* `client_order_id` - Optional client-assigned order ID `` `<Option<String>>` ``
* `stop_price` - Optional stop price `` `<Option<u64>>` ``
* `tp_trigger_price` - Optional take-profit trigger price `` `<Option<u64>>` ``
* `tp_limit_price` - Optional take-profit limit price `` `<Option<u64>>` ``
* `sl_trigger_price` - Optional stop-loss trigger price `` `<Option<u64>>` ``
* `sl_limit_price` - Optional stop-loss limit price `` `<Option<u64>>` ``
* `builder_address` - Optional builder/referrer address `` `<Option<address>>` ``
* `builder_fees` - Optional builder fee in basis points `` `<Option<u64>>` ``

## Time in Force Options

When placing orders, you can specify different execution types using the `time_in_force` parameter:

* **`0` (GoodTillCanceled)** - Order stays active until it is filled or manually canceled
* **`1` (PostOnly)** - Order only adds liquidity to the order book (becomes a maker order). If the order would execute immediately, it is canceled
* **`2` (ImmediateOrCancel)** - Order executes immediately at the best available price. Any unfilled portion is canceled

**Example:**

<CodeGroup>
  ```typescript Typescript theme={null}
  const transaction = await aptos.transaction.build.simple({
    sender: account.accountAddress,
    data: {
      function: `${PACKAGE}::dex_accounts_entry::place_order_to_subaccount`,
      typeArguments: [],
      functionArguments: [
        "0x123...abc", // subaccountAddr
        "0x456...def", // marketAddr (PerpMarket object address)
        5670000000, // price (5.67 with 9 decimals)
        1000000000, // size (1.0 with 9 decimals)
        true, // isBuy (true for buy, false for sell)
        0, // timeInForce (0 = GoodTillCanceled, 1 = PostOnly, 2 = ImmediateOrCancel)
        false, // isReduceOnly
        "my-order-123", // clientOrderId (optional)
        null, // stopPrice (optional)
        null, // tpTriggerPrice (optional)
        null, // tpLimitPrice (optional)
        null, // slTriggerPrice (optional)
        null, // slLimitPrice (optional)
        null, // builderAddress (optional)
        null, // builderFees (optional)
      ],
    },
  });
  ```

  ```python Python theme={null}
  transaction = rest_client.build_transaction(
      sender=account.address(),
      payload={
          "function": f"{PACKAGE}::dex_accounts_entry::place_order_to_subaccount",
          "type_arguments": [],
          "function_arguments": [
              "0x123...abc",  # subaccountAddr
              "0x456...def",  # marketAddr (PerpMarket object address)
              5670000000,  # price (5.67 with 9 decimals)
              1000000000,  # size (1.0 with 9 decimals)
              True,  # isBuy (true for buy, false for sell)
              0,  # timeInForce (0 = GoodTillCanceled, 1 = PostOnly, 2 = ImmediateOrCancel)
              False,  # isReduceOnly
              "my-order-123",  # clientOrderId (optional)
              None,  # stopPrice (optional)
              None,  # tpTriggerPrice (optional)
              None,  # tpLimitPrice (optional)
              None,  # slTriggerPrice (optional)
              None,  # slLimitPrice (optional)
              None,  # builderAddress (optional)
              None,  # builderFees (optional)
          ],
      },
  )
  ```
</CodeGroup>