GetTransactionsByGroup¶

Retrieves a list of financial transactions (deposits, withdrawals, credits, corrections) for accounts belonging to a specific group within a specified time interval.

int GetTransactionsByGroup(const std::string& FilterGroup, time_t from, time_t to, std::vector<TradeRecord>* trades);

Parameters¶

FilterGroup — string representing the group name used to filter financial transactions.
from — starting timestamp (time_t) of the requested time interval.
to — ending timestamp (time_t) of the requested time interval.
trades — pointer to a std::vector<TradeRecord> that will receive the resulting list of transactions.

Return Value¶

RET_OK — transactions retrieved successfully.
RET_NOT_FOUND — no transactions match the specified criteria.
RET_* — other error codes in case of execution failures.
See Return Codes

Example¶

std::vector<TradeRecord> transactions;
time_t from = 1711920000; // start timestamp
time_t to   = 1712006400; // end timestamp

if (GetTransactionsByGroup("investors", from, to, &transactions) == RET_OK) {
    // Process financial transactions
}

Warning

The trades pointer must reference a valid vector before invoking the method.
If no transactions match the filter, the function returns RET_NOT_FOUND and leaves the vector unchanged.
Always validate the return code before accessing transaction data.
Returned items include only financial operations (Balance in/out, Credit in/out, Fix operations).

Information¶

The GetTransactionsByGroup method belongs to the ScaleTrade Plugin API, optimized for retrieving financial transaction history filtered by user groups and time intervals.

Target keywords:
- ScaleTrade financial transactions API
- group-based account operations
- trading platform plugin API
- finance history filter
- C++ trading system development
- TradeRecord financial operations

Best suited for:
- Reporting and analytics plugins
- Financial monitoring modules
- Compliance and auditing tools
- Custom BI and transaction tracing systems