Get Open Trade By Gateway UUID

GetOpenTradeByGwUUID

Retrieves an open trade by its gateway UUID.

int GetOpenTradeByGwUUID(const std::string& gw_uuid, TradeRecord* trade);

---

Parameters

• gw_uuid — string representing the external gateway UUID 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 UUID.
• RET_* — other error codes.
• Return Codes

---

Example

TradeRecord tr;
if (GetOpenTradeByGwUUID("gw-uuid-123", &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.