All help articles

CSV import format and column reference

Updated August 20, 2026

Any platform that can export a trade history can almost certainly be imported. This is the format the generic parser reads.

The file

  • One header row on the first line, then one closed trade per row.
  • Comma or tab separated. Propfy decides which from the header row, so a tab-separated export needs no special handling. Semicolons are not supported, so save as comma-separated.
  • Fields may be quoted, and a doubled "" inside a quoted field is one quote character. Empty cells are fine and do not shift the columns beside them.
  • Plain text, .csv or .txt, maximum 4MB and 10,000 rows. Split a longer history into date ranges and upload them one after another.

Column names

Names match without case, with spaces turned into underscores, in any order, and extra columns are ignored. Spell the name as one of these:

  • Instrument, required: symbol, contract, instrument, ticker, contractname
  • Direction, required: side, direction, type, action
  • Size: size, quantity, qty, contracts
  • Entry price: entryprice, price, avg_price, filledprice
  • Exit price: exitprice, close_price
  • Entry time: entrytime, time, date, timestamp, filledtime, open_time
  • Exit time: exittime, close_time
  • Realized P&L: pnl, profit, gain, realizedpnl, net_pnl
  • Fees: fees, commission, cost

Watch the spaces. "Entry Price" becomes entry_price, which is not on the list, so write entryprice as one word or use price instead.

Direction, and why rows get skipped

Direction is read from the words long, buy, short and sell, and from the single letters B and S. Anything else is unreadable, including an order type such as Market or Limit.

Propfy never guesses a direction. A row it cannot read is skipped, counted, and reported on the result card as rows skipped for an unreadable trade direction.

A row with no readable instrument is dropped too. Only the TradeZella format reports that as its own count; on other formats those rows never reach the totals.

After the import

The result card gives the honest breakdown: imported, already imported, failed, and each skip reason with its count.

If this format does not fit your platform, open a ticket telling us which platform you use.

More guides

Risk Disclosure

Futures and forex trading contains substantial risk and is not for every investor. An investor could potentially lose all or more than the initial investment. Risk capital is money that can be lost without jeopardizing one's financial security or lifestyle. Only risk capital should be used for trading and only those with sufficient risk capital should consider trading. Past performance is not necessarily indicative of future results.

Hypothetical Performance Disclosure

Hypothetical performance results have many inherent limitations, some of which are described below. No representation is being made that any account will or is likely to achieve profits or losses similar to those shown; in fact, there are frequently sharp differences between hypothetical performance results and the actual results subsequently achieved by any particular trading program. One of the limitations of hypothetical performance results is that they are generally prepared with the benefit of hindsight. In addition, hypothetical trading does not involve financial risk, and no hypothetical trading record can completely account for the impact of financial risk of actual trading. For example, the ability to withstand losses or to adhere to a particular trading program in spite of trading losses are material points which can also adversely affect actual trading results. There are numerous other factors related to the markets in general or to the implementation of any specific trading program which cannot be fully accounted for in the preparation of hypothetical performance results and all of which can adversely affect trading results.

Trademarks and affiliation

NinjaTrader® is a registered trademark of NinjaTrader Group, LLC. No NinjaTrader company has any affiliation with the owner, developer, or provider of the products or services described herein, or any interest, ownership or otherwise, in any such product or service, or endorses, recommends or approves any such product or service.

Topstep® is a registered trademark of TopstepTechnologies LLC. TopstepX™, FTMO, Tradovate, Kinetick, TradeZella and other third-party names and marks are the property of their respective owners. Propfy is an independent trading journal and is not affiliated with, endorsed by, sponsored by, certified by or authorized by any of them unless explicitly stated in writing. Third-party names are used solely to identify supported connections and technical compatibility, and technical compatibility does not imply a commercial partnership, sponsorship, endorsement or authorization.