Files
docs/features/timeframe-analysis.mdx
Peter Wood c6eb26037b feat: Add CI/CD setup guide with Gitea Actions for trading analysis application
feat: Implement multi-user support with separate brokerage accounts and user authentication

feat: Configure SSO authentication setup using Google OAuth 2.0 for secure access

refactor: Update index page to reflect new Trading Analysis Dashboard features and descriptions

docs: Enhance quickstart guide for deploying Trading Analysis Dashboard with detailed steps

chore: Add runner configuration for Gitea Actions with logging and container settings
2025-11-14 12:43:09 -05:00

93 lines
2.4 KiB
Plaintext

---
title: 'Timeframe Analysis'
description: 'Analyze trading performance across custom time periods'
---
## Overview
The Timeframe Analysis feature allows you to analyze trading performance across different time periods with comprehensive P/L summaries including both trading profits/losses and dividend income.
## Time Period Selection
<CardGroup cols={2}>
<Card title="All Time" icon="infinity">
Analyzes all available trading data
</Card>
<Card title="Current Month" icon="calendar-day">
Current calendar month performance
</Card>
<Card title="Year to Date" icon="calendar-check">
Performance from January 1st to today
</Card>
<Card title="Past Year" icon="calendar-days">
Rolling 365-day performance
</Card>
<Card title="Custom Period" icon="calendar-range">
Select your own date range
</Card>
</CardGroup>
## Key Metrics
- **Period**: Exact date range for selected timeframe
- **Total P/L**: Combined trading profit/loss and dividends
- **Trading P/L**: Profit/loss from completed trades only
- **Dividends**: Total dividend income received
- **Closed Trades**: Number of completed buy/sell transactions
- **Win Rate**: Percentage of profitable trades
## Summary Breakdowns
### Weekly Summary
Groups data by calendar week showing:
- Trading P/L per week
- Dividends per week
- Total P/L per week
- Number of trades per week
### Monthly Summary
Groups data by calendar month showing:
- Trading P/L per month
- Dividends per month
- Total P/L per month
- Number of trades per month
## Open Positions
Displays current open positions (stocks bought but not yet sold):
- Symbol and number of shares
- Notes that open positions are excluded from P/L calculations
## Usage
<Steps>
<Step title="Navigate to Summary">
Go to the Summary page and click "By Timeframe"
</Step>
<Step title="Select Period">
Choose from dropdown - date fields auto-populate
</Step>
<Step title="Custom Dates (Optional)">
Manually adjust start/end dates for fine-tuning
</Step>
<Step title="Apply">
Click "Apply Dates" for custom date ranges
</Step>
</Steps>
## Next Steps
<CardGroup cols={2}>
<Card title="Trading Analysis" icon="chart-line" href="/features/trading-analysis">
View monthly trading performance
</Card>
<Card title="API Reference" icon="code" href="/api-reference/timeframe">
Use the Timeframe API
</Card>
</CardGroup>