Exporting Data
Download your trading data for external analysis, tax reporting, or record keeping.
What Can Be Exported
| Data Type | Format | Contents |
|---|---|---|
| Trade History | CSV | All closed trades |
| Positions | CSV | Current open positions |
| Orders | CSV | Order history |
| Performance | CSV | Metrics summary |
Exporting Trade History
Step-by-Step
- Navigate to Positions → Closed
- Apply filters (optional)
- Click Export button
- Select date range
- Click Download CSV
CSV Fields
| Field | Description | Example |
|---|---|---|
id | Trade identifier | trd_abc123 |
symbol | Trading pair | BTC/USDT |
exchange | Exchange name | Binance |
side | Trade direction | long |
entry_time | Open timestamp | 2024-01-15T10:30:00Z |
exit_time | Close timestamp | 2024-01-15T14:45:00Z |
entry_price | Average entry | 50000.00 |
exit_price | Average exit | 52000.00 |
size | Position size | 0.1 |
pnl | Profit/Loss | 200.00 |
pnl_percent | PnL percentage | 4.00 |
fees | Total fees | 10.50 |
close_reason | How closed | take_profit |
bot_id | Bot identifier | bot_xyz789 |
bot_name | Bot name | RSI Strategy |
type | Paper or Live | live |
Example CSV Output
id,symbol,exchange,side,entry_time,exit_time,entry_price,exit_price,size,pnl,pnl_percent,fees,close_reason,bot_name,type
trd_001,BTC/USDT,Binance,long,2024-01-15T10:30:00Z,2024-01-15T14:45:00Z,50000.00,52000.00,0.1,200.00,4.00,10.50,take_profit,RSI Bot,live
trd_002,ETH/USDT,Binance,short,2024-01-15T12:00:00Z,2024-01-15T16:30:00Z,3000.00,2900.00,1.0,100.00,3.33,6.00,manual,MACD Bot,live
Filtering Before Export
Available Filters
| Filter | Options |
|---|---|
| Date Range | Custom start/end dates |
| Exchange | All or specific |
| Bot | All or specific |
| Symbol | Search for pairs |
| Side | Long, Short, Both |
| Result | Win, Loss, Both |
| Type | Paper, Live, Both |
Filter Tips
- Export only what you need
- Use date ranges for tax years
- Separate paper and live for clarity
Using Exported Data
In Excel/Google Sheets
- Open CSV file in spreadsheet
- Use pivot tables for analysis
- Create custom charts
- Calculate additional metrics
Example Formulas:
// Total PnL
=SUM(J:J)
// Win Rate
=COUNTIF(J:J,">0")/COUNTA(J:J)
// Average Win
=AVERAGEIF(J:J,">0")
// Average Loss
=AVERAGEIF(J:J,"<0")
// Profit Factor
=SUMIF(J:J,">0")/ABS(SUMIF(J:J,"<0"))
For Tax Reporting
Export includes all needed information:
| Tax Need | CSV Field |
|---|---|
| Date acquired | entry_time |
| Date sold | exit_time |
| Cost basis | entry_price × size |
| Proceeds | exit_price × size |
| Gain/Loss | pnl |
| Fees | fees |
Note: Consult a tax professional for your jurisdiction's requirements.
For Custom Analysis
Import into analysis tools:
| Tool | Use Case |
|---|---|
| Python/Pandas | Advanced analysis |
| R | Statistical analysis |
| Tableau | Visualization |
| Power BI | Business intelligence |
Python Example:
import pandas as pd
# Load data
df = pd.read_csv('trades_export.csv')
# Parse dates
df['entry_time'] = pd.to_datetime(df['entry_time'])
df['exit_time'] = pd.to_datetime(df['exit_time'])
# Calculate metrics
total_pnl = df['pnl'].sum()
win_rate = (df['pnl'] > 0).mean()
avg_duration = (df['exit_time'] - df['entry_time']).mean()
print(f"Total PnL: ${total_pnl:.2f}")
print(f"Win Rate: {win_rate:.1%}")
print(f"Avg Duration: {avg_duration}")
Data Retention & Export Timing
Retention by Tier
| Tier | Data Retained |
|---|---|
| Free | 7 days |
| Pro | 30 days |
| Trader | 90 days |
| Whale | 365 days |
Export Recommendations
| Tier | Export Frequency |
|---|---|
| Free | Daily (before data expires) |
| Pro | Weekly |
| Trader | Monthly |
| Whale | Quarterly |
Important: Export before data expires if you need long-term records.
Automated Exports
Scheduled Exports (Coming Soon)
Future feature will allow:
- Weekly automatic exports
- Email delivery of CSV
- Cloud storage integration
API Export
For developers, data can be accessed via API:
GET /api/trades/export?start=2024-01-01&end=2024-01-31
Authorization: Bearer {token}
Privacy & Security
Data Contents
Exported files contain:
- Trade details
- PnL information
- Timestamps
- Bot names
Does NOT contain:
- API keys
- Passwords
- Personal information
- Exchange credentials
Handling Exported Data
| Practice | Why |
|---|---|
| Store securely | Contains financial data |
| Don't share publicly | Privacy concern |
| Backup regularly | Prevent data loss |
| Delete old exports | Minimize exposure |
Troubleshooting Exports
"Export Failed"
Causes:
- Too much data
- Network timeout
- Server error
Solutions:
- Reduce date range
- Apply more filters
- Try again later
- Contact support
"No Data to Export"
Causes:
- Filters too restrictive
- No trades in period
- Wrong date range
Solutions:
- Expand date range
- Remove filters
- Check correct account
CSV Formatting Issues
Problem: Data appears in one column
Solution:
- Use "Import" function instead of opening directly
- Set delimiter to comma
- Enable text qualifier
Best Practices
Regular Backups
| Schedule | What to Export |
|---|---|
| Weekly | Last week's trades |
| Monthly | Full month |
| Yearly | Full year for taxes |
Naming Convention
trades_EXCHANGE_STARTDATE_ENDDATE.csv
Example:
trades_binance_20240101_20240131.csv
Storage Organization
trading_data/
├── 2024/
│ ├── Q1/
│ │ ├── trades_jan.csv
│ │ ├── trades_feb.csv
│ │ └── trades_mar.csv
│ └── Q2/
│ └── ...
└── backups/
└── ...
Next Steps
- Trade History - Review your trades
- PnL Charts - Visualize data
- FAQ - Common questions