Get Close Trade By Gateway Order

GetCloseTradeByGwOrder

Retrieves a closed trade by its gateway order ID.

int GetCloseTradeByGwOrder(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 closed trade found with the specified gateway order ID.
• RET_* — other error codes.
• Return Codes

---

Example

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

---

Warning

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