Single Condition Order

single_condition

Input Parameters

Parameter	Type	Description
account	Account	Trading account
start_date	string	Condition monitoring start time
end_date	string	Condition monitoring end time
stop_sign	StopSign	Stop condition: FULL = until fully filled, PARTIAL = until partially filled, UNTIL_END = until validity ends
condition	Condition	Trigger condition
ConditionOrder Object	ConditionOrder Object	Order request payload

Result

Parameter	Type	Description
is_success	bool	Whether the request succeeded
data	Object	Returned information for the condition order
message	string ? (optional)	Error message when isSuccess = false

ConditionOrderResult Fields (Order Info)

Return type: Object

Parameter	Type	Description
guid	string	Condition order ID

Request Example

// Define the condition
Condition condition = Condition{
    TradingType::REFERENCE,
    "2881",
    TriggerContent::MATCHED_PRICE,
    "66",
    Operator::LESS_THAN,
};

ConditionOrder order = ConditionOrder{
    BsAction::BUY,
    "2881",
    "1000",
    1000,
    ConditionMarketType::COMMON,
    ConditionPriceType::LIMIT,
    TimeInForce::ROD,
    ConditionOrderType::STOCK,
};


auto send_condition_order = sdk->stock->single_condition(target_account,"20250605","20250605", StopSign::FULL, condition, order, std::nullopt);

if (!send_condition_order.is_success) {
    std::cout << "get order result failed reason: "
        << (send_condition_order.message.has_value() ? send_condition_order.message.value() : "No message")
        << std::endl;
}
else {
    if (send_condition_order.data.has_value()) {
        const auto& send = send_condition_order.data.value();
        std::cout << send << std::endl;
    }
    else {
        std::cout << "Order result success but no data returned." << std::endl;
    }
}

Response Example

{
    isSuccess = True,
    message = ,
    data = ConditionOrderResult {
            guid = 44150047-8977-40b1-953c-ce2XXXXXX
        }
}