Importing trades
Trading Vault can bring trading activity into your journal from a connected broker, a broker report, or a custom CSV file. Each source uses a Trade Import Profile to identify where its trades belong and keep its settings and import history together.
Imports are execution-first. A broker fill normally becomes an execution on a trade. Trading Vault uses the account, symbol, direction, date, quantity, and broker identifiers to match it to an existing trade or execution, attach it to a planned trade where appropriate, or create a new trade. This also helps preserve broker costs and comments and recognize fills that were imported before.
Choose your import source
Open the instructions for your broker, platform, or CSV row format. You can also browse all import options.
How an import works
- Create a Trade Import Profile for the source and select the destination trade account.
- Connect the supported broker account or upload the file described in its integration instructions. On an active profile, use Upload trades to drag in a file or browse your device. Files must match the selected source and are limited to 4 MB.
- Review a preview when the import offers one. It shows proposed executions, matches, costs, prices, and rows needing attention. Check it before confirming. Some connected sync actions can apply eligible activity directly; follow the controls shown on that profile.
- Open the profile's import history to see what was added, updated, skipped, or left for review. The Trade Import Profiles guide explains how to inspect and repair older imports.
For example, an import may create trades from a broker report, attach a broker opening fill to a planned trade, or keep scale-ins and partial closes together when the broker supplies a stable position ID.
Understand import actions
Each execution row receives an import action in the preview or history:
| Action | Meaning |
|---|---|
| Added | A new trade or execution will be created. |
| Updated | An existing trade or execution will be updated. |
| Matched | The row matched an existing trade or planned trade. |
| Skipped | The row was recognized but no change is needed. |
| Unmatched | Trading Vault could not confidently match the row. |
| Invalid | The row cannot be imported until the issue is fixed. |
After import, a row can also show whether its linked trade or execution still exists, was replaced, or was removed. Review these details in import history.
How broker identifiers help matching
Broker identifiers help Trading Vault match later imports to the right trade and avoid duplicate executions.
| Identifier | What it means |
|---|---|
| Broker position ID | The broker's identifier for the overall position or trade. This is the most useful identifier for grouping entries, scale-ins, and exits. |
| Broker order ID | The broker's identifier for the order that created one or more fills. |
| Broker fill ID | The broker's identifier for a specific fill or execution row. This is usually the most precise identifier for duplicate detection. |
These values are usually read from the source. A stable position ID is especially useful for scale-ins, scale-outs, and partial closes. If older data is missing an identifier, you can correct a known position ID on a trade or execution to help future imports match it.
Imported rows can also carry an external symbol, broker comment, source row, execution action, costs, balance, initial stop or target, and maximum adverse or favourable price. These details help explain how an imported execution was created.
Automatic sync
Supported connections can import new activity without another file upload. Availability depends on the source, account, and membership. Choose a source-specific setup guide for connection instructions, and see Trade Import Profiles to manage the profile's Automatic sync setting.
MAP/MFP after importing
After a broker import completes, Trading Vault can calculate missing MAP/MFP values for close executions in the background on Pro accounts. Recent trades are processed first. User-entered MAP/MFP values are not overwritten.
MAP/MFP can still be entered manually on executions on any plan.
Notebook
Trading Vault's Notebook feature allows you to keep track of your thoughts and ideas, jot down notes and observations, and record your progress as a trader. Customize your notes, group them into subnotes, and rearrange them as needed.
Trade Import Profiles
Create and manage Trade Import Profiles in Trading Vault, including settings, automatic sync, archiving, import history, and row repair.