Struct CreateOrderRequest

pub struct CreateOrderRequest {

    pub epic: String,
    pub direction: Direction,
    pub size: f64,
    pub order_type: OrderType,
    pub time_in_force: TimeInForce,
    pub level: Option<f64>,
    pub guaranteed_stop: Option<bool>,
    pub stop_level: Option<f64>,
    pub stop_distance: Option<f64>,
    pub limit_level: Option<f64>,
    pub limit_distance: Option<f64>,
    pub expiry: Option<String>,
    pub deal_reference: Option<String>,
    pub force_open: Option<bool>,
    pub currency_code: Option<String>,
}

Model for creating a new order

Fields

epic: String

Instrument EPIC identifier

direction: Direction

Order direction (buy or sell)

size: f64

Order size/quantity

order_type: OrderType

Type of order (market, limit, etc.)

time_in_force: TimeInForce

Order duration (how long the order remains valid)

level: Option<f64>

Price level for limit orders

guaranteed_stop: Option<bool>

Whether to use a guaranteed stop

stop_level: Option<f64>

Price level for stop loss

stop_distance: Option<f64>

Distance for stop loss

limit_level: Option<f64>

Price level for take profit

limit_distance: Option<f64>

Distance for take profit

expiry: Option<String>

Expiry date for the order

deal_reference: Option<String>

Client-generated reference for the deal

force_open: Option<bool>

Whether to force open a new position

currency_code: Option<String>

Currency code for the order (e.g., “USD”, “EUR”)

Implementations

impl CreateOrderRequest

pub fn market(epic: String, direction: Direction, size: f64) -> Self

Creates a new market order

pub fn limit(epic: String, direction: Direction, size: f64, level: f64) -> Self

Creates a new limit order

pub fn sell_option_to_market( epic: String, size: f64, expiry: Option<String>, deal_reference: Option<String>, currency_code: Option<String>, ) -> Self

Creates a new instance of a market sell option with predefined parameters.

This function sets up a sell option to the market for a given asset (epic) with the specified size. It configures the order with default values for attributes such as direction, order type, and time-in-force.

Parameters

• epic: A String that represents the epic (unique identifier or code) of the instrument being traded.
• size: A f64 value representing the size or quantity of the order.

Returns

An instance of Self (the type implementing this function), containing the specified epic and size, along with default values for other parameters:

• direction: Set to Direction::Sell.
• order_type: Set to OrderType::Limit.
• time_in_force: Set to TimeInForce::FillOrKill.
• level: Set to Some(0.1).
• guaranteed_stop: Set to None.
• stop_level: Set to None.
• stop_distance: Set to None.
• limit_level: Set to None.
• limit_distance: Set to None.
• expiry: Set to None.
• deal_reference: Set to None.
• force_open: Set to Some(true).
• currency_code: Set to None.

Note that this function allows for minimal input (the instrument and size), while other fields are provided default values. If further customization is required, you can modify the returned instance as needed.

pub fn buy_option_to_market( epic: String, size: f64, expiry: Option<String>, deal_reference: Option<String>, currency_code: Option<String>, ) -> Self

Creates a new instance of an order to buy an option in the market with specified parameters.

This method initializes an order with the following default values:

• direction is set to Buy.
• order_type is set to Limit.
• time_in_force is set to FillOrKill.
• level is set to Some(10000.0).
• force_open is set to Some(true). Other optional parameters, such as stop levels, distances, expiry, and currency code, are left as None.

Parameters

• epic (String): The identifier for the market or instrument to trade.
• size (f64): The size or quantity of the order to be executed.

Returns

A new instance of Self that represents the configured buy option for the given market.

Note

Ensure the epic and size values provided are valid and match required market conditions.

pub fn with_stop_loss(self, stop_level: f64) -> Self

Adds a stop loss to the order

pub fn with_take_profit(self, limit_level: f64) -> Self

Adds a take profit to the order

pub fn with_reference(self, reference: String) -> Self

Adds a reference to the order

Trait Implementations

impl Clone for CreateOrderRequest

fn clone(&self) -> CreateOrderRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CreateOrderRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for CreateOrderRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.