CcF Reporter
- 实用工具
- 版本: 1.0
- 激活: 10
Stop Guessing, Start Tracking: Why You Need CcF Reporter
In the fast-paced world of algorithmic and manual trading, your edge relies on clear data, not emotions. However, evaluating your true performance inside the standard MetaTrader 5 history tab can be frustrating. Deposits, withdrawals, and broker bonuses often clutter your history, making it difficult to see your actual trading Profit and Loss (PnL) at a glance. Furthermore, if you are running multiple Expert Advisors or combining automated systems with manual trades, tracking which specific strategy is actually making money becomes a time-consuming chore.
Enter CcF Reporter.
Think of this utility EA as your automated personal accountant. It runs silently in the background, filtering out all the non-trading noise to calculate your pure, exact trading PnL. Instead of forcing you to log into your VPS or open your terminal to check your progress, CcF Reporter delivers comprehensive, easy-to-read performance breakdowns directly to your phone via Telegram or Discord.
With CcF Reporter, you instantly know:
-
Your True PnL: Stripped of deposits, withdrawals, and confusing credit bonuses.
-
What’s Working: A clear ranking of your Top 3 winning and losing symbols.
-
Who’s Performing: A detailed breakdown of profits and trade counts sorted by Strategy, Magic Number, or Order Comment, so you know exactly which bot to scale up and which to turn off.
Whether you want a daily recap over your morning coffee, a weekly summary to review your portfolio, or scheduled updates throughout the day, CcF Reporter gives you the exact metrics you need, exactly when you need them.
Automate your tracking. Optimize your strategies. Keep disciplined.
Overview
CcF Reporter is an automated MetaTrader 5 reporting utility Expert Advisor (EA). It monitors your trading history and sends detailed performance summaries—including PnL, top traded symbols, and strategy breakdowns—directly to your Telegram or Discord.
Core Logic & Features
-
Clean PnL Calculation: The EA exclusively calculates trading performance. It automatically filters out deposits, withdrawals, credits, and bonuses so your trading PnL remains accurate.
-
Strategy Categorization: It groups trades based on either Magic Number or Order Comment . You can manually group multiple magic numbers/comments into a single "Strategy Name", or let the EA auto-detect them.
-
Smart Triggers: Reports can be sent manually via chart buttons, automatically at the end of the day/week/month, or at specific scheduled server times.
-
Anti-Spam & Auto-Split: If a report exceeds Telegram's or Discord's character limits, the EA will automatically split the message into smaller chunks and send them with a 1-second delay to prevent API blocking.
Input Parameters Explained
1. General Settings
-
Send Report To: Choose your preferred messaging app ( PLATFORM_TELEGRAM or PLATFORM_DISCORD ).
-
Analysis Mode: Defines how the EA identifies different strategies.
-
Magic Number : Exact match based on EA Magic Numbers.
-
Order Comment : Partial match based on trade comments (e.g., if the comment contains the mapped text).
-
-
Auto-Detect Strategies: If true , any trade that does not match your manual "Strategy Mapping" will be automatically grouped and reported based on its raw Magic Number or Comment.
2. Telegram Settings (Requires Send Report To = Telegram)
-
Telegram Bot Token: Your Telegram Bot API token (obtained from BotFather).
-
Telegram Chat ID: The destination Chat ID (can be a personal chat, group chat, or channel). Include the - prefix if it is a group/channel.
3. Discord Settings (Requires Send Report To = Discord)
-
Discord Webhook URL: The Webhook URL generated from your Discord channel settings (Integrations > Webhooks).
4. Specific Time Notification
-
Enable Specific Hour Report: If true , the EA will send regular updates at the exact times specified below.
-
Specific Hours: A comma-separated list of times you want to receive reports. Note: This uses Broker Server Time, not your local PC time. Format: HH:MM (e.g., 06:00, 12:05, 18:00 ).
5. Strategy Mapping
Used to group multiple Magic Numbers or Comments under one clean, readable name in the report.
-
Strategy Mapping 1 to 5: Format must be CustomName1=Value1,Value2;CustomName2=Value3;CustomName3=Value4,Value5
-
Magic Number Example: GridBot=1001,1002,1003;BreakoutBot=201,202;Scalp=400
-
Comment Example: Scalper=EA_V1,EA_V2;BreakoutBot=EA Breakout;Scalp=Scalp
-
6. Report Settings
-
Custom Header Title: Custom title printed at the very top of the report message.
-
Extra Comment at Bottom: A custom footer note printed at the bottom of the report.
-
Send Report on Weekend ?: If false , the EA will not send Daily or Scheduled reports on Saturdays and Sundays.
-
Show Symbol Analysis (Top3): If true , the report will include the Top 3 Gainers and Top 3 Losers by traded symbol.
-
Show Strategy Overview: If true , the report will include the PnL breakdown per strategy (Mapped & Auto-detected).
On-Chart UI Controls
Once attached to a chart, the EA provides four clickable buttons on the top-left corner for manual, instant reporting:
-
Send Daily: Generates a report from 00:00 server time today until the current moment.
-
Send Weekly: Generates a report from Monday 00:00 of the current week until the current moment.
-
Send Monthly: Generates a report from the 1st day of the current month until the current moment.
-
Send All History: Generates a comprehensive report of the entire account history from the very first trade.
Setup Instructions
-
Allow WebRequests in MT5: Go to Tools > Options > Expert Advisors.
-
Check the box "Allow WebRequest for listed URL".
-
Add these URLs to the list depending on your platform:
-
Telegram: https://api.telegram.org
-
Discord: https://discord.com
-
-
Attach the EA to any chart on any timeframe, configure the inputs, and ensure "Algo Trading" is enabled.
To use the CcF Reporter EA, you need to connect it to your preferred messaging platform. Follow the instructions below to generate the necessary API credentials.
Setting Up Telegram Notifications
To send reports to Telegram, you need two things: a Bot API Token (to authorize the bot) and a Chat ID (to tell the bot where to send the message).
Step 1: Create a Bot & Get Your API Token
-
Open your Telegram app and search for @BotFather (ensure it has the official blue verified checkmark).
-
Click Start or send the command /newbot .
-
Follow BotFather's prompts:
-
Name: Enter a display name for your bot (e.g., CcF MT5 Reporter).
-
Username: Enter a unique username that ends in "bot" (e.g., ccf_report_123_bot).
-
-
Once successfully created, BotFather will reply with a congratulatory message containing your HTTP API Token (it looks like a long string of characters, e.g., 1234567890:ABCDefGhIjKlMnOpQrStUvWxYz ).
-
Copy and save this Token. You will paste this into the InpBotToken input in the EA settings.
Step 2: Find Your Chat ID
The bot needs to know exactly which chat room to send the reports to. The method depends on whether you want reports sent to a direct message or a group/channel.
Option A: For Personal Direct Messages (You alone)
-
Search for @userinfobot or @RawDataBot in Telegram.
-
Click Start.
-
The bot will instantly reply with your account information.
-
Look for the line that says Id: 123456789 . That number is your Chat ID. Copy it into the InpChatID input in the EA.
Option B: For a Group or Channel
-
Create a new Telegram Group or Channel (or use an existing one).
-
Add your newly created Bot to this group/channel and promote it to Administrator (so it has permission to send messages).
-
Send a random test message in that group (e.g., "Hello Bot").
-
Open your web browser and visit this URL (replace <YourBotToken> with the token you got from Step 1): https://api.telegram.org/bot<YourBotToken>/getUpdates
-
You will see a block of text (JSON data). Look for the section that says "chat":{"id":-1001234567890 .
-
Copy that entire number including the negative sign ( - ). This is your Group/Channel Chat ID. Paste it into the InpChatID input in the EA.
Security Warning: Never share your Bot Token publicly. Anyone with your token can control your bot.
Setting Up Discord Notifications
Sending reports to Discord is much simpler and only requires a single Webhook URL.
Step 1: Create a Webhook URL
-
Open Discord and navigate to the Server and specific Text Channel where you want to receive your trading reports. (Note: You must have "Manage Webhooks" or Administrator permissions for that server).
-
Hover over the text channel's name on the left sidebar and click the Edit Channel (gear icon) button.
-
On the left-hand menu, click on Integrations.
-
Click on Webhooks, then click the New Webhook button.
-
Discord will create a default webhook (usually named "Captain Hook"). Click on it to expand the settings.
-
Customize it: You can change its name (e.g., "CcF EA Reporter") and upload an avatar/logo for it.
-
Click the Copy Webhook URL button.
-
Click Save Changes at the bottom.
Step 2: Insert into the EA
-
Paste the copied URL directly into the InpDiscordWebhook input in the EA settings.
-
Ensure you have selected PLATFORM_DISCORD in the EA's General Settings.
Security Warning: Treat your Webhook URL like a password. Anyone who has this URL can post messages to your Discord channel.
