Coinbase trading journal

About this integration

Coinbase is the broker we use for crypto trade tracking. The Advanced Trade API gives us complete trade history including funding rates, conversion fees, and the spot vs Advanced product split. Note: Coinbase Pro (legacy) is sunset; only Coinbase Advanced is supported.

Supported instruments

Access scope

Trade history, positions and account balances are what this product pulls, and the grant carries no deposit or withdrawal permission whatsoever. It does carry trade: the authorize request asks for `openid wallet:user:read trade`, because the Advanced Trade fills endpoint our sync depends on sits behind that permission. No part of TFQ submits an order — but Coinbase's grant is not the thing stopping it.

What we read is limited by our code, not by Coinbase. 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 Coinbase
2. 2Coinbase sign-in
3. 3Approve the scope — read the list; it includes trade, and excludes deposits and withdrawals
4. 4Trade history syncs

How to export your trades from Coinbase

Coinbase writes its trade history at Reports → Transaction History → Generate CSV. In TradeFlow Quantum that file imports with the Coinbase (CSV export) preset.

1. 1On coinbase.com go to Reports → Transaction History → Generate CSV.
2. 2In TradeFlow Quantum open System → Brokers → Upload CSV.
3. 3Choose "Coinbase (CSV export)" from the preset dropdown, then upload the file.

Columns we read from the Coinbase export

Ticker

AssetProduct

Direction

SideTransaction Type

Entry price

Spot Price at TransactionPriceAverage Filled Price

Size

Quantity TransactedSize

Trade date

Timestamp

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.

• •Coinbase's own report writes the bare asset — Asset reads BTC with no -USD suffix — and it imports as-is, so a watchlist filter has to say BTC too. The API sync stores the full product id, BTC-USD, instead.
• •Three entry-price headers resolve, tried in this order: Spot Price at Transaction, then Price, then Average Filled Price. Whichever one your file carries is the one the importer reads.

How the Coinbase connection syncs

Authorization

Coinbase CDP OAuth 2.0 via login.coinbase.com/oauth2 — not the retired Coinbase Pro OAuth.

Data endpoint

GET api.coinbase.com/api/v3/brokerage/orders/historical/fills. Each row is one matched trade leg, not an order summary.

Pagination

A string cursor, followed until it comes back empty or absent.

Fee handling

Commission is subtracted per leg: P&L is (exit − entry) × quantity − entry commission − exit commission. Coinbase taker fees run as high as 0.6%, so this is not a rounding detail.

Access token lifetime

About 2 hours. Refresh tokens are long-lived.

First sync window

The last 90 days.

Coinbase import caveats

• —Long-only for now on the API path. A SELL fill with no open BUY in front of it is discarded rather than opened as a short.

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

• ✓Cross-broker view. If you trade Coinbase 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 Coinbase history (time-of-day, setup type, emotional state) the broker won’t show you.
• ✓Long-term data ownership. Coinbase’s built-in analytics typically limit history to 90 days or 1 year. TFQ keeps every trade forever, exportable to CSV any time.