Trading Return Report
This is a report page that allow you to see the Investment Return of your trading account, OR any account that you can follow (MAM / Signaling Service).The url of this page is: DOMAIN/Return_Report. If you wish to customize this report to your needs, call the API DOMAIN/Return_Report_json url.
Statistics Fields
- A trade result will be counted as a WIN only if the TOTAL P/L of the trade is higher then 0.003 US Dollars.
- A trade result will be counted as a LOSS only if the TOTAL P/L of the trade is lower then -0.003 US Dollars.
- Any other result, in the range between -0.003 USD up-to 0.003, will be counted as BREAK EVEN !
| Field Name | Description |
|---|---|
| Account Number | Trading Account Number. If this a public account, it may contain some X chars to hide the whole number. |
| Explorer Name Explorer Time Zone |
Account Name / Title. The time fields in this report are by the account Time Zone. |
| Live/Demo | Is it hosted on a Demo server ? (virtual money) |
| Account Opened Account Age |
The Day of the first deposit and the account age in weeks - since that deposit. |
| Base Currency | That is the base currency of this account. All P/L and Monetary fields are in this currency, unless written otherwise on a specific field. |
| Broker Platform Lot Size Max Leverage |
Broker company who host this account and it's technical data. |
| Last Update UTC | Last time Hyper calculated information about this account. You can refresh this Statistics every hour. |
| Balance | Last sampled account Balance and Credit line summed together. |
| Equity | Last sampled account Equity (Balance + Floating P/L). |
| Unrealized | All open positions Floating P/L in USD. |
| Net Swap | All paid Swaps in this account (open and closed trades), in USD. |
| Commission | All paid Fees in this account (open and closed trades), in USD. |
| Profit Factor | The formula is "Gross Gain" / ABS("Gross Loss"). |
| Gross Gain | All winning trades Total P/L, including fees and swaps, in USD. |
| Gross Loss | All losing trades Total P/L, including fees and swaps, in USD. |
| Pips Gain | All winning trades Price Difference (between Open and Close Price) according to Command (Buy / Sell), in Contract currency. |
| Pips Loss | All losing trades Price Difference (between Open and Close Price) according to Command (Buy / Sell), in Contract currency. A trade may lose in the total because of Fees and Swaps, but still have a Positive Pips value (a profit on trade NET). |
| Closed Trades | How many trades (tickets) has been closed (done). |
| Open Trades | How many trades (tickets) are still open now. |
| Long Trades | How many trades were indicated as BUY, expecting the price to go UP. |
| Short Trades | How many trades were indicated as SELL, expecting the price to go DOWN. |
| Winning Trades | How many winning trades by the Total P/L, including fees and swaps. |
| Losing Trades | How many losing trades by the Total P/L, including fees and swaps. |
| Even Trades | How many trades were Break Even by the Total P/L, including fees and swaps. |
| Win Rate | The percentage of Winning trades out of the total amount of trades (open + closed). |
| Max Consec Wins | The longest string of consecutive trades without a loss. Trades are sorted by their Open Time. |
| Max Consec Losses | The longest string of consecutive trades without a win. Trades are sorted by their Open Time. |
| Best Trade Profit | The highest Total P/L for a single trade (ticket), including fees and swaps. |
| Worst Trade Profit | The lowest Total P/L for a single trade (ticket), including fees and swaps. |
| Avg Trade Profit | The formula is ("Gross Gain" + "Gross Loss") / Trades Count. The average P/L for a single trade ticket. |
| Avg Trade Pips | The formula is ("Pips Gain" + "Pips Loss") / Trades Count. The average Pips P/L for a single trade ticket. |
| Avg Trade Lots | The formula is "Lots Traded" / Trades Count. The average Volume (in lots) for a single trade ticket. |
| Avg Trade Duration | This is the average time a trade can |
| Avg Winning Trade | The formula is "Gross Gain" / "Winning Trades". |
| Avg Losing Trade | The formula is "Gross Loss" / "Losing Trades". |
| Lots Traded | Trading volume in Contracts. Every trade is being counted once (on open time). 1 Lot of currency pair = 100000 (e.g. 1 Lot of EUR/USD = 100,000 EUR). Please refer to the symbols definition to get the contract sizes for each type (Commodity, stocks, index etc). |
| Total Deposits | Total Deposits of client funds. Fees and interest are filtered out. |
| Total Withdrawals | Total of client refunds. Fees and interest are filtered out. |
| TWR | Time-Weighted Rate of Return in percentage, is a measure of the compound rate of growth in a portfolio. Because this method eliminates the distorting effects created by inflows of new money, it is used to compare the returns of investment managers. In this field Hyper is calculating the T.W.R on a DAILY basis ! (5 days a week). |
| Growth | This is the Account Floating Profit, divided by Net Transfers. This is like T.W.R. as Gross calculation between cash flow events |
| Max Risk | The worst Daily Return ever, in Percentage. |
| Monthly Return | T.W.R. simply divided to months. |
Last 6 Months Daily Data
| Field Name | Description |
|---|---|
| For Date | Trading Days (Mon - Sat). Monday is the beginning of the week. Saturday is the result of Friday. |
| Return | Daily account P/L in Percentage of previous day Equity ! |
| Return Money | Daily account P/L in Base Currency. |
| Net Transfers | Deposits - Withdrawals during the day. IF the amount is positive, then the client made a deposit that day. Monetary transactions from SAT & SUN are assigned to Monday. |
| Equity | Account Equity in Base Currency, for the Beginning of the day ! |
API Function Input
| Field Name | Description |
|---|---|
| For_TP_Login | This field should contain the connected client own account OR any public account for following (MAM / Signaling Service). |
API Possible Error Messages
| Code | Content |
|---|---|
| 3 | API function does not exists. |
| 4 | Database Error on server side. |
| 5 | Technical Error on server side. |
| 6 | Technical Error: Client Session not found. |
| 7 | Please fill up all the required fields. |
| 8 | You are NOT Authorized to access this Data / Functionality. |
API Report Output
{
"DailyReport": {
"Title": "DailyReport",
"RowCount": "150",
"Data": [
{
"ForDate": "2017-08-26", // this is SAT
"Return": "-3.80",
"ReturnMoney": "-10281.38",
"NetTransfers": "0.00",
"Equity": "260139.94",
},
{
"ForDate": "2017-08-28",
"Return": "0.00",
"ReturnMoney": "0.00",
"NetTransfers": "0.00",
"Equity": "260139.94",
},
{
"ForDate": "2017-08-29",
"Return": "-16.09",
"ReturnMoney": "-41860.75",
"NetTransfers": "0.00",
"Equity": "218279.19",
},
{
"ForDate": "2017-08-30",
"Return": "6.10",
"ReturnMoney": "13304.89",
"NetTransfers": "0.00",
"Equity": "231584.08",
},
{
"ForDate": "2017-08-31",
"Return": "6.82",
"ReturnMoney": "15800.84",
"NetTransfers": "0.00",
"Equity": "247384.92",
},
{
"ForDate": "2017-09-01",
"Return": "-20.92",
"ReturnMoney": "-51761.77",
"NetTransfers": "0.00",
"Equity": "195623.15",
},
{
"ForDate": "2017-09-02", // this is SAT
"Return": "0.91",
"ReturnMoney": "1783.70",
"NetTransfers": "0.00",
"Equity": "197406.85",
}
]
},
"Statistics": {
"Title": "Statistics",
"RowCount": "1",
"Data": [
{
"HyperFileNumber": "500015",
"AccountNumber": "20XXXXXX03",
"ExplorerName": "Solid Trust Robot",
"ExplorerTimeZone": "UK-London (GMT+1)",
"Broker": "SYE Software Ltd",
"Platform": "Meta Trader 4",
"LiveDemo": "Live",
"AccountOpened": "2016-06-15",
"AccountAge": "64 weeks",
"BaseCurrency": "USD",
"LotSize": "Standard (100K)",
"MaxLeverage": "100:1",
"LastUpdateUTC": "2017-09-03 10:44:05",
"Growth": "558.02",
"MaxRisk": "-24.57",
"MonthlyReturn": "18.93",
"Balance": "279733.89",
"Equity": "197406.85",
"Unrealized": "-82327.04",
"NetSwap": "-7504.17",
"Commission": "-13282.04",
"ProfitFactor": "1.43",
"GrossGain": "555844.93",
"GrossLoss": "-388438.08",
"PipsGain": "3047.72",
"PipsLoss": "-2067.25",
"ClosedTrades": "605",
"OpenTrades": "7",
"LongTrades": "323",
"ShortTrades": "289",
"AvgTradeProfit": "273.54",
"AvgTradePips": "1.60",
"AvgTradeLots": "4.55",
"AvgTradeDuration": "2.2 days",
"AvgWinningTrade": "1510.45",
"AvgLosingTrade": "-1591.96",
"WinningTrades": "368",
"LosingTrades": "244",
"EvenTrades": "0",
"MaxConsecWins": "14",
"MaxConsecLosses": "12",
"WinRate": "60.13",
"BestTradeProfit": "34923.89",
"WorstTradeProfit": "-39280.60",
"LotsTraded": "2785.40",
"TotalDeposits": "30000.00",
"TotalWithdrawals": "0.00",
"TWR": "237.26"
}
]
}
}
"DailyReport": {
"Title": "DailyReport",
"RowCount": "150",
"Data": [
{
"ForDate": "2017-08-26", // this is SAT
"Return": "-3.80",
"ReturnMoney": "-10281.38",
"NetTransfers": "0.00",
"Equity": "260139.94",
},
{
"ForDate": "2017-08-28",
"Return": "0.00",
"ReturnMoney": "0.00",
"NetTransfers": "0.00",
"Equity": "260139.94",
},
{
"ForDate": "2017-08-29",
"Return": "-16.09",
"ReturnMoney": "-41860.75",
"NetTransfers": "0.00",
"Equity": "218279.19",
},
{
"ForDate": "2017-08-30",
"Return": "6.10",
"ReturnMoney": "13304.89",
"NetTransfers": "0.00",
"Equity": "231584.08",
},
{
"ForDate": "2017-08-31",
"Return": "6.82",
"ReturnMoney": "15800.84",
"NetTransfers": "0.00",
"Equity": "247384.92",
},
{
"ForDate": "2017-09-01",
"Return": "-20.92",
"ReturnMoney": "-51761.77",
"NetTransfers": "0.00",
"Equity": "195623.15",
},
{
"ForDate": "2017-09-02", // this is SAT
"Return": "0.91",
"ReturnMoney": "1783.70",
"NetTransfers": "0.00",
"Equity": "197406.85",
}
]
},
"Statistics": {
"Title": "Statistics",
"RowCount": "1",
"Data": [
{
"HyperFileNumber": "500015",
"AccountNumber": "20XXXXXX03",
"ExplorerName": "Solid Trust Robot",
"ExplorerTimeZone": "UK-London (GMT+1)",
"Broker": "SYE Software Ltd",
"Platform": "Meta Trader 4",
"LiveDemo": "Live",
"AccountOpened": "2016-06-15",
"AccountAge": "64 weeks",
"BaseCurrency": "USD",
"LotSize": "Standard (100K)",
"MaxLeverage": "100:1",
"LastUpdateUTC": "2017-09-03 10:44:05",
"Growth": "558.02",
"MaxRisk": "-24.57",
"MonthlyReturn": "18.93",
"Balance": "279733.89",
"Equity": "197406.85",
"Unrealized": "-82327.04",
"NetSwap": "-7504.17",
"Commission": "-13282.04",
"ProfitFactor": "1.43",
"GrossGain": "555844.93",
"GrossLoss": "-388438.08",
"PipsGain": "3047.72",
"PipsLoss": "-2067.25",
"ClosedTrades": "605",
"OpenTrades": "7",
"LongTrades": "323",
"ShortTrades": "289",
"AvgTradeProfit": "273.54",
"AvgTradePips": "1.60",
"AvgTradeLots": "4.55",
"AvgTradeDuration": "2.2 days",
"AvgWinningTrade": "1510.45",
"AvgLosingTrade": "-1591.96",
"WinningTrades": "368",
"LosingTrades": "244",
"EvenTrades": "0",
"MaxConsecWins": "14",
"MaxConsecLosses": "12",
"WinRate": "60.13",
"BestTradeProfit": "34923.89",
"WorstTradeProfit": "-39280.60",
"LotsTraded": "2785.40",
"TotalDeposits": "30000.00",
"TotalWithdrawals": "0.00",
"TWR": "237.26"
}
]
}
}