# Trade Journal Guide

The Trade Journal provides comprehensive analysis of your trading history with advanced filtering, statistics, and export capabilities.

## Overview

The Trade Journal page (`/journal`) allows you to:

- View complete trade history across all symbols and order types
- Filter trades by status, side, symbol, and date range
- Analyze trade statistics and performance metrics
- Export trade data to CSV for external analysis
- Track fees, volumes, and win rates

## Accessing the Trade Journal

1. Navigate to the **Trade Journal** page from the main navigation menu
2. The journal displays all trades for the selected trading mode (Paper or Live)

## Trade Statistics

The Trade Journal displays key statistics at the top of the page:

- **Total Trades**: Number of all trades matching current filters
- **Filled Trades**: Number of successfully executed trades
- **Total Volume**: Sum of all trade quantities
- **Total Fees**: Cumulative fees paid across all trades

## Filtering Trades

Use the filter panel to narrow down your trade history:

### Status Filter
- All
- Filled
- Open
- Pending
- Cancelled
- Rejected

### Side Filter
- All
- Buy
- Sell

### Symbol Filter
- Enter symbol name to search (e.g., "BTC/USD")
- Partial matching supported

### Date Range Filter
- **Start Date**: Filter trades from this date onwards
- **End Date**: Filter trades up to this date
- Both fields optional; leave empty to show all dates

### Trading Mode Toggle
- Switch between Paper Trading and Live Trading data

## Trade Table

The trade table displays detailed information for each trade:

- **ID**: Unique order identifier
- **Symbol**: Trading pair (e.g., BTC/USD)
- **Side**: Buy or Sell (color-coded chips)
- **Type**: Order type (Market, Limit, Stop Loss, Trailing Stop, etc.)
- **Quantity**: Order size
- **Price**: Limit price (or "Market" for market orders)
- **Status**: Current order status (color-coded chips)
- **Filled**: Quantity that has been executed
- **Fee**: Trading fee for this order
- **Created At**: Timestamp when order was placed

## Exporting Data

To export trade data:

1. Apply desired filters to narrow down trades
2. Click the **Export CSV** button
3. A CSV file will download with all filtered trades
4. File name includes date: `trade_journal_YYYY-MM-DD.csv`

The CSV includes all columns from the trade table for easy analysis in Excel, Google Sheets, or other tools.

## Use Cases

### Performance Analysis
- Filter by filled trades to analyze executed strategy performance
- Use date range to analyze performance over specific periods
- Compare buy vs sell trade performance

### Fee Tracking
- View total fees to understand trading costs
- Filter by symbol to see fees per trading pair
- Export to calculate tax implications

### Strategy Review
- Filter by order type to analyze strategy effectiveness
- Review cancelled/rejected orders to identify issues
- Track order types used in different market conditions

### Reporting
- Export data for tax reporting
- Create custom reports in spreadsheet software
- Track compliance with trading limits

## Tips

- Use multiple filters together for precise analysis
- Export data regularly for backup and external analysis
- Review rejected/cancelled orders to identify systematic issues
- Compare paper and live trading statistics separately