Order Side & Time in Force

Order side

The side field is a boolean.

Value	Direction
false	Buy/Up
true	Sell/Down

Buy order:

await exchange.placeOrder({
  assetId,
  epoch,
  side: false,
  price: "99.9",
  size: "10.25",
});

Sell order:

await exchange.placeOrder({
  assetId,
  epoch,
  side: true,
  price: "99.9",
  size: "10.25",
});

Time in force

Time in force controls how an order behaves when it reaches the order book.

Value	Constant	Name	Behavior
0	TimeInForce.GTC	Good until cancelled	Any unfilled quantity remains open
1	TimeInForce.FOK	Fill or kill	The entire order must fill immediately or be cancelled
2	TimeInForce.IOC	Immediate or cancel	Available quantity fills immediately; the remainder is cancelled
3	TimeInForce.ALO	Add liquidity only	The order may only add liquidity

Import the constants from the SDK:

import {
  TimeInForce,
} from "@gammaswap/v2-exchange-sdk/constants";

Good until cancelled

GTC is the default.

await exchange.placeOrder({
  assetId,
  epoch,
  side: false,
  price: "99.9",
  size: "10.25",
  timeInForce: TimeInForce.GTC,
});

Since GTC is the default, it can be omitted:

await exchange.placeOrder({
  assetId,
  epoch,
  side: false,
  price: "99.9",
  size: "10.25",
});

Fill or kill

A FOK order must fill completely. If the full requested size is unavailable, the order is cancelled.

await exchange.placeOrder({
  assetId,
  epoch,
  side: false,
  price: "99.9",
  size: "10.25",
  timeInForce: TimeInForce.FOK,
});

Immediate or cancel

An IOC order fills as much as possible immediately and cancels any remaining quantity.

await exchange.placeOrder({
  assetId,
  epoch,
  side: false,
  price: "99.9",
  size: "10.25",
  timeInForce: TimeInForce.IOC,
});

Add liquidity only

An ALO order may only add liquidity to the order book.

await exchange.placeOrder({
  assetId,
  epoch,
  side: false,
  price: "99.9",
  size: "10.25",
  timeInForce: TimeInForce.ALO,
});

If the order would immediately match existing liquidity, it is rejected or cancelled with an ALO reason.

Cancel and replace

For a cancel-and-replace request:

• The replacement order must use the same market as the cancelled order.

• The replacement side must match the side of the cancelled order.

• The order hash being cancelled cannot be the zero hash.

• Cancel-all behavior is not supported by cancel-and-replace.

await exchange.cancelReplaceOrder({
  assetId,
  epoch,
  cancelOrderHash: existingOrderId,
  side: false,
  price: "99.8",
  size: "10.25",
  timeInForce: TimeInForce.GTC,
});