Tastytrade trading journal

About this integration

Tastytrade is an options-first broker, but the Tastytrade connection in TFQ is not yet options-aware: the sync keeps equity trades and drops everything else. If you trade Tastytrade options or futures — including the multi-leg structures the broker is known for — those fills will not appear in your journal from this connection. The tastyworks CSV preset reads the export's own Realized P/L column, so an options file that carries it imports correctly — but without that column P&L is derived by pairing fills and the contract multiplier is read off the symbol: an option row whose symbol cell carries the full contract code (“AAPL 240315C00180000”, padded or not) imports at ×100, while one carrying only the underlying ticker lands at 1/100th. Tastytrade is also reachable via SnapTrade, which records the ×100. Futures carry multiplier 1 on every route here, so log those by hand. What the connection does give you that most of the ten do not: the `read` grant is enforced at Tastytrade, so the token cannot place an order even if our code asked it to.

Supported instruments

Access scope (read-only)

TFQ calls two Tastytrade endpoints: `/customers/me/accounts`, and each account's `/transactions` filtered to trade types. It never reads your positions or your open orders — and it keeps only transactions whose instrument-type is Equity, so options and futures fills are discarded before they reach your journal. The grant we request is `read`, so Tastytrade will not accept a trade or transfer instruction on this token at all.

We cannot place orders, transfer funds, or change account settings on this connection: the grant itself excludes them, so Tastytrade refuses those calls regardless of what our code asks for.

Setup

1. 1System → Brokers → Connect Tastytrade
2. 2Tastytrade sign-in (TFQ never sees your credentials)
3. 3Approve read-only scope
4. 4Click Sync — equity fills come through; options and futures fills are skipped

How to export your trades from Tastytrade

Tastytrade writes its trade history at History → Transactions → Export. In TradeFlow Quantum that file imports with the Tastyworks / Tastytrade preset.

1. 1In the tastyworks/tastytrade desktop platform go to History → Transactions → Export.
2. 2In TradeFlow Quantum open System → Brokers → Upload CSV.
3. 3Choose "Tastyworks / Tastytrade" from the preset dropdown, then upload the file.

Columns we read from the Tastytrade export

Ticker

SymbolUnderlying Symbol

Direction

Action

Entry price

PriceAverage Price

Size

QuantityQty

Realized P&L

Realized P/LP&L

Trade date

DateExecuted At

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.

• •Underlying Symbol is accepted as a fallback for Symbol, which is what options rows carry.
• •Action holds the verbose tastytrade strings — Buy to Open, Sell to Close, Sell to Open, Buy to Close. The importer reads the opening and closing intent straight out of those rather than parsing a signed quantity.

How the Tastytrade connection syncs

Authorization

OAuth 2.0 with refresh tokens via api.tastyworks.com/oauth.

API host

api.tastyworks.com in production, api.cert.tastyworks.com in the sandbox.

Response shape

Every tastytrade endpoint wraps its payload as {data, context, pagination}; list endpoints nest again under data.items. The adapter unwraps once at the boundary.

Account lookup

GET /customers/me/accounts, then /accounts/{account_number}/transactions.

Access token lifetime

15 minutes.

Refresh token lifetime

24 hours, rolling.

First sync window

The last 90 days.

Tastytrade import caveats

• —The live sync uses the first account returned by /customers/me/accounts. Multi-account selection is a future Settings enhancement.

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

• ✓Cross-broker view. If you trade Tastytrade 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 Tastytrade history (time-of-day, setup type, emotional state) the broker won’t show you.
• ✓Long-term data ownership. Tastytrade’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.