Tradovate trading journal

About this integration

Tradovate is the most-connected broker among TFQ's prop-firm-candidate users. Topstep, Apex, and other futures-prop firms all use Tradovate as the execution venue. Fills come through cleanly on a sync, with the contract, tick value and per-side commission intact.

Supported instruments

Access scope

TFQ calls three Tradovate endpoints: `/fill/list` for your fills, then `contract/item` and `product/item` to resolve each fill's contract name, tick value and multiplier. It never reads your positions, your open orders, or your account balance. Tradovate publishes no read-only OAuth scope at all, so the authorize request asks for `trading` and the credential we store is allowed to submit orders. TFQ never sends an order instruction; that is a property of our code rather than of the grant Tradovate issued.

What we read is limited by our code, not by Tradovate. TradeFlow Quantum has no order-placement code path and we do not intend to add one — but because the granted token carries trade permission, treat a compromise of TFQ as reaching this brokerage connection. If that is not an acceptable risk, use the CSV import instead of connecting.

Setup

1. 1System → Brokers → Connect Tradovate
2. 2Tradovate sign-in
3. 3Approve the scope — Tradovate offers only `trading`, so that is what you are granting
4. 4Click Sync to pull your fills — TFQ has no realtime feed, so new fills arrive when you sync

How to export your trades from Tradovate

Tradovate writes its trade history at Performance → Trade History → Export CSV. In TradeFlow Quantum that file imports with the Tradovate (futures CSV) preset.

1. 1In the Tradovate web app go to Performance → Trade History → Export CSV.
2. 2In TradeFlow Quantum open System → Brokers → Upload CSV.
3. 3Choose "Tradovate (futures CSV)" from the preset dropdown, then upload the file.

Columns we read from the Tradovate export

Ticker

ContractSymbol

Direction

B/SAction

Entry price

Price

Size

QtyQuantity

Realized P&L

P&LRealized P&L

Trade date

TimestampDate

Header matching is case-insensitive and ignores punctuation and spacing, so a renamed-but-recognisable header still resolves. A file needs a ticker, an entry price, a size and a date to import at all; direction and P&L are filled in when present.

• •Contract is matched before Symbol. Contract carries the dated contract name, which is what keeps two different expiries of the same product from pairing against each other.

How the Tradovate connection syncs

Authorization

OAuth 2.0 authorization-code flow via trader.tradovate.com/oauth2/authorize, exchanged at POST {host}/auth/oauthtoken.

API host

live.tradovateapi.com/v1 for live accounts, demo.tradovateapi.com/v1 for demo accounts.

Data endpoints

GET /fill/list for the fills, then GET /contract/item and GET /product/item to resolve what each fill traded.

Contract multipliers

valuePerPoint is read per product and cached for the duration of a sync — ES is 50, NQ is 20, CL is 1000. This is how the API path gets futures P&L right where the CSV cannot.

Symbol stored

The contract name, for example ESM4, rather than the product name — so positions in different contract months never cross-pair.

Access token lifetime

About 24 hours. The token response may arrive in either the standard access_token/expires_in shape or the legacy accessToken/expirationTime one; both are handled.

Side mapping

Buy and BuyToCover map to BUY; Sell and SellShort map to SELL.

Tradovate import caveats

• —Futures contracts carry multipliers — ES is $50 a point, NQ is $20 — that the Tradovate CSV often does not include. Review imported P&L before trusting the totals.
• —The partner OAuth flow issues no refresh token. When the access token expires the connection status flips to error and you reconnect from the Brokers page.

Why use TradeFlow Quantum instead of Tradovate's built-in tools?

• ✓Cross-broker view. If you trade Tradovate plus any other broker, TFQ unifies the equity curve, P&L attribution, and mistake-checker across all of them.
• ✓Mistake-checker on YOUR data — surfaces patterns in your Tradovate history (time-of-day, setup type, emotional state) the broker won’t show you.
• ✓Long-term data ownership. Tradovate’s built-in analytics typically limit history to 90 days or 1 year. TFQ keeps every trade for as long as your account exists, exportable any time — closed trades as CSV, everything including open positions as a JSON backup.