Get Open Trade By Gateway Order

GetOpenTradeByGwOrder

Retrieves an open trade by its gateway order ID.

int GetOpenTradeByGwOrder(int gw_order, TradeRecord* trade);

---

Parameters

• gw_order — integer representing the external gateway order ID of the trade.
• trade — pointer to a TradeRecord structure where the retrieved trade details will be stored.

---

Return Value

• RET_OK — trade found and successfully retrieved.
• RET_NOT_FOUND — no open trade found with the specified gateway order ID.
• RET_* — other error codes.
• Return Codes

---

Example

TradeRecord tr;
if (GetOpenTradeByGwOrder(987654, &tr) == RET_OK) {
    // Process trade data
}

---

Warning

• The trade pointer must point to a valid, pre-allocated TradeRecord structure.
• If no open trade is found, the function returns RET_NOT_FOUND and leaves trade unchanged.
• Always check the return code before using the trade data.